뉴렐릭 Kubernetes OpenTelemetry Collector 견고하고 안정적으로 설계되었지만 여전히 문제가 발생할 수 있습니다. 이 문제 해결, 해결 문서는 귀하가 직면할 수 있는 일반적인 문제에 대한 문제 해결, 해결 단계를 제공합니다.
일반 Collector 파드 문제
문제가 발생한 수집기 패드의 로그를 확인해 보세요. 다음 명령을 실행하세요:
$kubectl logs <otel-pod-name> -n newrelic
문제 문제 해결에 대한 자세한 DEBUG
수준 로깅을 활성화하려면 nr-k8s-otel-collector
Helm 차트에서 verboseLog
매개변수를 true
로 설정하세요.
메트릭 수집 실패
문제: 지표가 수집되지 않거나 뉴렐릭으로 전송되지 않습니다.
문제 해결, 해결:
스크랩 설정 확인: 수집기 설정(
extraConfig
또는default
) 내의prometheus
수신기 설정이 올바른지 확인하세요.bash$kubectl describe configmap prometheus-config -n monitoring파드 주석 확인: Prometheus 서비스 검색을 사용하는 경우 애플리케이션 파드에 올바른
prometheus.io/scrape=true
주석이 있는지 확인하세요.bash$kubectl get pods --namespace=[your-namespace] --show-labels | grep 'prometheus.io/scrape=true'네트워크 연결 테스트: 수집기 패드가 지표 끝점에 도달할 수 있는지 확인합니다.
bash$kubectl exec [prometheus-pod-name] -- curl <http://service:port>
설정 재정의가 적용되지 않음
문제: 사용자 정의 설정이 제대로 적용되지 않습니다.
문제 해결, 해결:
values.yaml
을 검토하세요.extraConfig
섹션에 오타나 잘못된 들여쓰기가 있는지values.yaml
파일을 다시 확인하세요.bash$cat helm-charts/charts/nr-k8s-otel-collector/values.yaml | grep extraConfig적용된
ConfigMaps
검증: Helm 차트는values.yaml
에서ConfigMaps
생성합니다. 결과ConfigMap
검사하여 사용자 정의 설정이 있는지 확인하세요.bash$kubectl describe configmap [collector-configmap-name] -n monitoring
Collector 가 시작되지 않음
문제: OpenTelemetry 수집기 파드가 초기화되지 않거나 반복적으로 충돌합니다.
문제 해결, 해결:
패드 로그 검사: 가장 일반적인 첫 번째 단계입니다. 구성이 잘못되었거나 의존성/종속성이 누락되었음을 나타내는 특정 오류 메시지를 찾아보세요.
bash$kubectl logs [collector-pod-name] --namespace=monitoring환경 변수 확인: 필요한 환경 변수가 올바르게 삽입되었는지 확인하세요.
bash$kubectl exec [collector-pod-name] -- env | grep -i [variable-name]
네트워크 장애
문제: 수집기가 뉴렐릭과 통신하거나 데이터를 전송할 수 없습니다.
문제 해결, 해결:
DNS 확인 확인: 수집기 패드가 서비스 이름 또는 뉴웰릭 엔드포인트를 확인할 수 있는지 확인하세요.
bash$kubectl exec [collector-pod-name] -- nslookup service-name연결 테스트 실행: 내부 서비스 또는 외부 뉴렐릭 엔드포인트에 대한 연결을 테스트합니다.
bash$kubectl exec [collector-pod-name] -- curl -I <http://service-name:port>네트워크 정책 검토: 클러스터에 엄격한 네트워크 정책이 있는 경우 OpenTelemetry Collector 파드의 내부 서비스 및 외부 뉴렐릭 엔드포인트에 대한 트래픽을 허용하는지 확인하세요.
bash$kubectl describe networkpolicy -n [namespace]
지원하다
용 OpenTelemetry 옵저버빌리티에 문제가 있는 경우 Kubernetes 다음을 참조하세요.
- 비슷한 문제가 있는 경우 GitHub의 이슈 섹션을 참조 하거나 새로운 이슈를 개설하는 것을 고려해 보세요.