メインコンテンツまでスキップ

スローログ リファレンス

スローログは JSON Lines 形式で配信されます。1 行につき 1 つの JSON オブジェクトです。各行は単一の操作を表す自己完結型の JSON オブジェクトです。以下の例は、検索リクエストの代表的なスローログエントリを示しています。

json
{
  "action": "Search",
  "cluster_id": "inxx-xxxxxxxxxxxxxxx",
  "collection": "medium_articles",
  "connection_uid": "453798218345292801",
  "consistency_level": "Bounded",
  "database": "default",
  "error_code": 0,
  "execution_time": "231.4ms",
  "interface": "Grpc",
  "ip": "203.0.113.10",
  "log_type": "SLOW",
  "output_fields": ["title", "author"],
  "partition": null,
  "sdk": "pymilvus",
  "sdk_version": "2.6.0",
  "status": "Success",
  "timestamp": 1776148276827,
  "trace_id": "f89903d701329910380442aa86941be9",
  "user": "key-ibchakktguxxrvvxseoasz"
}

実際には、各エントリは .log ファイル内で 1 行を占めます。以下のセクションでは、各フィールドについて詳しく説明します。

ログフィールドスキーマ​

FieldRequiredTypeDescriptionExample
actionNostringQuery、Search、Hybrid Search などの操作名です。"Search"
cluster_idYesstringクラスターの一意識別子です。このフィールドはダウンストリームのログパイプラインで必須です。"inxx-xxxxxxxxxxxxxxx"
collectionNostringアクションがコレクションスコープである場合の対象コレクションです。"medium_articles"
connection_uidNostringリクエストに関連付けられた内部接続識別子です。"453798218345292801"
consistency_levelNostringリクエストで使用された整合性レベルです。"Bounded"
databaseNostring操作が発生したデータベースです。"default"
error_codeNointリクエスト結果コードです。通常、0 は成功を示します。0
execution_timeNostringリクエストをスローログに出力すべきかどうかを判断するために使用される測定済み実行時間です。"231.4ms"
interfaceNostringリクエストインターフェースで、通常は Grpc または Restful です。"Grpc"
ipNostringリクエストについて記録されたクライアント IP アドレスです。"203.0.113.10"
log_typeYesstringログカテゴリです。スローログエントリでは値は SLOW です。"SLOW"
output_fieldsNoarray該当する場合、クエリによって要求された出力フィールドです。["title", "author"]
partitionNostring or null対象パーティションです。パーティションが指定されていない場合、値は null です。null
sdkNostringクライアント SDK 名です。"pymilvus"
sdk_versionNostringクライアント SDK バージョンです。"2.6.0"
statusNostring人が読める形式のリクエストステータスです。"Success"
timestampYesintミリ秒単位の Unix タイムスタンプです。このフィールドは、最終的なファイルパスを生成する際にオブジェクトストレージシンクで必須です。1776148276827
trace_idNostring相関付けとトラブルシューティングのための一意のリクエストトレース識別子です。"f89903d701329910380442aa86941be9"
userYesstringリクエストを発行したユーザー名または API キーです。このフィールドはパイプラインフィルターでも使用されます。"key-ibchakktguxxrvvxseoasz"

サポートされるアクション​

現在のスローログ機能では、デフォルトで次のアクションが有効になっています。

ActionDescription
Searchベクトル類似度検索
HybridSearch再ランキングを伴うマルチベクトル検索
Queryスカラーフィルタリングクエリ

ファイルパスと命名​

スローログファイルは、slow ディレクトリ配下のオブジェクトストレージにアップロードされ、最終的なオブジェクトキーでは UTC の日付と時刻が使用されます。

plaintext
/<Cluster ID>/slow/<Date>/<File name>.log
ComponentFormatExample
Cluster IDクラスターの一意識別子です。inxx-xxxxxxxxxxxxxxx
Log type directoryslow に固定されます。slow
DateYYYY-MM-DD 形式の UTC 日付です。2026-04-14
File nameUTC 時刻を使用する HH:MM:SS-<UUID>.log。06:31:16-jz5l7D8Q.log

完全なパスの例:

plaintext
/inxx-xxxxxxxxxxxxxxx/slow/2026-04-14/06:31:16-jz5l7D8Q.log
Ctrl I