タグの使用を開始する

概要

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

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

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

Datadog は、集計の サービス レベルでコンテナー、VM、クラウドインフラストラクチャーに注目することを推奨しています。たとえば、サーバー A とサーバー B で個別に CPU 使用率を確認するよりも、サービスを表すホストのコレクション全体で CPU 使用率を見ます。

コンテナやクラウド環境では、定期的にホストが入れ替わるため、タグを使用してメトリクスを集計することが重要です。

タグの定義

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

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

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

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

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

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

  4. タグは value または <KEY>:<VALUE> の形式にすることができます。よく使用されるタグ キーは、envinstancename です。キーの後ろには常に、グローバルタグ定義の最初のコロンが付きます。例:

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

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

タグ付けの方法

タグ付けの方法

タグ付けは、次のいずれか (またはすべて) の方法を使用して実行できます。

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

詳しくは、タグの付け方をご覧ください。

統合サービスタグ付け

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

使用方法

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

領域タグを使用して実行すること
イベントイベントストリームの絞り込み。
ダッシュボードグラフでのメトリクスの絞り込みおよびグループ化。
インフラストラクチャーホストマップ、インフラストラクチャー リスト、ライブ コンテナ、ライブプロセス ビューの絞り込みとグループ化。
モニターモニターの管理、モニターの作成、ダウンタイムの管理。
メトリクスメトリクスエクスプローラーでの絞り込みとグループ化。
インテグレーションAWS、Google Cloud、Azure のメトリクスをオプションで制限。
APMサービス、トレース、プロファイルをフィルターにかける。サービスマップを使って他のエリアに移動する。
RUM & セッションリプレイRUM エクスプローラーで、イベント検索、分析、パターン、リプレイ、問題をフィルターにかける。
SyntheticsCI Results Explorer で Synthetic テストや CI パイプラインで実行中のテストをフィルターし、グループ化。
ノートブックグラフでのメトリクスの絞り込みおよびグループ化。
ログログ検索、分析、パターン、Live Tail、パイプラインの絞り込み。
SLOSLO、グループ化されたメトリクスベース SLO、グループ化されたモニターベース SLO の検索。
開発者API を使用して情報を取得、または UI のさまざまな領域をセットアップ。
請求3 つのタグを選択することで Datadog の使用量を報告します。たとえば、envteamaccount_id のように選択できます。

詳しくは、タグの使用方法をご覧ください。

その他の参考資料