概要

カタログは、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 エンティティを検出するには、カタログの [エンティティのインポートタブに移動します。

カタログのセットアップおよび構成セクションにある [Import Entries] タブ

インポートされたエントリは [Explore] (調査) タブに表示されます。API、GitHub インテグレーション、または GitLab インテグレーションを使用して所有者や連絡先などのメタデータを追加しない場合、エントリは期限切れになる可能性があります。

デフォルトの [Explore] ビューからインポートされたサービスを削除するには、Import Entries タブで [Clear Previously Imported Services] (以前にインポートされたサービスのクリア) をクリックします。これにより、メタデータを持たないサービス、または APM、USM (Universal Service Monitoring)、RUM (Real User Monitoring) テレメトリを持たないサービスがすべて削除されます。

カタログのセットアップおよび構成セクションで、以前にインポートされたサービスの削除を確認します

参考資料

役立つドキュメント、リンク、記事: