可観測性のトラブルシューティング

可観測性を使用する際に、次のイシューに遭遇する可能性があります。

GitLab可観測性インスタンスの問題

コンテナのステータスを確認してください:

docker ps

コンテナのログを表示してください:

docker logs [container_name]

メニューが表示されない

1. グループに可観測性サービスURLが設定されていることを確認してください:

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

2. ルートが正しく登録されていることを確認してください:

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

パフォーマンスの問題

SSH接続イシューが発生している場合、またはパフォーマンスが低い場合:

• インスタンスタイプが最小要件（2 vCPU、8 GB RAM）を満たしていることを確認してください。
• より大きなインスタンスタイプへのサイズ変更を検討してください。
• ディスク領域を確認し、必要に応じて増やしてください。

テレメトリーが表示されない

GitLab可観測性にテレメトリデータが表示されない場合:

1. セキュリティグループでポート4317および4318が開いていることを確認してください。

2. 接続をテストしてください:

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

3. コンテナログにエラーがないか確認してください:

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

4. gRPC (4317) の代わりにHTTPエンドポイント (4318) を使用してみてください。

5. OpenTelemetryセットアップに、より多くのデバッグ情報を追加してください。