Skuber+ Cost Optimize - 문제 해결 가이드

자주 발생하는 문제와 해결 방법을 안내합니다.

Agent 설치 문제

Agent Pod가 시작되지 않음

증상: kubectl get pods -n skuber-system에서 Pod가 Pending 또는 Error 상태

진단:

# Pod 상태 확인
kubectl get pods -n skuber-system

# Pod 이벤트 확인
kubectl describe pod -n skuber-system -l app=skuber-agent

해결 방법:

이미지 풀 실패 시:

# 이미지 풀 수동 확인
kubectl describe pod <pod-name> -n skuber-system | grep -A 10 Events

Agent 설치 스크립트 실행 실패

증상: curl 명령어 실행 시 에러 발생

해결 방법:

1. 네트워크 확인

   # Skuber+ API 서버 접근 확인
   curl -v https://api.skuberplus.com/health

2. kubectl 연결 확인

   # 클러스터 연결 확인
   kubectl cluster-info

3. 네임스페이스 확인

   # 네임스페이스 생성 (필요시)
   kubectl create namespace skuber-system

연결 문제

클러스터 상태가 DISCONNECTED

증상: Console에서 클러스터 상태가 DISCONNECTED로 표시됨

진단:

# Agent Pod 상태 확인
kubectl get pods -n skuber-system

# Agent 로그 확인
kubectl logs -n skuber-system -l app=skuber-agent --tail=100
kubectl logs -n skuber-system -l app=skuber-agent-controller --tail=100

해결 방법:

연결이 간헐적으로 끊김

증상: 연결 상태가 불안정하게 변동됨

진단:

# Agent 로그에서 에러 확인
kubectl logs -n skuber-system -l app=skuber-agent-controller --tail=500 | grep -i error

해결 방법:

1. 네트워크 안정성 확인
2. 방화벽 설정 확인
3. Agent 리소스 제한 확인

비용 계산 문제

비용이 표시되지 않음

증상: 클러스터 연결됨, 하지만 비용이 0 또는 N/A로 표시

진단:

# 노드 정보 확인
kubectl get nodes -o wide

# 메트릭 서버 확인
kubectl top nodes

해결 방법:

Metrics Server 설치 확인:

kubectl get apiservices | grep metrics
# v1beta1.metrics.k8s.io 가 있어야 함

Zero Scaling 롤백이 안됨

증상: Zero Scaling 비활성화 후 원본 상태로 복원되지 않음

진단:

# BackupWorkload 확인
kubectl get backupworkloads -A

# Agent 로그 확인
kubectl logs -n skuber-system -l app=skuber-agent --tail=100 | grep -i backup

해결 방법:

1. 수동으로 원본 Deployment 설정 복원
2. 기술 지원 문의 (support@skuberplus.com)

Smart Scaling 문제

VPA 권장값이 표시되지 않음

증상: Smart Scaling 활성화했지만 권장값 없음

원인:

• 데이터 수집 기간 부족
• VPA가 설치되지 않음

해결 방법:

# VPA 설치 확인
kubectl get pods -n kube-system | grep vpa

# VPA 권장값 직접 확인
kubectl describe vpa <workload-name> -n <namespace>

로그 확인 방법

Agent 로그 수집

# Agent 로그
kubectl logs -n skuber-system -l app=skuber-agent --tail=1000 > agent.log

# Agent Controller 로그
kubectl logs -n skuber-system -l app=skuber-agent-controller --tail=1000 > controller.log

로그 레벨 변경

# 환경 변수로 로그 레벨 설정
kubectl set env deployment/skuber-agent -n skuber-system LOG_LEVEL=debug

Agent 재설치

문제가 지속되면 Agent를 재설치합니다.

1. 기존 Agent 제거

kubectl delete namespace skuber-system

2. Console에서 클러스터 삭제

1. 클러스터 상세 → "클러스터 삭제" 클릭

3. 클러스터 재등록

1. "클러스터 등록" 버튼 클릭
2. 설치 스크립트 재실행

기술 지원 요청

위 해결 방법으로 해결되지 않는 경우 기술 지원을 요청해 주세요.

지원 요청 시 필요한 정보

1. 클러스터 정보

   kubectl version
   kubectl get nodes -o wide

2. Agent 상태

   kubectl get pods -n skuber-system -o wide
   kubectl describe pods -n skuber-system

3. Agent 로그

   kubectl logs -n skuber-system -l app=skuber-agent --tail=1000
   kubectl logs -n skuber-system -l app=skuber-agent-controller --tail=1000

4. 에러 메시지 (Console 또는 로그에서 확인)

연락처

• 이메일: support@skuberplus.com
• 응답 시간: 영업일 기준 24시간 이내

관련 문서

• 자주 묻는 질문
• 클러스터 등록
• Zero Scaling