概要
タグは、Datadog テレメトリーにディメンションを追加する方法のひとつで、Datadog の可視化機能によって絞り込み、集計、比較できます。タグを使用すると、複数のホストの集計パフォーマンスを観察でき、必要に応じて、特定の要素に基づいて設定をさらに絞り込むこともできます。つまり、タグ付けは集計データポイントを観察する手段です。
タグ付けにより、Datadog のさまざまなデータタイプをバインドし、メトリクス、トレース、ログの間でアクションを関連付け、呼び出すことができます。これは、予約済みタグキーを使用して実現されます。
タグ キー | 可能な操作 |
---|
host | メトリクス、トレース、プロセス、ログの間の関連付け。 |
device | デバイスまたはディスクごとのメトリクス、トレース、プロセス、ログの分離。 |
source | ログ管理のためのスパンの絞り込みと自動パイプライン。 |
service | メトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング。 |
env | メトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング。 |
version | メトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング。 |
team | 任意のリソースに所有権を割り当てる |
Datadog は、集計の サービス
レベルでコンテナー、VM、クラウドインフラストラクチャーに注目することを推奨しています。たとえば、サーバー A とサーバー B で個別に CPU 使用率を確認するよりも、サービスを表すホストのコレクション全体で CPU 使用率を見ます。
コンテナやクラウド環境では、定期的にホストが入れ替わるため、タグを使用してメトリクスを集計することが重要です。
タグの定義
以下は、Datadog のタグ付け要件です。
タグの先頭は文字にする必要があり、その後は以下の文字を使用できます。
- 英数字
- アンダースコア
- マイナス
- コロン
- ピリオド
- スラッシュ
その他の特殊文字は、アンダースコアに変換されます。
タグの長さは最大 200 文字で、Unicode 文字 (日本語などの言語を含むほとんどの文字セットを含む) をサポートします。
タグは小文字に変換されます。そのため、CamelCase (キャメル ケース)
形式のタグは推奨されません。認証 (クローラー) ベースのインテグレーションでは、タグのキャメル ケース部分はアンダースコアに変換されます。たとえば、TestTag
は test_tag
となります。
タグは value
または <KEY>:<VALUE>
の形式にすることができます。よく使用されるタグ キーは、env
、instance
、name
です。キーの後ろには常に、グローバルタグ定義の最初のコロンが付きます。例:
タグ | キー | 値 |
---|
env:staging:east | env | staging:east |
env_staging:east | env_staging | east |
タグは、EPOCH タイムスタンプ、ユーザー ID、リクエスト ID などのバインドされていないソースをベースにすることはできません。実行すると、組織のメトリクス数が無限に増加し、請求に問題が発生します。
制限 (ダウンケースなど) はメトリクスタグにのみ適用され、ログ属性やスパンタグには適用されません。
タグ付けの方法
タグ付けの方法
タグ付けは、次のいずれか (またはすべて) の方法を使用して実行できます。
メソッド | タグ付けの方法 |
---|
コンフィギュレーションファイル | メインの Agent またはインテグレーションのコンフィギュレーションファイルで手動で行います。 |
UI | Datadog サイトで。 |
API | Datadog の API を使用するとき。 |
DogStatsD | DogStatsD でメトリクスを送信するとき。 |
詳しくは、タグの付け方をご覧ください。
統合サービスタグ付け
Datadog では、タグを付ける際のベストプラクティスとして、統合サービスタグ付けを使用することをおすすめしています。統合サービスタグ付けは、env
、service
、version
の 3 つの標準タグを使用して Datadog テレメトリーと結合します。ご使用環境で統合タグ付けを構成する方法に関する詳細は、統合サービスタグ付けをご参照ください。
使用方法
ホストとインテグレーション レベルでタグを割り当てた後、メトリクス、トレース、ログを絞り込みグループ化するためにタグの使用を開始します。タグは、Datadog プラットフォームの次の領域で使用されます。
領域 | タグを使用して実行すること |
---|
イベント | イベントストリームの絞り込み。 |
ダッシュボード | グラフでのメトリクスの絞り込みおよびグループ化。 |
インフラストラクチャー | ホストマップ、インフラストラクチャー リスト、ライブ コンテナ、ライブプロセス ビューの絞り込みとグループ化。 |
モニター | モニターの管理、モニターの作成、ダウンタイムの管理。 |
メトリクス | メトリクスエクスプローラーでの絞り込みとグループ化。 |
インテグレーション | AWS、Google Cloud、Azure のメトリクスをオプションで制限。 |
APM | サービス、トレース、プロファイルをフィルターにかける。サービスマップを使って他のエリアに移動する。 |
RUM & セッションリプレイ | RUM エクスプローラーで、イベント検索、分析、パターン、リプレイ、問題をフィルターにかける。 |
Synthetic Monitoring & Continuous Testing | Synthetic Monitoring & Testing Results Explorer を使用して、Synthetic テストや CI パイプラインで実行中のテストをフィルタリングおよびグループ化します。 |
ノートブック | グラフでのメトリクスの絞り込みおよびグループ化。 |
ログ | ログ検索、分析、パターン、Live Tail、パイプラインの絞り込み。 |
SLO | SLO、グループ化されたメトリクスベース SLO、グループ化されたモニターベース SLO の検索。 |
開発者 | API を使用して情報を取得、または UI のさまざまな領域をセットアップ。 |
請求 | 3 つのタグを選択することで Datadog の使用量を報告します。たとえば、env 、team 、account_id のように選択できます。 |
CI Visibility | CI Visibility Explorer を使用して、テスト実行またはパイプライン実行をフィルタリングおよびグループ化します。 |
詳しくは、タグの使用方法をご覧ください。
その他の参考資料