【datadog】datadog ~ 属性/ファセット/属性検索@ ~

◾️はじめに

https://dk521123.hatenablog.com/entry/2025/02/25/151542

で、ようやく datadog の「@」の意味が理解し始めてきたので
知識の整理としてメモっておく
それと、その周辺の「属性」と「ファセット」に関してもまとめておく

目次

【1】属性(Attributes)
 1)予約済み属性(Reserved attributes)
 2)標準属性(Standard attributes)
 3)タグとの差異
【2】ファセット(Facet)
 1)ファセットで可能になる事象例
 2)ファセットの登録
【3】属性検索@ (Attributes search)

【1】属性(Attributes)

* ログ選択時に表示される json 項目(Key)のこと

https://docs.datadoghq.com/ja/logs/log_configuration/attributes_naming_convention/

# この場合、「host」が属性
host: xxxxx

1)予約済み属性(Reserved attributes)

* host など datadog で予め定義されている属性。
 => 詳細は、以下の公式ドキュメントを参照

https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#reserved-attributes

属性 説明
host 送信元ホスト名
source ログ生成元(e.g. nginx、postgresql
status ログのレベル/セキュリティ
service ログイベントを生成するアプリケーション/サービス名
trace_id トレース ID。ログとそのトレースを関連付けるために使用
message デフォルトでは、message 属性の値はログエントリの本文

2)標準属性(Standard attributes)

 * アプリ全体で使える属性を定義可能

確認方法

[1] datadog にログイン
[2] [Logs]-[Pipelines]-[Standard Attributes] を選択
 => ここで、一覧として表示されている

デフォルト標準属性リスト

* 以下の公式ドキュメントを参照

https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#default-standard-attribute-list

3)タグとの差異

* 以下の関連記事を参照のこと

datadog ~ タグ ~
https://dk521123.hatenablog.com/entry/2025/02/27/002502

【2】ファセット(Facet)

* ログやイベントの特定のフィールドを「検索・フィルター・集計できる」ようにしたもの
 => 対象タグ/対象属性に対して、
  以下「1)ファセットで可能になる事象例」を付与するデータセット

cf. facet = 面, 切り口, 要素

* なお、以下の公式ドキュメントでは

https://docs.datadoghq.com/ja/logs/explorer/facets/

のように説明されている
〜〜〜
* インデックス付きログのユーザー定義のタグと属性のこと
〜〜〜

補足:インデックス化されたログ とは?

* 分析、アラート、トラブルシューティングのために収集、処理、保持されているログのこと

1)ファセットで可能になる事象例

[1] ログに入っている値をチェックボックスとして一覧やその件数を表示
[2] ログ検索・フィルタ処理 
[3] ログパターンを定義する
[4] ログ分析を実行する

などなど

2)ファセットの登録

* 以下の関連記事の「3)ファセットの登録」周辺を参照のこと

datadog Logs ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2025/02/14/200308

【3】属性検索@ (Attributes search)

# やっと本題、、、

* ファセットを定義せずに、特定の属性を検索する方法で @ を付ける

# 属性名が url で、url の値 www.datadoghq.com で絞り込む場合

@url:www.datadoghq.com

参考文献

https://qiita.com/14kw/items/f489cdea3de0a34d847b

関連記事

datadog ~ 基礎知識編 ~
https://dk521123.hatenablog.com/entry/2024/03/30/004746
datadog ~ タグ ~
https://dk521123.hatenablog.com/entry/2025/02/27/002502
datadog pipeline ~ 基礎知識編 ~
https://dk521123.hatenablog.com/entry/2025/04/14/145556
datadog dashboard ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2025/02/09/000106
datadog dashboard ~ 基本編 ~
https://dk521123.hatenablog.com/entry/2025/02/17/184724
datadog dashboard ~ あれこれ編 ~
https://dk521123.hatenablog.com/entry/2025/02/19/220516
datadog dashboard ~ Filtering ~
https://dk521123.hatenablog.com/entry/2025/02/25/151542
datadog Logs ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2025/02/14/200308
datadog Logs ~ 基本編 ~
https://dk521123.hatenablog.com/entry/2025/02/15/213417
datadog Alert ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2025/02/16/232413