概要
メトリクスが 750 種以上の Datadog インテグレーション以外から送信された場合、そのメトリクスはカスタムメトリクスとみなされます。カスタムメトリクスを使うと、訪問者数、平均顧客バスケットサイズ、リクエストレイテンシー、カスタムアルゴリズムのパフォーマンス分布など、アプリケーションの KPI を追跡することができます。特定の標準インテグレーションは、カスタムメトリクスを出力する可能性もあります。
カスタムメトリクスは、メトリクス名とタグ値 (ホストタグを含む) の組み合わせにより、一意に識別されます。一般に、DogStatsD またはカスタム Agent チェックを使用して送信されるメトリクスはすべて、カスタムメトリクスとなります。
注: 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 のカスタムメトリクスの課金ポリシーに従って課金されます。
標準インテグレーション
以下の標準インテグレーションでは、カスタムメトリクスを生成することができます。
その他の参考資料
