CI Visibility の取り込み制御

Docs > Continuous Integration Visibility > CI Visibility ガイド > CI Visibility の取り込み制御

概要

除外フィルターは、特定のイベントを Datadog の処理対象から除外する条件を 1 つ以上定義することで、CI Visibility の予算をきめ細かく制御することができます。

互換性

Pipeline Visibility にフィルターが用意されています。

除外フィルターを追加する

Pipeline Visibility の設定に除外フィルターは必須ではありません。デフォルトでは、すべてのデータが取り込まれ処理されます。

組織用のフィルターを作成するには、ユーザーアカウントに ci_ingestion_control_write 権限が必要です。

Datadog で、CI > Settings > Ingestion Settings に移動します。
Add an Exclusion Filter を選択。

フィルターに名前を付けて、クエリを定義します。クエリを定義すると、入力フィールドの上にあるプレビューに、クエリに一致する取り込みデータが表示されます。フィルターが作成され、有効になると、プレビューに表示されているようなイベントは取り込みの対象から除外されます。

フィルターを追加すると、このページの各行に以下が表示されます。

Filter name - フィルター名
Exclusion query - そのフィルターに定義されていたクエリ
フィルターの有効・無効を切り替える - 新規に作成されたフィルターは、デフォルトでオンに設定されています

1 つ以上のフィルターに一致するすべてのスパンは、Datadog によって取り込まれることも処理されることもありません。

除外フィルターのクエリを定義する

フィルターは、クエリエディターインターフェイスで柔軟に定義することができます。タグや属性に頼って、フィルターを作成します。

除外フィルターの例

以下は、除外フィルターが CI Visibility の使用と請求を最適化するのに役立つ例です。

git author のメールアドレスでフィルターする

git author のメールアドレス (@git.commit.author.email) をフィルターとして定義することで、特定のコミッターを監視対象から除外することができます。以下のスクリーンショットは、この特定の git author のメールアドレスからのコミットに関連するすべてのスパンを取り込まないようにするフィルターを示しています。

git author のメールドメインでフィルターする

また、メールアドレスドメインによって一度に多くのコミッターを除外することもできます (例えば、監視対象のリポジトリにコミットする外部の貢献者を除外したい場合など)。以下のスクリーンショットは、クエリに含まれるメールアドレスドメインと一致しないメールアドレスドメインからのコミットに関連するすべてのスパンを取り込まないようにするフィルターを示しています。

リポジトリによるフィルター

リポジトリ名 (@git.repository.name) または ID (@git.repository.id) でフィルターを定義することで、特定のリポジトリを監視対象から除外することができます (たとえば、内部のテスト用リポジトリなど)。以下のスクリーンショットは、このリポジトリへのコミットに関連するすべてのスパンを取り込まないようにするフィルターを示しています。