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

アクセスログ リファレンス

Plan availability

この機能は Enterprise プラン以上、および BYOC デプロイメントでのみ利用できます。

アクセスログは JSON Lines 形式で配信されます。1 行につき 1 つの JSON オブジェクトです。各行は単一の操作を表す自己完結型の JSON オブジェクトです。次の例は Search 操作のログエントリを示しています。

json
{
    "action": "Search",
    "cluster_id": "inxx-xxxxxxxxxxxxxxx",
    "database": "default",
    "date": "2026/04/14 06:31:16.827 +00:00",
    "interface": "Restful",
    "log_type": "ACCESS",
    "params": {
        "collection": "ccc1",
        "consistency_level": 2,
        "execution_time": "15.368706ms",
        "expr": "",
        "input_params": {
            "anns_field": "",
            "offset": "0",
            "params": "{}",
            "round_decimal": "-1",
            "topk": "10"
        },
        "nq": 1,
        "output_fields": ["*"],
        "partition": null,
        "result_num": 10,
        "result_pks": [55, 19, 18, 10, -26, 115, -14, -96, -50, 9],
        "result_scores": [0.87269604, 0.8639183, 0.8605273, 0.85245466, 0.8490447, 0.84537137, 0.84066796, 0.8314183, 0.8296911, 0.82586515],
        "topk": 10
    },
    "result": 0,
    "status": "Success",
    "timestamp": 1776148276827,
    "trace_id": "f89903d701329910380442aa86941be9",
    "user": "key-ibchakktguxxrvvxseoasz"
}

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

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

フィールド必須型説明例
actionYesstring操作名。対応しているアクションを参照してください。"Search"
cluster_idYesstringクラスターの一意識別子です。"inxx-xxxxxxxxxxxxxxx"
databaseNostring操作が発生したデータベースです。"default"
dateYesstringタイムゾーン付きの人間が読める形式のタイムスタンプです。"2026/04/14 06:31:16.827 +00:00"
interfaceYesstringインターフェースの種類: Restful または Grpc。"Restful"
log_typeYesstringログカテゴリ: ACCESS、AUDIT、または SLOW。"ACCESS"
paramsYesobjectアクション固有のパラメータです。ネストされたフィールドについては以下を参照してください。--
resultYesint操作の結果コードです。0 は成功を示し、0 以外の値はエラーを示します。0
statusYesstring操作の人間が読めるステータスです。"Success"
timestampYesintプロキシがリクエストを受信した時点のミリ秒単位の Unix タイムスタンプ（13 桁）です。1776148276827
trace_idYesstring操作の一意 ID です。同じリクエストに属する複数のログエントリを関連付けるために使用します。"f89903d701329910380442aa86941be9"
userYesstringリクエストを発行したユーザーまたは API キーです。"key-ibchakktguxxrvvxseoasz"

params フィールド​

フィールド必須型説明例
params.collectionNostring対象のコレクションです。Search、HybridSearch、Query アクションでは必須です。"ccc1"
params.consistency_levelNoint操作に使用された整合性レベルです。2
params.execution_timeNostringサーバー側の実行時間です。プロキシが完全なペイロードを受信した時点からレスポンスの送信を開始する時点までを計測します。ネットワーク転送時間は含まれません。"15.368706ms"
params.exprNostring or arrayリクエストとともに渡されるフィルター式です。HybridSearch の場合、これは式の配列です（サブリクエストごとに 1 つ）。"" or [""]
params.input_paramsNoobject操作の入力パラメータ（検索パラメータ、offset、topk など）です。HybridSearch の場合、sub_0.* プレフィックス付きのサブリクエストパラメータと strategy が含まれます。{"topk": "10", "offset": "0"}
params.limitNoint返される結果数の上限です。Query および HybridSearch アクションで表示されます。100
params.nqNointクエリベクトルの数です。Search アクションで表示されます。1
params.output_fieldsNoarrayクエリで要求された出力フィールドです。["*"]
params.partitionNostring指定されている場合の対象パーティションです。パーティションが指定されていない場合は null です。null
params.result_numNoint操作によって実際に返された結果数です。10
params.result_pksNoarrayクエリ結果内の主キーです。出力パラメータがこれを含むように設定されている場合、Search、HybridSearch、Query アクションで表示されます。[55, 19, 18, 10]
params.result_scoresNoarrayparams.result_pks の各エントリに対応する類似度スコアです。Search および HybridSearch アクションで表示されます。[0.87269604, 0.8639183]
params.topkNoint検索リクエストの topk パラメータです。Search および HybridSearch アクションで表示されます。10

対応しているアクション​

このリリースでは、検索またはクエリ系のアクションのみがログに記録されます。

アクション説明
Searchベクトル類似度検索
HybridSearch再ランキング付きのマルチベクトル検索
Queryスカラー フィルタリング クエリ
📘注

追加のアクションのサポートは、今後のリリースで予定されています。

ファイルパスと命名​

ログファイルは、次のパス構造でオブジェクトストレージバケット内に整理されます。

plaintext
/<Cluster ID>/<Log type>/<Date>/<File name><File name suffix>
コンポーネント形式例
Cluster IDクラスターの一意識別子inxx-xxxxxxxxxxxxxxx
Log typeaccess、audit、または slowaccess
DateISO 日付（YYYY-MM-DD）2024-12-20
File nameHH:MM:SS-<UUID>。ここで HH:MM:SS は UTC 時刻、<UUID> は一意性のためのランダムな文字列です09:16:53-jz5l7D8Q
File name suffix.log.log

完全なパスの例:

plaintext
/inxx-xxxxxxxxxxxxxxx/access/2024-12-20/09:16:53-jz5l7D8Q.log
Ctrl I