タグの使用方法
Dash が新機能を発表!インシデントマネジメント、Continuous Profiler など多数の機能が追加されました! Dash イベントで発表された新機能!

タグの使用方法

タグの割り当て後に、Datadog プラットフォームでタグを使用してデータの絞り込みおよびグループ化を開始します。タグを使用して、データを含めたり除外したりできます。複数のタグを含めたり除外したりする場合:

  • 含めるには AND ロジックを使用します
  • 除外するには OR ロジックを使用します

イベント

イベントストリームは、指定された期間に環境内で発生したイベントを表示します。タグを使用して、イベント リストを絞り込み、イベントのサブセットに注目します。そのタグを持つホスト、インテグレーション、サービスからのすべてのイベントを表示するには、tags: に続けてタグを入力します。以下の例は、tags:service:coffee-house を使用してタグ service:coffee-house を検索します。複数のタグを包括的に検索するには、tags:service:coffee-house OR host:coffeehouseprod のように各タグを「OR」で区切ります。複数のタグを排他的に検索するには、tags:service:coffee-house,host:coffeehouseprod のように各タグをカンマで区切ります。

ダッシュボード

タグを使用し、メトリクスを絞り込んでダッシュボード グラフに表示するか、表示するメトリクスのグループを作成します。表示するメトリクスを絞り込むには、from テキストボックスにタグを入力します。これにより、この特定のタグ (この例では service:coffee-house) が割り当てられたすべてのソースについて、選択されたメトリクスが表示されます。

タグを使用して集計されたグループを作成するには、avg by テキストボックスにタグのキー部分を入力します。たとえば、service:coffee-house のようにキー service でタグ付けされたメトリクスを表示する時系列グラフでは、avg by テキストボックスに service を入力すると、service のタグ値ごとに 1 つの行が表示されます。各行は、この service タグ値を共有するすべてのソースの平均のメトリクス値を表します。

タグを使用して、ダッシュボードでイベントを重ねることもできます。これは、イベントストリームと同じように機能します。 tags: に続けてタグを入力します。一致するイベントは、縦棒としてグラフに重なります。以下の例は、tags:service:coffee-house を使用します。

ダッシュボードのグラフの from タグの切り替え時間を短縮するには、テンプレート変数を使用します。以下の例では、service を使用して service タグキーを表します。テンプレート変数を使用するには、グラフ クエリの from テキストボックスに $service テンプレート変数を追加します。

以下は、時系列チャートエディターを使用したタグの例です。最初のスクリーンショットでは、タグは適用されていません。すべてのホストでの平均 CPU 使用率が表示されます。

次に、タグ (region:eastus) を from テキストボックスに含めるようにエディターを更新します。これにより、Datadog は米国東部リージョンでの CPU 使用率を参照できます。この例では region タグを使用しますが、applicationserviceenvironment など、Datadog プラットフォームに送信された任意のタグを使用できます。

最後に、2 番目の空フィールド (avg by テキストボックス) を使用して、各 host の個別の時系列線を表示します。米国東部リージョンで実行されている個別のホストのサーバー CPU が表示されます。

必要に応じて、タグを追加して範囲をさらに絞り込みます。たとえば、region:eastusenv:production のホストなどです。タグは Datadog 全体で使用でき、すべてのコア要素 (メトリクス、トレース、ログ) に適用されます。

Infrastructure

ホストマップインフラストラクチャーリストコンテナ処理を絞り込むには、ページ上部にある Filter by テキストボックスにタグを入力します。ホストとコンテナは Group by テキストボックスを使い、タグキーでグループ化できます。グループボックスに service と入力すると、各サービスがグループの見出しとして表示されます。

このセクションでは、タグを使用してホストを絞り込みまたはグループ化します。

または、コンテナを絞り込みまたはグループ化することもできます。

以下は、インフラストラクチャーリストページのテキストボックスによる絞り込みまたはグループ化です。

以下は、ライブコンテナページのテキストボックスによる絞り込みまたはグループ化です。

以下は、ライブプロセスページのテキストボックスによる絞り込みまたはグループ化です。

モニター

割り当てられたタグによってモニターを絞り込むには、検索バーかファセットのチェックボックスを使用します。検索バーの形式は tag:<キー>:<値> で、tag:service:coffee-house などです。特定のタグを持つモニターを検索から除外するには、 - を使用して、tag:-service:coffee-house とします。: モニター タグは、メトリクス タグとは別のもので、独立しています。

モニターを作成する場合は、以下の場所でメトリクス タグを使用します。

  • これらのタグがあるメトリクスのみにモニター範囲を制限する from テキストボックス。

  • 対応するメトリクスをモニター範囲から削除する excluding テキストボックス。

  • モニターを各タグ値で複数警告モニターに変換する avg by テキストボックス。

モニター タグ別にダウンタイムを絞り込むには、検索バーに service:coffee-house などのタグ名を入力します。

メトリクス

Metrics Explorer でタグを使用して、複数のタグでメトリクスを絞り込むか、タグ キー別に複数のグラフを表示します。以下の例は、service:coffee-house のメトリクスのグラフを作成し、host ごとに 1 つのグラフを表示します。

インテグレーション

一部のインテグレーションでは、オプションでタグを使用してメトリクスを制限できます。

The AWS インテグレーションタイル には、to hosts with tagto Lambdas with tag という 2 つのタグフィルターがあります。

これらのフィールドでは、EC2 や Lambda リソースの収集に使うフィルターを定義する、コンマで区切られたタグのリスト(<KEY>:<VALUE> 形式)が使用できます。<KEY>:<VALUE> はタグに基づく監視に応じて関数を含めたり除外したりできます。タグを除外するように指定するには、タグキーの前に ! を入力します。? (1 文字の場合)や * (複数文字の場合)のようなワイルドカードも使用できます。

フィルターには、OR ステートメントを使用して包含タグが存在するリソースが含まれます。以下のフィルター例は、datadog:monitored または env:production タグを含む EC2 インスタンスを収集します。

datadog:monitored,env:production

除外タグを指定すると、それが優先され AND ステートメントとなります。以下のフィルター例では、datadog:monitored または env:production または c1.* 値を持つ instance-type タグで region:us-east-1 タグではないタグを含む EC2 インスタンスを収集します。

datadog:monitored,env:production,instance-type:c1.*,!region:us-east-1

AWS のタグ付けに関する詳細は、EC2 および Lambda ドキュメントを参照してください。

Azure インテグレーションタイル には、Optionally filter to VMs with tag というタグフィルターがあります。

このフィールドでは、Azure VM からメトリクスを収集する際に使用されるフィルターを定義する、カンマ区切りのタグのリスト(<KEY>:<VALUE> 形式)を受け付けます。? (1 文字の場合) や * (複数文字の場合) などのワイルドカードも使用できます。定義されたタグのいずれかに一致する VM だけが Datadog にインポートされ、それ以外は無視されます。

特定のタグと一致する VM は、タグの前に ! を加えることで除外することもできます。たとえば、

datadog:monitored,env:production,!env:staging,instance-type:c1.*

Google Cloud インテグレーションタイル には、タグフィルター to hosts with tag があります。

このフィールドでは、GCP からメトリクスを収集する際に使用されるフィルターを定義する、カンマ区切りの GCP ラベルのリスト(<KEY>:<VALUE> 形式)を受け付けます。? (1 文字の場合) や * (複数文字の場合) などのワイルドカードも使用できます。定義されたタグのいずれかに一致するホストだけが Datadog にインポートされ、それ以外は無視されます。

特定のラベルと一致するホストは、タグの前に ! を加えることで除外することができます。たとえば、

datadog:monitored,env:production,!env:staging,instance-type:c1.*

GCP ラベリングに関する詳細は、GCP ドキュメントを参照してください。

APM

トレース検索では、検索バーまたはファセットのチェックボックスを使用して、タグでトレースを絞り込みます。検索バーの形式は <KEY>:<VALUE> で、service:coffee-house などです。高度な検索については、トレース検索のページを参照してください。

タグの割り当て後、サービスマップを使用して、特定のサービスをクリックしてアプリケーションのそれぞれの領域にジャンプできます。以下の例では、タグ service:coffee-house で絞り込んで、App Analyticsモニターログホストマップを表示します。

ノートブック

ノートブックグラフを作成するときに、from テキストボックスでタグを使用してメトリクスを制限します。さらに、avg by テキストボックスでタグを使用してメトリクスをグループ化します。以下の例では、メトリクスは service:coffee-house に制限され、host でグループ化されます。

タグを除外するには、</> を使用してテキストを編集して、!<KEY>:<VALUE> の形式でタグを追加します。以下の例では、!service:coffeehouse を使用して service:coffeehouse を除外します。

ログ

ログ検索分析パターンLive Tailは、検索バーまたはファセットのチェックボックスを使用して、タグでログを絞り込みます。検索バーの形式は <KEY>:<VALUE> で、service:coffee-house などです。高度な検索については、ログ検索のページを参照してください。

さらに、タグを使用してログ パイプラインを絞り込みます。以下の例では、パイプラインはタグ service:coffee-house でログを絞り込みます。

サービスレベル目標

割り当てられたタグによって SLO を絞り込むには、検索バーかファセットのチェックボックスを使用します。検索バーの形式は <KEY>:<VALUE> で、journey:add_item などです。特定のタグを持つ SLO を検索から除外するには、- を使用して、-journey:add_item とします。: SLO タグは、SLO の基底のメトリクスやモニターで使用されるメトリクスタグやモニタータグとは別のもので、独立しています。

メトリクスベースの SLO を作成する場合、SLO の成功率メトリクスクエリでメトリクスタグを使用します(すべてのメトリクスは同じセットのメトリクスタグを使用する必要があります)。

  • これらのタグのみにメトリクス範囲を制限する from テキストボックス。
  • SLO 全体と各タグ値のステータス割合および残りのエラーバジェットを表示する、グループ化されたメトリクスベースの SLO を作成するための sum by テキストボックス。

単一のグループ化されたモニターを使用してモニターベースの SLO を作成する場合、選択されたグループで計算 トグルを使用して、基底のモニターから最大 20 個のタグ値を選択し、SLO 全体および各タグ値のステータス割合および残りのエラーバジェットを表示します。

開発者

API では、タグはさまざまな方法で使用できます。これらのセクションへのリンクは、以下のリストを参照してください。

その他の参考資料