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

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

プランでの提供状況

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

アクセスログは JSON Lines 形式で配信されます。1 行につき 1 つの JSON オブジェクトです。各行は、1 つの操作を表す自己完結型の 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 行を占めます。以下のセクションでは、各フィールドについて詳しく説明します。

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

フィールド必須型説明例
actionはいstring操作の名前です。サポートされているアクション を参照してください。"Search"
cluster_idはいstringクラスターの一意の識別子です。"inxx-xxxxxxxxxxxxxxx"
databaseいいえstring操作が発生したデータベースです。"default"
dateはいstringタイムゾーン付きの、人間が判読できるタイムスタンプです。"2026/04/14 06:31:16.827 +00:00"
interfaceはいstringインターフェースの種類です。Restful または Grpc のいずれかです。"Restful"
log_typeはいstringログのカテゴリです。ACCESS、AUDIT、SLOW のいずれかです。"ACCESS"
paramsはいobjectアクション固有のパラメーターです。ネストされたフィールドについては、以下 を参照してください。--
resultはいint操作の結果コードです。0 は成功を示し、0 以外の値はエラーを示します。0
statusはいstring操作の、人間が判読できるステータスです。"Success"
timestampはいintプロキシがリクエストを受信した時点の、ミリ秒（13 桁）の Unix タイムスタンプです。1776148276827
trace_idはいstring操作の一意の ID です。同じリクエストに属する複数のログエントリを関連付けるために使用します。"f89903d701329910380442aa86941be9"
userはいstringリクエストを発行したユーザーまたは API キーです。"key-ibchakktguxxrvvxseoasz"

params フィールド​

フィールド必須型説明例
params.collectionいいえstring対象のコレクションです。Search、HybridSearch、Query アクションでは必須です。"ccc1"
params.consistency_levelいいえint操作に使用される整合性レベルです。2
params.execution_timeいいえstringサーバー側の実行時間です。プロキシが完全なペイロードを受信してから応答の送信を開始するまでの時間を計測します。ネットワークの転送時間は含まれません。"15.368706ms"
params.exprいいえstring または arrayリクエストとともに渡されるフィルター式です。HybridSearch の場合は、式の配列です（サブリクエストごとに 1 つ）。"" or [""]
params.input_paramsいいえobject操作の入力パラメーター（検索パラメーター、offset、topk など）です。HybridSearch の場合は、sub_0.* プレフィックスが付いたサブリクエストパラメーターと strategy が含まれます。{"topk": "10", "offset": "0"}
params.limitいいえint返す結果の数の上限です。Query および HybridSearch アクションで表示されます。100
params.nqいいえintクエリベクトルの数です。Search アクションで表示されます。1
params.output_fieldsいいえarrayクエリで要求された出力フィールドです。["*"]
params.partitionいいえstring指定されている場合の対象パーティションです。パーティションが指定されていない場合は null です。null
params.result_numいいえint操作によって返された実際の結果数です。10
params.result_pksいいえarrayクエリ結果のプライマリキーです。含めるように出力パラメーターが構成されている場合に、Search、HybridSearch、Query アクションで表示されます。[55, 19, 18, 10]
params.result_scoresいいえarrayparams.result_pks の各エントリに対応する類似度スコアです。Search および HybridSearch アクションで表示されます。[0.87269604, 0.8639183]
params.topkいいえint検索リクエストの topk パラメーターです。Search および HybridSearch アクションで表示されます。10

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

このリリースでは、検索クラスまたはクエリクラスの操作のみがログに記録されます。

アクション説明
Searchベクトル類似検索
HybridSearchリランキングを伴うマルチベクトル検索
Queryスカラーによるフィルタリングクエリ
Notes

追加のアクションのサポートは、将来のリリースで計画されています。

ファイルパスと命名​

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

plaintext
/<Cluster ID>/<Log type>/<Date>/<File name><File name suffix>
構成要素形式例
クラスター IDクラスターの一意の識別子ですinxx-xxxxxxxxxxxxxxx
ログタイプaccess、audit、slow のいずれかaccess
日付ISO 日付（YYYY-MM-DD）2024-12-20
ファイル名HH:MM:SS-<UUID>（HH:MM:SS は UTC 時刻、<UUID> は一意性のためのランダムな文字列）09:16:53-jz5l7D8Q
ファイル名のサフィックス.log.log

完全なパスの例は以下の通りです。

plaintext
/inxx-xxxxxxxxxxxxxxx/access/2024-12-20/09:16:53-jz5l7D8Q.log
このページは役に立ちましたか？
Ctrl I