概要

Metrics Summary ページには、指定された期間 (過去 1 時間、1 日、または 1 週間) に Datadog に報告されたメトリクスのリストが表示されます。

[Metric] (メトリクス) または [Tag] (タグ) の検索フィールドを使用して、メトリクス名またはタグでメトリクスを検索します。

注: タグ値は [Tag] 検索フィールドに 28 時間保持されます。過去 28 時間以内に送信されていない値は、メトリクス詳細サイドパネルに表示されていても、検索オプションには表示されません。

[Metric] 検索フィールドの強化されたあいまい一致サポートを使用して、関連するメトリクスを見つけることもできます。

タグフィルタリングはブール演算子とワイルドカード構文をサポートしているため、以下を特定できます。

• 特定のタグキーでタグ付けされたメトリクス (例: team: team:*)
• 特定のタグキーが欠落しているメトリクス (例: team: NOT team:*)

ファセットパネル

検索バーは、メトリクスのリストをフィルタリングするための最も包括的なアクションセットを提供します。しかし、ファセットを使用して以下の要素でメトリクスをフィルタリングすることもできます。

• Configuration: タグ設定を持つメトリクス
• Percentiles: パーセンタイル/高度なクエリ機能によって有効化される分布メトリクス
• Historical Metrics: 過去のメトリクスの取り込みが有効になっているメトリクス
• Query Activity: 過去 30 日、60 日、または 90 日間に Datadog または API によってクエリされていないメトリクス
• Related Assets: ダッシュボード、ノートブック、モニター、および SLO で使用されているメトリクス
• Metric Type: 分布メトリクスと非分布メトリクス (カウント、ゲージ、レート) を区別
• Metric Origin: メトリクスの生成元となった製品 (例: Logs や APM Spans から生成されたメトリクス)。さまざまなメトリクス生成元タイプの詳細については、メトリクス生成元の定義を参照してください。

定義

メトリクスは、過去 30 日、60 日、または 90 日間に、モニター、SLO、実行されたノートブック、開かれたダッシュボード、Metrics Explorer クエリでの使用、または API 呼び出しを通じてアクセスされていない場合、クエリされていないと見なされます。

メトリクスは、アクティブにクエリされているかどうかにかかわらず、アセット上に存在する限り使用されていると見なされます。

複数のメトリクスの設定

[Configure Metrics] (メトリクスを設定) をクリックすると、一度に複数のメトリクスを設定するためのオプションが表示されます。

• Manage tags (タグの管理): Metrics without Limits™ を使用して、名前空間に一致する複数のカスタムメトリクスのタグを設定します。

• Enable or disable percentiles (パーセンタイルの有効化/無効化): 複数の分布メトリクスにわたるパーセンタイル集計を管理します。詳細については、分布を参照してください。

• Enable or disable historical metrics ingestion (過去のメトリクスの取り込みの有効化/無効化): 過去のメトリクスデータの取り込みを管理します。詳細については、過去のメトリクスの取り込みを参照してください。

メトリクスの詳細サイドパネル

メトリクス名をクリックすると、そのメトリクスのメタデータとタグに関する詳細情報が表示される詳細サイドパネルが開きます。

メトリクス名

Metrics Explorer、ダッシュボードなどにおけるメトリクスの名前です。

取り込まれたカスタムメトリクス

メトリクス名は、関連付けられたタグ値の組み合わせに応じて、複数の取り込まれたカスタムメトリクスを出力する場合があります。取り込まれたカスタムメトリクスは、コードとともに送信されたすべての元のデータを表します。

詳細については、カスタムメトリクスのドキュメントを参照してください。

インデックス化されたカスタムメトリクス

取り込まれたカスタムメトリクスとは異なり、インデックス化されたカスタムメトリクスは、Datadog プラットフォーム全体でクエリ可能なメトリクスを表します。この数値は、パーセンタイル集計の追加や削除、または Metrics without Limits™ の使用によって影響を受ける可能性があります。詳細については、Metrics without Limits™ のドキュメントを参照してください。

ホスト

メトリクスを報告しているホストの総数です。

タグ値

メトリクスに付与されている一意のタグ値の総数です。

タグ付けの詳細をご覧ください。

メトリクスのメタデータ

メトリクスに付随するメタデータです。ほとんどのメタデータは、Metrics Summary ページまたは Datadog API を使用して編集できます。

メトリクスの単位

メトリクスの単位です (バイト、秒、リクエスト、クエリなど)。詳細については、メトリクスの単位のページを参照してください。

Datadog にカスタムメトリクスを送信する際に、グラフ上でメトリクスにカーソルを合わせたときに表示される測定単位を変更できます。

注: これは、メトリクスグラフの表示方法を変更するものではありません。メトリクスにカーソルを合わせたときに生の値がどのような単位として扱われるかを変更するだけです。読みやすくするために、フォーマットが自動的に適用されます。たとえば、バイト (B) がキロバイト (KiB) として表示される場合があります。

メトリクスタイプ

メトリクスのタイプです (ゲージ、レート、カウント、分布)。詳細については、メトリクスタイプのページを参照してください。

警告: メトリクスタイプを編集すると、すべてのダッシュボードとモニターでそのメトリクスの動作が変更されます。

インテグレーション名

メトリクスがサポートされているインテグレーションから送信されている場合、メタデータにインテグレーション名が記載されます。この情報は編集できません。

間隔

メトリクスの収集間隔です (秒単位)。

メトリクスの説明

メトリクスの説明は、メトリクスが何を表し、なぜ存在し、どのように使用されるかを理解するのに役立ちます。このフィールドを使用して、カスタムメトリクスの説明を表示および更新します。サポートされているインテグレーションからのメトリクスに対しては、説明が事前に入力されます。

AI 生成の説明

Datadog では、カスタムメトリクスの説明を、利用可能なコンテキスト (メトリクス名、意味のあるタグ、クエリのアクティビティ、接続されたソースコードなど) を使用して自動生成できます。ソースコードを追加のコンテキストとして使用するには、Datadog の GitHub、GitLab、または Azure DevOps のインテグレーションをインストールし、リポジトリを接続してください。

ソースコード

メトリクスサイドパネルの [Source Code] (ソースコード) セクションでは、すべてのカスタムメトリクスとその基盤となるコンテキストを一元的に表示できます。

メトリクスサイドパネルの [Source Code] セクションを使用して、メトリクスのソースコードを特定し、その生成方法を理解し、所有者を判断します。コンテキストと所有権を可視化して、メトリクスのソースファイル、コミット履歴、blame データに直接リンクすることで、トラブルシューティングと最適化を迅速化できます。

メトリクスが見つからない場合のトラブルシューティング

メトリクスが [Source Code] に表示されない場合は、その定義方法が原因である可能性があります。

Datadog では、名前が明示的な文字列として記述されているメトリクスが、最も適切に検出されます。変数、定数、またはカスタムヘルパーを使用して構築されたメトリクスは、検出されない可能性があります。

メトリクスが見つからない一般的な理由:

• メトリクス名が動的に生成されている
• メトリクスがカスタムラッパーを通じて送信されている
• リポジトリが完全にインデックス化されていない

ベストプラクティス:

• 可能な限り、メトリクス名を明示的な文字列として定義する

例:

変数を使用してメトリクスを送信 (非推奨)

public static final String METRIC_NAME = "my.metric.name";
statsEmitter.distribution(METRIC_NAME, value, tags);

明示的な文字列としてメトリクスを送信 (推奨)

timer = meterRegistry.timer("my.metric.name");

メトリクスのソースコードを完全にカバーするには、Datadog の GitHub、GitLab、または Azure DevOps のインテグレーションがインストールされており、すべてのリポジトリが接続されていることを確認してください。

タグテーブル

タグテーブルは、メトリクスのデータでアクティブにレポートされているすべてのタグキーとタグ値を探索するための複数の方法を提供します。

タグテーブルを使用して以下の操作を行えます。

• Count 列 (一意のタグ値の数) でタグキーを並べ替る。
• ページ分割されたタグテーブルから特定のタグキーを検索する。
• タグテーブルをダウンロード可能な CSV としてエクスポートする。
• メトリクスに設定したタグと、元々送信されたメトリクスのタグを切り替える。

特定のタグキーに対して以下の操作を行えます。

• そのタグキーのすべてのタグ値を調査する。
• 特定のタグの key:value を使用して、Metrics Summary ページに表示されるメトリクスのリストをさらにフィルタリングする。
• Metrics Explorer で、タグの key:value ペアでフィルタリングされたこのメトリクスのグラフを開く。
• アプリケーション全体でフィルタリングするために、任意のタグの key:value をコピーする。

タグ付けの詳細をご覧ください。

メトリクス関連アセット

組織にとってのメトリクス名の価値を判断するには、メトリクス関連アセットを使用します。メトリクス関連アセットとは、特定のメトリクスをクエリするダッシュボード、ノートブック、モニター、または SLO を指します。

1. メトリクスの詳細サイドパネルの一番下までスクロールして、[Related Assets] (関連アセット) セクションに移動します。
2. ドロップダウンボタンをクリックして、関心のある関連アセットのタイプ (ダッシュボード、モニター、ノートブック、SLO) を表示します。さらに、検索バーを使用して特定のアセットを検証することもできます。
3. [Tags] (タグ) 列には、各アセットで使用されているタグが正確に表示されます。

Custom Metrics Tags Cardinality Explorer

Metrics without Limits™

Metrics without Limits™ を使用すると、エージェントやコードレベルの変更を必要とせずに、カスタムメトリクスのサイズを制御できます。

注: Metrics without Limits™ は、カスタムメトリクスでのみ利用可能です。

タグ付けを一括で設定するには、[Metrics] (メトリクス) ページの [Configure Metrics] > [Manage tags] に移動するか、メトリクスの詳細サイドパネルにある [Manage Tags] ボタンをクリックします。

1. [Metrics Summary] テーブルでカスタム分布メトリクス名をクリックして、メトリクスの詳細サイドパネルを開きます。
2. [Manage Tags] ボタンをクリックして、タグ設定モーダルを開きます。
3. [Include tags…] (含めるタグ) または [Exclude tags…] (除外するタグ) を選択して、クエリ対象にするタグとしないタグをカスタマイズします。タグ設定の詳細については、Metrics without Limits のドキュメントを参照してください。
4. 提案するタグ設定の効果をカーディナリティエスティメーターでプレビューした後、[Save] (保存) を選択します。

注: カーディナリティエスティメーターを使用するには、メトリクスが 48 時間以上経過している必要があります。

クエリ可能なタグ

Metrics without Limits™ でメトリクスを設定すると、どのタグがクエリ可能であるかを確認できます。これらは、最終的に Indexed Custom Metrics のボリュームに寄与するタグです。また、Ingested Custom Metrics のボリュームに寄与する、元々送信および取り込まれたすべてのタグに切り替えることもできます。

メトリクス生成元の定義

このテーブルは、ファセットに表示されるメトリクス生成元とその送信元とのマッピングを示しています。

参考資料

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

Metrics Explorerドキュメント メトリクス分布ドキュメント