概要
カタログは、Datadog APM (Application Performance Monitoring)、USM (Universal Service Monitoring)、および RUM (Real User Monitoring) からエンティティを自動的に検出します。また、インフラストラクチャーのメトリクスやログからエンティティをインポートするように構成することもできます。
APM、USM、RUM による自動検出
Datadog カタログには、APM、Universal Service Monitoring の eBPF ベースのオートディスカバリーや RUM アプリケーションを通じて検出されたエントリが事前に登録されています。
自動的に検出されたすべてのエンティティは、カタログ内のコンポーネントセレクターに表示されます。
APM および USM は、次のエンティティタイプを自動的に検出します: service、datastore、queue、external providers、inferred services、および endpoints。Datadog SDK は、インスツルメンテーションされたサービスの依存関係を特定し、その依存関係が直接インスツルメンテーションされていない場合でも、それらをデータベース、キュー、またはサードパーティ API として分類します。カスタムインスツルメンテーションは、エンティティの検出方法や service tag の割り当て方法に影響を与える可能性があります。詳細については、「APM 推論サービス」を参照してください。
RUM は frontend apps エンティティの検出を担当します。
エンドポイントの検出に関する詳細については、「APM からのエンドポイントの発見」を参照してください。
注: エンティティのパフォーマンスメトリクスは、その主要なオペレーションに関連付けられています。サービスが USM によってのみ検出された場合、パフォーマンスビューには USM メトリクスが表示されます。エンティティが APM によってのみ検出された場合、または APM と USM の両方によって検出された場合、パフォーマンスビューには APM トレースメトリクスが表示されます。
自動命名されたサービスの管理
推論されたエンティティのカタログでの表示方法を調整するには、次のようにします。
APM の相関要件
APM とカタログ間の適切な自動相関を確保するには、以下のベストプラクティスに従ってください。
- Datadog SDK および Datadog Agent のバージョンが推論エンティティをサポートしていることを確認します。
- 恣意的なサービスオーバーライドを防ぎ、代わりに推論エンティティを使用します。
- 恣意的なサービスオーバーライドは、相関関係の信頼性を損ない、カタログを乱雑にする可能性があります。また、オーバーライド名に馴染みのないユーザーには、カタログが使いにくくなります。
- チームの命名規則に合わせて、データストアやキューなどの推論エンティティの名前を変更します。
- unified service tagging を使用して、サービス名、環境、バージョンが APM、インフラストラクチャー、カタログ定義全体で一致するようにします。
- Datadog APM では、サービスとはトレースをグループ化し、メトリクスを集計するために使用される識別子であり、必ずしも論理的なサービスであるとは限りません。組織にとっての「サービス」を構成するものを定義し (例: Kubernetes の名前空間、デプロイメント、または個々の Pod)、この定義をすべてのテレメトリソースに一貫して適用します。
インフラストラクチャーおよびログからエンティティをインポートする
DD_SERVICE タグを含む他の Datadog テレメトリからサービスをインポートして、カタログにデータを取り込むことができます。Datadog のインフラストラクチャーのメトリクスまたはログを通じて kind:service エンティティを検出するには、カタログの [エンティティのインポートタブに移動します。
インポートされたエントリは [Explore] (調査) タブに表示されます。API、GitHub インテグレーション、または GitLab インテグレーションを使用して所有者や連絡先などのメタデータを追加しない場合、エントリは期限切れになる可能性があります。
デフォルトの [Explore] ビューからインポートされたサービスを削除するには、Import Entries タブで [Clear Previously Imported Services] (以前にインポートされたサービスのクリア) をクリックします。これにより、メタデータを持たないサービス、または APM、USM (Universal Service Monitoring)、RUM (Real User Monitoring) テレメトリを持たないサービスがすべて削除されます。
参考資料