タグの使用を開始する

概要

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

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

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

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

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

タグの定義

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

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

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

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

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

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

  4. タグは 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 プラットフォームの次の領域で使用されます。

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

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

その他の参考資料

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

タグの割り当て方法DOCUMENTATION more more 統合サービスタグ付けの構成方法を学ぶDOCUMENTATION more more タグの使用方法についてDOCUMENTATION more more Datadog を使った効果的なタグ付けに関するインタラクティブなセッションに参加できますFOUNDATION ENABLEMENT more more