- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
除外フィルターは、特定のイベントを Datadog の処理対象から除外する条件を 1 つ以上定義することで、CI Visibility の予算をきめ細かく制御することができます。
Pipeline Visibility にフィルターが用意されています。
Pipeline Visibility の設定に除外フィルターは必須ではありません。デフォルトでは、すべてのデータが取り込まれ処理されます。
組織用のフィルターを作成するには、ユーザーアカウントに ci_ingestion_control_write
権限が必要です。
フィルターを追加すると、このページの各行に以下が表示されます。
1 つ以上のフィルターに一致するすべてのスパンは、Datadog によって取り込まれることも処理されることもありません。
フィルターは、クエリエディターインターフェイスで柔軟に定義することができます。タグや属性に頼って、フィルターを作成します。
以下は、除外フィルターが CI Visibility の使用と請求を最適化するのに役立つ例です。
git author のメールアドレス (@git.commit.author.email
) をフィルターとして定義することで、特定のコミッターを監視対象から除外することができます。以下のスクリーンショットは、この特定の git author のメールアドレスからのコミットに関連するすべてのスパンを取り込まないようにするフィルターを示しています。
また、メールアドレスドメインによって一度に多くのコミッターを除外することもできます (例えば、監視対象のリポジトリにコミットする外部の貢献者を除外したい場合など)。以下のスクリーンショットは、クエリに含まれるメールアドレスドメインと一致しないメールアドレスドメインからのコミットに関連するすべてのスパンを取り込まないようにするフィルターを示しています。
リポジトリ名 (@git.repository.name
) または ID (@git.repository.id
) でフィルターを定義することで、特定のリポジトリを監視対象から除外することができます (たとえば、内部のテスト用リポジトリなど)。以下のスクリーンショットは、このリポジトリへのコミットに関連するすべてのスパンを取り込まないようにするフィルターを示しています。
除外フィルターは、ci_ingestion_control_write
権限を持つユーザーによって有効/無効、更新、削除することができます。これらは組織レベルで適用されます。Datadog 監査証跡を使用すると、誰が除外フィルターを変更したかの詳細情報を見ることができます。
各フィルターの右側にあるトグルで、いつでもフィルターの有効・無効を切り替えることができます。新規に作成されたフィルターは、デフォルトでオンになっています。
注: ほとんどの場合、フィルターは有効化されてから 1 秒以内 (p95) に取り込みデータに適用されます。ただし、有効化されたフィルターが有効になるまでに数分かかる場合もあります。
フィルター名の変更や除外フィルターのクエリーの変更は、Ingestion Settings ページ内でいつでも行うことができます。
削除アイコンをクリックすることで、フィルターを削除することができます。
お役に立つドキュメント、リンクや記事: