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

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

プランでの提供状況

この機能は、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プロキシがリクエストを受信した時点の Unix タイムスタンプ（ミリ秒単位、13 桁）です。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 or 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、または slowaccess
日付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