タグの概要

はじめに

タグは、Datadog テレメトリーにディメンションを追加する方法のひとつで、Datadog の可視化機能によって絞り込み、集計、比較できます。タグを使用すると、多数のホストの集計パフォーマンスを観察でき、必要に応じて、特定の要素に基づいて設定をさらに絞り込むこともできます。つまり、タグ付けは集計データポイントを観察する手段です。

タグ付けにより、Datadog のさまざまなデータ タイプをバインドし、メトリクス、トレース、ログの間でアクションを関連付け、呼び出すことができます。この操作は、専用タグ キーで実行できます。以下に例を示します。

タグ キー可能な操作
hostメトリクス、トレース、プロセス、ログの間の関連付け
deviceデバイスまたはディスクごとのメトリクス、トレース、プロセス、ログの分離
sourceログ管理のためのスパンの絞り込みと自動パイプライン
serviceメトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング
envメトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング
versionメトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング

重要である理由

これは通常、集計の サービス レベルでコンテナー、VM、クラウドインフラストラクチャーに注目する際に役立ちます。たとえば、サーバー A とサーバー B で個別に CPU 使用率を確認するよりも、サービスを表すホストのコレクション全体で CPU 使用率を見る方が便利です。

コンテナとクラウド環境は常にホストの間を移動しているので、取得するメトリクスを集計できるようにタグ付けすることが重要です。

タグの定義

以下は、Datadog のタグ付け要件です。

  1. タグの先頭は文字にする必要があり、その後は以下の文字を使用できます。

    • 英数字
    • アンダースコア
    • マイナス
    • コロン
    • ピリオド
    • スラッシュ

    その他の特殊文字は、アンダースコアに変換されます。

    注: tag: のようにタグの末尾にコロンを使用することはできません。

  2. タグの長さは最大 200 文字で、Unicode (日本語などの言語を含むほとんどの文字セットを含む) をサポートします。

  3. タグは小文字に変換されます。そのため、CamelCase (キャメル ケース) 形式のタグは推奨されません。認証 (クローラー) ベースのインテグレーションでは、タグのキャメル ケース部分はアンダースコアに変換されます。たとえば、TestTag は test_tag となります。注: host タグと device タグはこの変換から除外されます。

  4. タグは value または <KEY>:<VALUE> の形式にすることができます。機能を最大限に活用するために、タグを** <KEY>:<VALUE> 形式に構成することをお勧めします** 。よく使用されるタグ キーは、env、instance、name です。キーの後ろには常に、グローバルタグ定義の最初のコロンが付きます。例:

    タグキー値
    env:staging:eastenvstaging:east
    env_staging:eastenv_stagingeast

  5. タグは、EPOCH タイムスタンプ、ユーザー ID、リクエスト ID などのバインドされていないソースをベースにすることはできません。実行すると、組織のメトリクス数が無限に増加し、請求に問題が発生します。

  6. 制限 (ダウンケースなど) はメトリクスタグにのみ適用され、ログ属性やスパンタグには適用されません。

タグの付け方

タグ付けの方法

タグ付けは、次のいずれか (またはすべて) の方法を使用して実行できます。タグの割り当てについては別途ドキュメントをご用意しておりますので、詳細はそちらをご参照ください。

メソッドタグ付けの方法
構成ファイルメインの Agent またはインテグレーションのコンフィギュレーションファイルで手動で行います。
UIDatadog アプリ
APIDatadog の API を使用するとき
DogStatsDDogStatsD 経由でメトリクスを送信するときに行います

統合サービスタグ付け

Datadog では、タグを付ける際のベストプラクティスとして、統合サービスタグ付けを使用することをおすすめしています。統合サービスタグ付けは、env、service、version の 3 つの標準タグを使用して Datadog テレメトリーと結合します。ご使用環境で統合タグ付けを構成する方法に関する詳細は、統合サービスタグ付けドキュメントをご参照ください。

タグの使用方法

ホストとインテグレーション レベルでタグを割り当てた後、メトリクス、トレース、ログを絞り込みグループ化するためにタグの使用を開始します。タグは、Datadog プラットフォームの次の領域で使用されます。詳細は、タグの使用方法に関するドキュメントをご参照ください。

領域タグを使用して実行すること
イベントイベントストリームの絞り込み
ダッシュボードグラフでのメトリクスの絞り込みおよびグループ化
インフラストラクチャーホストマップ、インフラストラクチャー リスト、ライブ コンテナ、ライブプロセス ビューの絞り込みとグループ化
モニターモニターの管理、モニターの作成、ダウンタイムの管理
メトリクスMetric Explorer での絞り込みとグループ化
インテグレーションAWS、Google Cloud、Azure のメトリクスをオプションで制限
APMAnalytics の絞り込み、サービス マップでの他の領域へのジャンプ
ノートブックグラフでのメトリクスの絞り込みおよびグループ化
ログログ検索、分析、パターン、Live Tail、パイプラインの絞り込み
SLOSLO、グループ化されたメトリクスベース SLO、グループ化されたモニターベース SLO の検索
開発者API を使用して情報を取得、または UI のさまざまな領域をセットアップ
課金3 つのタグを選択することで Datadog の使用量を報告します。たとえば、env、team、account_id のように選択できます。

その他の参考資料

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

タグの割り当て方法DOCUMENTATION more more 統合サービスタグ付けを構成DOCUMENTATION more more Datadog アプリでタグを使用する方法DOCUMENTATION more more