イネーブルメントウェビナーセッションに参加
カスタムメトリクスのための Foundation Enablement セッションにご登録してください。カスタムメトリクスが、訪問者数、平均顧客バスケットサイズ、リクエストレイテンシー、カスタムアルゴリズムのパフォーマンス分布など、アプリケーション KPI の追跡にどのように役立つかを学びましょう。
概要
カスタムメトリクスは、訪問者数、平均顧客バスケットサイズ、リクエストレイテンシー、カスタムアルゴリズムのパフォーマンス分布など、アプリケーションの KPI を追跡するのに役立ちます。カスタムメトリクスは、メトリクス名とタグ値 (ホストタグを含む) のユニークな組み合わせによって識別されます。以下の例では、メトリクス request.Latency は 2 つのタグキーから 4 つのユニークなタグ値の組み合わせを持っています。
endpoint の値は endpoint:X または endpoint:Y とします。status の値は status:200 または status:400 とします。
以下もカスタムメトリクスと見なされます。
注: Datadog 管理者のロールまたは usage_read 権限を持つユーザーは、使用量の詳細ページで、アカウントの 1 時間当たりのカスタムメトリクスの月平均数と、上位 5000 個のカスタムメトリクスを参照できます。詳しくは、カスタムメトリクスの数え方を参照してください。
カスタムメトリクスのプロパティ
Datadog のカスタムメトリクスには、以下のプロパティがあります。Datadog 内でメトリクスをグラフ化する方法については、メトリクスの概要をお読みください。
| プロパティ | 説明 |
|---|
<METRIC_NAME> | メトリクスの名前。 |
<METRIC_VALUE> | メトリクスの値。注: メトリクスの値は 32 ビットである必要があります。値は日付またはタイムスタンプを反映できません。 |
<タイムスタンプ> | メトリクスの値に関連付けられたタイムスタンプ。注: メトリクスのタイムスタンプは、未来は 10 分、過去は 1 時間を超えることはできません。 |
<タグ> | メトリクスに関連付けられているタグセット。 |
<METRIC_TYPE> | メトリクスのタイプ。メトリクスのタイプをお読みください。 |
<INTERVAL> | メトリクスの <TYPE> が RATE または COUNT の場合は、その間隔を定義します。 |
カスタムメトリクスの名前
カスタムメトリクスの名前は、以下の命名規則に従う必要があります。
- メトリクス名は文字で開始する必要があります。
- メトリクス名に使用できるのは、ASCII 英数字、アンダースコア、およびピリオドだけです。
- スペースなどの他の文字はアンダースコアに変換されます。
- Unicode はサポートされません。
- メトリクス名は 200 文字以内で作成できますが、ユーザーインターフェイスの観点からは、100 文字未満をお勧めします。
注: Datadog のメトリクス名は大文字と小文字が区別されます。
メトリクス単位
メトリクスサマリーを使用してメトリクス単位を設定するか、可視化のグラフエディタで単位オーバーライド機能を使用してカスタムメトリクス単位を設定できます。詳細については、メトリクス単位のドキュメントを参照してください。
カスタムメトリクスの送信
メトリクスを Datadog に送信する方法は複数あります。
Datadog 公式およびコミュニティ寄稿の API および DogStatsD クライアントライブラリのいずれかを使用して、カスタムメトリクスを送信することもできます。
注: カスタムメトリクスの送信に適用される固定のレート制限はありません。デフォルトの割り当てを超えた場合は、Datadog のカスタムメトリクスの課金ポリシーに従って課金されます。
標準インテグレーション
以下の標準インテグレーションでは、カスタムメトリクスを生成することができます。
参考資料
