スパンからメトリクスを生成する

スパンベースメトリクス

スパンが保持フィルターでインデックス化されているかどうかに関係なく、取り込んだスパンの 100% からメトリクスを生成します。

特定の固定クエリや比較にカスタムメトリクスを使用する一方、保持フィルターを作成することで、保持されたトレースとそのフレームグラフの任意のクエリと調査が可能になります。

請求について: 取り込まれたスパンから生成されたメトリクスは、カスタムメトリクス として請求されます。

たとえば、カスタムメトリクスを異常検知の視覚化やダッシュボードおよびモニターの作成に使用して、ビジネスコンテキストにとって重要なさまざまなパラメーターの傾向を把握することができます。生成されたすべてのメトリクスは、Datadog カスタムメトリクスとして 15 か月間利用可能です。

理由スパンから生成されたカスタムメトリクスRetention Filters
保持期間15 か月30 日
異常検知生成されたメトリクスに基づき異常検知モニターを作成します。分析を使用して過去 15 日間の動作を比較し、完全なトレースを表示して根本原因を調査します。
完全なコンテキストで一致するトレースの調査N/A - カスタムメトリクスは、関連するトレースを保持しません。保持フィルターを使用して、ビジネスコンテキストに関連するトレースを正確に保持します。
動作の粒度重要なエンドポイントまたはその他のカーディナリティの低いグループのカスタムメトリクスを作成します。特定のエンドポイントにトレースエクスプローラーを使用するか、分析で ‘Group By’ オプションを使用します。
予測または複雑な数学生成されたメトリクスに基づき、予測値モニターを作成します。N/A

スパンからメトリクスを生成するには、APM のセットアップとコンフィギュレーション ページで Generate Metrics タブを選択し、New Metric ボタンをクリックします。


取り込んだスパンからメトリクスを生成する

スパンベースのメトリクスの作成

メトリクスの作成方法

  1. メトリクスクエリを定義する: 必要なデータセットにフィルタリング用のクエリを追加することから始めます。クエリ構文は、APM 検索と分析と同じです。

  2. 追跡するフィールドを定義する: * を選択してクエリに一致するすべてのスパンのカウントを生成するか、属性 (たとえば、@cassandra_row_count) を入力して数値を集計し、対応するカウント、最小、最大、合計、および平均の集計メトリクスを作成します。属性タイプがメジャーの場合、メトリクスの値はスパン属性の値です。

    注: 数値でないスパン属性は集計に使用できません。スパン属性の異なる値をカウントするメトリクスを生成するには (例えば、特定のエンドポイントを訪問するユーザー ID の数をカウントする)、このディメンションを group by セレクタに追加し、count_nonzero 関数を使用してタグ値の数をカウントします。

  3. グループ化ディメンションを指定する: デフォルトでは、スパンから生成されたメトリクスには、明示的に追加されない限りタグがありません。スパンに存在する属性またはタグを使用して、メトリクスタグを作成できます。

  4. ライブ分析と検索クエリのプレビューを確認する: クエリがデータの視覚化に与える影響と、クエリで考慮される一致するスパンをライブプレビューでリアルタイムに表示できます。

  5. メトリクスに名前を付ける: メトリクス名は、メトリクス命名規則に従う必要があります。trace.* で始まるメトリクス名は許可されておらず、保存されません。

スパンベースのメトリクスはカスタムメトリクスと見なされ、それに応じて請求されます。請求への影響を避けるために、タイムスタンプ、ユーザー ID、リクエスト ID、セッション ID などの無制限または非常に高いカーディナリティ属性によるグループ化は避けてください。

既存のスパンベースのメトリクスの更新

既存のメトリクスを編集する

メトリクスの作成後、2 つのフィールドのみを更新できます。

フィールド理由
Stream filter query一致するスパンのセットを変更して、メトリクスに集計します。
集計グループタグを更新して、生成されたメトリクスのカーディナリティを管理します。

注: メトリクスのタイプまたは名前を変更するには、新しいメトリクスを作成し、古いメトリクスを削除します。

その他の参考資料

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

トレースの取り込みをカスタマイズし、重要なトレースを保持します。ドキュメント more more 保持されたトレースに基づいて分析クエリとモニターを使用します。ドキュメント more more Terraform によるスパンベースのメトリクスの作成と管理外部サイト more more