概要

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

複数のタグを含めたり除外したりする場合:

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

イベント

イベントエクスプローラーは、指定された期間の環境からのイベントを表示します。タグを使用して、イベントリストをフィルターし、イベントのサブセットに焦点を当てることができます。tags: の後にタグを入力すると、そのタグを持つホスト、インテグレーション、またはサービスからのすべてのイベントを見ることができます。例えば、service:coffee-house というタグを検索するには、tags:service:coffee-house を使用します。

複数のタグを包括的に検索する場合は、括弧を使用し、各タグを OR で区切ってください: tags:(service:coffee-house OR host:coffeehouseprod)。複数のタグを排他的に検索するには、各タグを AND で区切ってください: tags:(service:coffee-house AND host:coffeehouseprod)

ダッシュボード

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

'from' フィールドにタグを追加することで、ダッシュボードのメトリクスをフィルタリング。この例では、メトリクスが 'service:web-store' でフィルタリングされています

高度なタグ値のフィルタリングはブールフィルターでも使用できます。次のブール構文がサポートされます。

  • NOT, !
  • AND, ,
  • OR
  • key IN (tag_value1, tag_value2,...)
  • key NOT IN (tag_value1, tag_value2,...)

ANDOR を使用して、特定のタグ全体のメトリクスを確認します。

AND/OR を使用したブールフィルター

INNOT IN を使用して、メトリクスを特定のタグにフィルタリングします。

IN/NOT IN を使用したブールフィルター

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

ダッシュボードの avg by テキストボックスに入力されたタグ

タグを使用して、ダッシュボードでイベントを重ねることもできます。これは、イベントエクスプローラーと同じように機能します。 一致するイベントは、縦棒としてグラフに重なります。以下の例は、service:web-store を使用します。

タグを使用してダッシュボードでイベントオーバーレイを追加

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

ダッシュボードテンプレート変数

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

タグが追加されていない時系列グラフエディター

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

'region:us-east-1' タグでフィルタリングされた時系列グラフエディター

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

'region:us-east-1' でフィルタリングされ、'host' でグループ化された時系列グラフエディター

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

インフラストラクチャー

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

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

ホストマップタグ

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

コンテナマップタグ

以下は、インフラストラクチャーリストページのフィルターおよびグループ化用テキストボックスです。

インフラストラクチャーリストにあるタグ

以下は、ライブコンテナページのフィルターおよびグループ化用テキストボックスです。

ライブコンテナタグ

以下は、ライブプロセスページのフィルターおよびグループ化用テキストボックスです。

ライブプロセスタグ

モニター

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

検索バーのモニターをタグでフィルター

: モニタータグは、メトリクスタグとは異なり、独立しています。詳しくは、モニタータグのドキュメントをご覧ください。

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

  • これらのタグがあるメトリクスのみにモニター範囲を制限する from テキストボックス。
  • 対応するメトリクスをモニター範囲から削除する excluding テキストボックス。
  • 各タグ値に対するマルチアラートモニターに変換する avg by テキストボックス。

メトリクス

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

個々のタグにスコープされたメトリクスグラフ

インテグレーション

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

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.*

ラベルの作成と管理については、Google Cloud のドキュメントを参照してください。

APM

トレースエクスプローラーでは、検索バーやファセットチェックボックスを使用して、タグでトレースをフィルターすることができます。検索バーのフォーマットは <KEY>:<VALUE> で、例えば service:coffee-house のようになります。高度な検索については、クエリ構文を参照してください。

トレースエクスプローラータグ

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

サービスマップタグ

ノートブック

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

ノートブックタグ

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

Logs

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

Additionally, tags are used to filter a logs Pipeline. For example, if you only want logs from the coffee-house service to go through the pipeline, add the tag service:coffee-house to the filter field.

RUM & セッションリプレイ

RUM エクスプローラーは、環境から指定された期間内のイベントを視覚化します。

RUM のイベントデータをタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE> で、例えば service:shopist のようになります。詳細な検索については、RUM イベントを検索するを参照してください。

RUM タグ

Synthetics

Synthetic Tests ページでは、Synthetic テストの一覧が表示されます。

テストをタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE> で、例えば tag:mini-website のようになります。詳細な検索については、Synthetic テストの検索と管理を参照してください。

Synthetics タグ

Synthetic Monitoring & Testing Results Explorer は、CI パイプライン内でのテスト実行や実行のバッチを表示します。

テスト実行をタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE> で、例えば @ci.provider.name:github のようになります。詳細な検索については、テストバッチを検索するを参照してください。

Synthetics と CI タグ

サービスレベル目標

割り当てられたタグによって SLO を絞り込むには、検索バーかファセットのチェックボックスを使用します。検索バーの形式は、<KEY>:<VALUE>です (例: journey:add_item)。特定のタグを持つ SLO を検索から除外するには、- を使用します (例: -journey:add_item)。

SLO タグ

SLO タグは、SLO の基礎となるメトリクスまたはモニターで使用されるメトリクスまたはモニタータグとは異なる別のものです。

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

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

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

モニターベースの SLO タグ

CI Visibility

CI Visibility Explorer は、CI パイプラインで実行されているテストランを表示します。

テストランをタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE> で、例えば @test.status:failed のようになります。詳細な検索については、CI テストの検索と管理を参照してください。

CI Visibility Explorer のテストラン

CI Visibility Explorer は、CI パイプラインの実行を表示します。

パイプライン実行をタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE> で、例えば @ci.provider.name:gitlab のようになります。詳細な検索については、CI パイプラインの検索と管理を参照してください。

CI Visibility Explorer のパイプライン実行

開発者

タグは API でさまざまな使い方ができます。

各セクションへのリンクはこのリストをご覧ください。

その他の参考資料