Instana ディストリビューションにおける OpenTelemetry コレクターのトラブルシューティング

オンラインで編集

OpenTelemetry Collector の Instana ディストリビューションを使用する際に発生する可能性のある一般的な問題の解決策をご覧ください。

コレクターが接続に失敗しました

オンラインで編集

コレクターが Instana バックエンドに接続できません。

解決策 : ネットワーク構成を確認し、コレクターが Instana バックエンドに到達できることを確認してください。 ファイアウォールルール、プロキシ設定、ポート構成を確認し、正しい Instana キーが使用されていることを確認してください。

Red Hat OpenShift プラットフォームにおいて、 Instana Self-Hosted Custom Editionとのコレクター接続に失敗しました

オンラインで編集

Red Hat OpenShift プラットフォームを Instana Self-Hosted Custom Editionと併用し、接続エラーや OTLP エンドポイントの障害（otlp-collectorポッドのログに記録される）が発生した場合、 Red Hat OpenShift で手動でルートを作成する必要があります。 ルート作成の詳細については、 Red Hat OpenShift の「 Instana バックエンドでのエンドポイントの設定 」を参照してください。 ルートの作成は自動的に行われません。

コレクターが起動に失敗しました

オンラインで編集

コレクターは設定エラーのため起動に失敗しました。

解決策 : コレクターを起動する前に、`--validate` フラグ --config-check を使用して設定ファイルを検証してください。 例: ./otelcol --config config.yaml --config-check

コレクターサービスが起動に失敗しました

オンラインで編集

コレクターサービスはインストール後に起動に失敗します。

解決策 : サービスログにエラーがないか確認し、設定パラメータが config.env 正しいことを確認してください。

Instana のUIにコレクターが表示されない

オンラインで編集

コレクターは実行中ですが、 Instana のUIには表示されていません。

解決策 : Instana UIのエンティティページは、resource entity.type 属性に基づいてコンポーネントを一覧表示します。 コレクターが表示されない場合は、設定ファイルで 属性 entity.type が正しく設定されていることを確認してください。 コレクターが Instana バックエンドに正しく接続されていることを確認し、認証または接続の問題がないか確認してください。

リソース属性の設定例:

telemetry: 
  resource: 
    entity.type: otel-collector

管理者サービスの問題

オンラインで編集
  • スーパーバイザーサービスが実行中であるにもかかわらず、コレクターが繰り返し再起動する。

解決策 : スーパーバイザーのログでエラーを確認し、コレクターの設定が有効であることを確認してください。

  • スーパーバイザーサービスが起動に失敗しました。

解決策 : 内のスーパー config.env バイザー設定が正しいことを確認し、システムログにエラーがないか確認してください。

Linux のログの保存場所

オンラインで編集

  • コレクターログ ：デフォルトでは、 /opt/instana/collector/logs/collector.log

  • 管理者ログ ：デフォルトでは、 /opt/instana/collector/logs/supervisor.log.

コレクターはシステムメトリクスやログファイルにアクセスできません

オンラインで編集

コレクターはシステムメトリクスやログファイルにアクセスできません。

解決策 : コレクタープロセスが適切な権限を持っていることを確認してください。 管理者権限で実行する必要があるか、特定のグループに追加する必要があるかもしれません。

異常なコレクターの挙動

オンラインで編集

コレクターのログに異常なテレメトリデータが記録されている。

解決策 : インストールパスで ./instana_collector_service.sh restart を使用してコレクターサービスを再起動し、潜在的な問題を解消してください。 問題が解決しない場合は、コレクターのログに異常がないか確認してください。

自己ホスト環境における自己署名証明書の課題

オンラインで編集

コレクターは、自己署名証明書を使用する自己ホスト環境において証明書検証に失敗したため、 Instana バックエンドに接続できません。

解決策 : Instana サーバーから証明書をエクスポートし、システムの信頼された証明書ストアに追加します:

  1. Instana サーバーから PEM ファイルをエクスポートします。
  2. 必要に応じてファイルをファイル .crt に変換してください。
  3. 証明書をシステムの信頼された証明書ストアに追加してください。 お使いのオペレーティングシステムに応じて、ファイルを .crt 以下の場所にコピーしてください：
    • RHEL CentOS, または Fedora : ファイルを .crt の /usr/share/pki/ca-trust-source/anchors/ 場所にコピーします。
    • Debian または Ubuntu : ファイルを .crt 場所にコピーしてください /usr/local/share/ca-certificates/ 。
  4. コレクターサービスを再起動してください。

Spanステータスに関する問題: HTTP4xx エラーとしてマークされたステータスコード

オンラインで編集

問題 : ` HTTP ` 4xx のステータスコード（例: 400 Bad Request`404 Not Found`）を持つスパンはエラーとしてマークされますが、これらはアプリケーションで想定される動作です。

解決策 : OpenTelemetry 仕様により、インストルメンテーションはコンテキストに基づいてスパンのステータスをより正確に設定できるようになります。 特定の 4xx 応答が実際のエラーではない場合、使用例に応じてそれらを除外したい場合は、コレクター設定内のプロセッサー transform ブロックに以下の設定を含めるように構成し、パイプラインに追加してください。

  transform/span_parse:
    error_mode: ignore
    trace_statements:
     - context: span
       statements:
         - set(status.code, STATUS_CODE_OK) where attributes["http.status_code"] >= 400 and attributes["http.status_code"] < 500

この設定により、特定の HTTP ステータスコードに対してスパンステータ OK スを に設定できます。