[説明] このページは機械翻訳された日本語版です。内容に誤りがございましたら、報告していただけると助かります。

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

Public Preview

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

{
    "action": "Search",
    "cluster_id": "in01-2b8d91fc3a3b93b",
    "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 行を占めます。以下のセクションでは、各フィールドについて詳しく説明します。

Log field schema

Field	Required	Type	Description	Example
action	Yes	string	操作名。Supported actions を参照してください。	"Search"
cluster_id	Yes	string	クラスターの一意の識別子。	"in01-2b8d91fc3a3b93b"
database	No	string	操作が発生したデータベース。	"default"
date	Yes	string	タイムゾーンを含む人間が読みやすいタイムスタンプ。	"2026/04/14 06:31:16.827 +00:00"
interface	Yes	string	インターフェースタイプ：Restful または Grpc。	"Restful"
log_type	Yes	string	ログカテゴリ：ACCESS、AUDIT、または SLOW。	"ACCESS"
params	Yes	object	アクション固有のパラメータ。ネストされたフィールドについては以下を参照してください。	--
result	Yes	int	操作の結果コード。0 は成功を示し、0 以外の値はエラーを示します。	0
status	Yes	string	操作の人間が読みやすいステータス。	"Success"
timestamp	Yes	int	プロキシがリクエストを受信した時点の Unix タイムスタンプ（ミリ秒単位、13 桁）。	1776148276827
trace_id	Yes	string	操作の一意の ID。同じリクエストに属する複数のログエントリを関連付けるために使用します。	"f89903d701329910380442aa86941be9"
user	Yes	string	リクエストを発行したユーザーまたは API キー。	"key-ibchakktguxxrvvxseoasz"

params fields

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

Supported actions

このリリースでは、検索系またはクエリ系のアクションのみをログに記録します：

Action	Description
Search	ベクトル類似度検索
HybridSearch	再ランキング付きマルチベクトル検索
Query	スカラーフィルタリングクエリ

📘Notes

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

File path and naming

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

/<Cluster ID>/<Log type>/<Date>/<File name><File name suffix>

コンポーネント	形式	例
クラスター ID	クラスターの一意の識別子	in03-c7be749d5f403ad
ログタイプ	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

フルパスの例：

/in03-c7be749d5f403ad/access/2024-12-20/09:16:53-jz5l7D8Q.log