Software Catalog のトラブルシューティング

Datadog Software Catalog で予期しない動作が発生した場合は、このガイドが問題の解決に役立つ可能性があります。引き続き問題が解決しない場合やお困りの場合は、Datadog サポートまでお問い合わせください。

サービス

APM インスツルメンテーションサービスが表示されない

APM のインスツルメンテーションが行われていることが分かっているサービスが Software Catalog のリストに表示されない場合、選択した env (または任意のプライマリタグ値)、あるいは追加のプライマリタグに対して、過去 1 時間にパフォーマンスデータを送信していない可能性があります。確認するには、Performance タブでパフォーマンスメトリクスが表示されるはずの列にカーソルを合わせ、そのサービスがどの環境でアクティブかを示す情報を確認します。

過去 1 時間にパフォーマンスデータが報告されていないことを示すホバーメッセージ

セットアップガイダンスのセクションにリストされていない SLO

Software Catalog のセットアップガイダンスセクションのカウントは、service タグを持つ SLO の数を反映しています。SLO がリストに含まれていない場合は、SLO に service タグの値が指定されているかどうか、また APM や USM などの他の製品でのサービス名と一致しているかどうかを確認してください。

サービスに追加テレメトリーが利用可能だが、リストに載っていない

Software Catalog は、特定のサービスに関する情報を収集するために、すべてのテレメトリ種別 (インフラストラクチャーメトリクス、ログ、Cloud Network Monitoring) で DD_SERVICE タグに依存しています。Software Catalog に期待するテレメトリ種別が表示されない場合は、Unified Service Tagging の手順に従って DD_SERVICE タグが正しく設定されていることを確認してください。

RUM サービスのメタデータを追加できない

RUM サービスのメタデータを追加することはサポートされていません。

複数のサービスが同じメタデータを共有

同じメタデータを共有するサービスが多数ある場合、それぞれのサービスに対して別々の service.datadog.yaml ファイルは必要ありません。各サービスを --- セパレータで区切ることで、1 つの service.datadog.yaml ファイルに複数のサービスを定義することができます。関連する dd-service エンティティの共有メタデータをコピーアンドペーストします。

エンドポイント

エンドポイントの欠落

Endpoints list は APM トレーシングに基づいているため、サービスのインスツルメンテーションが行われていることを確認してください。

定義が一致するサービスが多すぎる

既定では、Endpoints list は、定義されたパスに合致するすべてのインスタンスに定義を一致させます。API 定義に service パラメータを追加することで、特定のサービスにスコープを絞り込むことができます。

OpenAPI ファイルのテレメトリーデータがない

Endpoints list は APM トレーシングに由来するため、当該エンドポイントでトレースが利用可能な場合にのみトラフィック情報が表示されます。OpenAPI ファイルをアップロードした後は、Datadog がそのエンドポイントのスパンを取り込むと、デプロイデータが表示されるようになります。