概要
タグの割り当て後に、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
) が割り当てられたすべてのソースが表示されます。
高度なタグ値のフィルタリングはブールフィルターでも使用できます。次のブール構文がサポートされます。
NOT
, !
AND
, ,
OR
key IN (tag_value1, tag_value2,...)
key NOT IN (tag_value1, tag_value2,...)
AND
、OR
を使用して、特定のタグ全体のメトリクスを確認します。
IN
、NOT IN
を使用して、メトリクスを特定のタグにフィルタリングします。
タグを使用して集計されたグループを作成するには、avg by テキストボックスにタグのキー部分を入力します。たとえば、service:web-store
のようにキー service
でタグ付けされたメトリクスを表示する時系列グラフでは、avg by テキストボックスに service
を入力すると、service
のタグ値ごとに 1 つの行が表示されます。各行は、この service
タグ値を共有するすべてのソースの平均のメトリクス値を表します。
タグを使用して、ダッシュボードでイベントを重ねることもできます。これは、イベントエクスプローラーと同じように機能します。
一致するイベントは、縦棒としてグラフに重なります。以下の例は、service:web-store
を使用します。
ダッシュボードのグラフの from タグの切り替え時間を短縮するには、テンプレート変数を使用します。以下の例では、service
を使用して service
タグキーを表します。テンプレート変数を使用するには、グラフ クエリの from テキストボックスに $service
テンプレート変数を追加します。
以下は、時系列グラフエディターを使用したタグの例です。最初のスクリーンショットでは、タグは適用されていません。すべてのホストでの平均 CPU 使用率が表示されます。
次に、タグ (region:eastus
) を from テキストボックスに含めるようにエディターを更新します。これにより、Datadog は米国東部リージョンでの CPU 使用率を参照できます。この例では region
タグを使用しますが、application
、service
、environment
など、Datadog プラットフォームに送信された任意のタグを使用できます。
最後に、2 番目の空フィールド (avg by テキストボックス) を使用して、各 host
の個別の時系列ラインを表示します。米国東部リージョンで実行されている各ホストのサーバー CPU 使用率が表示されます。
必要に応じて、タグを追加して範囲をさらに絞り込みます。たとえば、region:eastus
や env: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 tag
と to 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 イベントを検索するを参照してください。
Synthetics
Synthetic Tests ページでは、Synthetic テストの一覧が表示されます。
テストをタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE>
で、例えば tag:mini-website
のようになります。詳細な検索については、Synthetic テストの検索と管理を参照してください。
サービスレベル目標
割り当てられたタグによって SLO を絞り込むには、検索バーかファセットのチェックボックスを使用します。検索バーの形式は、<KEY>:<VALUE>
です (例: journey:add_item
)。特定のタグを持つ SLO を検索から除外するには、-
を使用します (例: -journey:add_item
)。
SLO タグは、SLO の基礎となるメトリクスまたはモニターで使用されるメトリクスまたはモニタータグとは異なる別のものです。
メトリクスベースの SLO を作成する場合、SLO の成功率メトリクスクエリでメトリクスタグを使用します(すべてのメトリクスは同じセットのメトリクスタグを使用する必要があります)。
- これらのタグのみにメトリクス範囲を制限する from テキストボックス。
- SLO 全体と各タグ値のステータス割合および残りのエラーバジェットを表示する、グループ化されたメトリクスベースの SLO を作成するための sum by テキストボックス。
単一のグループ化されたモニターを使用してモニターベースの SLO を作成する場合、選択されたグループで計算 トグルを使用して、基底のモニターから最大 20 個のタグ値を選択し、SLO 全体および各タグ値のステータス割合および残りのエラーバジェットを表示します。
CI Visibility
CI Visibility Explorer は、CI パイプラインで実行されているテストランを表示します。
テストランをタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE>
で、例えば @test.status:failed
のようになります。詳細な検索については、CI テストの検索と管理を参照してください。
CI Visibility Explorer は、CI パイプラインの実行を表示します。
パイプライン実行をタグでフィルターするには、検索バーまたはファセットチェックボックスを使用します。検索バーのフォーマットは <KEY>:<VALUE>
で、例えば @ci.provider.name:gitlab
のようになります。詳細な検索については、CI パイプラインの検索と管理を参照してください。
開発者
タグは API でさまざまな使い方ができます。
各セクションへのリンクはこのリストをご覧ください。
その他の参考資料