• Status: Experiment

Observability를 사용하는 중에 다음과 같은 문제가 발생할 수 있습니다.

GitLab Observability 인스턴스 문제#

컨테이너 상태를 확인합니다:

docker ps

컨테이너 로그를 확인합니다:

docker logs [container_name]

메뉴가 표시되지 않음#

• 그룹에 대해 Observability 서비스 URL이 구성되어 있는지 확인합니다:

  group = Group.find_by_path('your-group-name')
  group.observability_group_o11y_setting&.o11y_service_url
  

• 라우트가 올바르게 등록되어 있는지 확인합니다:

  Rails.application.routes.routes.select { |r| r.path.spec.to_s.include?('observability') }.map(&:path)
  

성능 문제#

SSH 연결 문제나 성능 저하가 발생하는 경우:

• 인스턴스 유형이 최소 요구 사항(vCPU 2개, RAM 8 GB)을 충족하는지 확인합니다.

• 더 큰 인스턴스 유형으로 크기 조정을 고려합니다.

• 디스크 공간을 확인하고 필요한 경우 늘립니다.

텔레메트리가 표시되지 않음#

텔레메트리 데이터가 GitLab Observability에 나타나지 않는 경우:

• 보안 그룹에서 포트 4317 및 4318이 열려 있는지 확인합니다.

• 다음 명령어로 연결을 테스트합니다:

  nc -zv [your-o11y-instance-ip] 4317
  nc -zv [your-o11y-instance-ip] 4318
  

• 컨테이너 로그에서 오류를 확인합니다:

  docker logs otel-collector-standard
  docker logs o11y-otel-collector
  docker logs o11y
  

• gRPC(4317) 대신 HTTP 엔드포인트(4318)를 사용해 봅니다.

• OpenTelemetry 설정에 디버깅 정보를 추가합니다.