高度なフィルタリング

概要

メトリクスエクスプローラー、モニター、またはダッシュボードを使用してメトリクスデータをクエリする場合、データをフィルタリングして、返される時系列のスコープを絞り込むことができます。メトリクスの右側にある from フィールドを使用して、任意のメトリクスをタグでフィルタリングできます。

また、ブール値またはワイルドカードのタグ値フィルターを使用して、高度なフィルタリングを実行することもできます。ログ、トレース、ネットワーク・モニタリング、リアルユーザーモニタリング、Synthetics、セキュリティなど、メトリクスデータ以外のクエリについては、ログ検索構文ドキュメントを参照して、構成してください。

ブールでフィルタリングされたクエリ

次の構文は、ブールでフィルタリングされたメトリクスクエリでサポートされています。

  • !
  • ,
  • NOT, not
  • AND, and
  • OR, or
  • IN, in
  • NOT IN, not in

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

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

タグの詳細については、タグの使い方の概要をご覧ください。

注: 記号のブール構文 (!、,) は、機能的な構文演算子 (NOT、AND、OR、IN、NOT IN) と一緒に使用できません。以下のクエリは 無効 とみなされます。 avg:mymetric{env:prod AND !region:us-east}

ブールでフィルタリングされたクエリの例

以下の例を使用するには、コードアイコン </> をクリックして UI にクエリエディターを表示し、クエリ例をコピーしてクエリエディターに貼り付けてください。

avg:system.cpu.user{env:staging AND (availability-zone:us-east-1a OR availability-zone:us-east-1c)} by {availability-zone}

avg:system.cpu.user{env:shop.ist AND availability-zone IN (us-east-1a, us-east-1b, us-east4-b)} by {availability-zone}
ブール値の例 AND IN
avg:system.cpu.user{env:prod AND location NOT IN (atlanta,seattle,las-vegas)}
ブール値の例 NOT IN

ワイルドカードでフィルタリングされたクエリ

タグ値のプレフィックスとサフィックスのワイルドカードマッチングがサポートされています。

  • pod_name: web-*
  • cluster:*-trace

注: 同じフィルターでのプレフィックスとサフィックスのワイルドカードマッチングはサポートされていません。

ワイルドカードでフィルタリングされたクエリの例

avg:system.disk.in_use{!device:/dev/loop*} by {device}
サフィックスとして使用されるワイルドカード
sum:kubernetes.pods.running{service:*-canary} by {service}
プレフィックスとして使用されるワイルドカード

除外関数

クエリに除外関数を追加することで、

  • N/A 値を除外します。
  • しきい値を満たしたメトリクスに、最小値または最大値を適用します。
  • しきい値以上または以下の値を除外します。

関数は Datadog からデータポイントを削除しませんが、可視化からデータポイントを削除します。

その他の参考資料

お役に立つドキュメント、リンクや記事:

メトリクスエクスプローラーDOCUMENTATION more more メトリクスの概要DOCUMENTATION more more ディストリビューションメトリクスDOCUMENTATION more more ログクエリーフィルターと検索構文ドキュメント more more 除外関数DOCUMENTATION more more