コンテンツにスキップ

同一組織内の Trace クエリ¶

POST /api/v1/df/same_org/trace/query

概要¶

traceId を使用して、現在のワークスペースまたは同一組織内の指定ワークスペースの分散型トレーシングデータをクエリします。

Body リクエストパラメータ¶

パラメータ名	型	必須	説明
traceId	string	Y	トレース ID、最大長 512 空欄許可: False
workspaceUUIDs	array		オプション。同一組織内のワークスペース UUID リストを指定します。単一 UUID の最大長は 128。未指定または空配列の場合は現在のワークスペースでクエリします。空欄許可: True
startTime	integer		オプション。クエリ開始時刻。13 桁のミリ秒タイムスタンプ。空欄許可: True
endTime	integer		オプション。クエリ終了時刻。13 桁のミリ秒タイムスタンプ。未指定の場合は終了時刻が自動補完されません。空欄許可: True
source	string		オプション。tracing source。未指定の場合はすべての source をクエリします。具体的な source 名または `*` のみサポート。最大長 128。空欄許可: True
whereClause	string		オプション。追加の DQL where 条件フラグメント。最大長 4096。外側の波括弧は含みません。サーバー側でパーサーによる検証が行われます。空欄許可: True
limit	integer		オプション。返却件数の制限。未指定の場合は DQL のデフォルトページサイズが使用されます。明示的に指定した場合のデフォルトは最大 1000 で、サイト設定に依存します。空欄許可: True
searchAfter	array		オプション。旧ページネーション互換フィールド。Doris クエリではこのフィールドは使用されません。`__docid` に基づいて独自に構築しないでください。空欄許可: True
cursorTime	integer		オプション。スクロールページネーションのカーソル。初回クエリでは 13 桁のミリ秒タイムスタンプを使用できます。以降はレスポンス内の 16 桁マイクロ秒の `next_cursor_time` をそのまま渡してください。空欄許可: True
cursorToken	string		オプション。レスポンス内の `next_cursor_token` をそのまま渡します。レスポンスが空の場合は省略するか空文字列を渡します。最大長 512。空欄許可: True

パラメータ補足説明¶

本インターフェースは trace クエリ専用です。汎用 DQL q はサポートしていません。

パラメータ名	type	必須	説明
traceId	string	Y	トレース ID
workspaceUUIDs	array		同一組織内のワークスペース UUID リスト。単一 UUID の最大長は 128。未指定または空配列の場合は現在のワークスペースでクエリします。
startTime	integer		クエリ開始時刻。未指定の場合はデフォルトで直近 1 時間の開始時刻。
endTime	integer		クエリ終了時刻。未指定の場合は内部の time_range が開始時刻のみを含みます。
source	string		tracing source。未指定の場合はすべての source をクエリします。具体的な source 名または `*` のみサポート。最大長 128。
whereClause	string		追加の DQL where 条件フラグメント。最大長 4096。外側の波括弧は含みません。サーバー側でパーサーによる検証が行われます。
limit	integer		返却件数の制限。未指定の場合は DQL のデフォルトページサイズが使用されます。明示的に指定した場合のデフォルトは最大 1000 で、サイト設定に依存します。
searchAfter	array		旧ページネーション互換フィールド。Doris クエリではこのフィールドは使用されません。`__docid` に基づいて独自に構築しないでください。
cursorTime	integer		スクロールページネーションのカーソル。初回クエリでは 13 桁のミリ秒タイムスタンプを使用できます。以降はレスポンス内の 16 桁マイクロ秒の `next_cursor_time` をそのまま渡してください。
cursorToken	string		レスポンス内の `next_cursor_token` をそのまま渡します。レスポンスが空の場合は省略するか空文字列を渡します。最大長 512。

OpenAPI パラメータはローワーキャメルケースを維持します。selectClause および offset はサポートしていません。ページネーションは cursorTime / cursorToken を使用してください。next_cursor_time が 0 未満になった時点で終了です。

レスポンス¶

{
    "code": 200,
    "content": {
        "data": [
            {
                "series": [
                    {
                        "columns": [
                            "trace_id",
                            "service"
                        ],
                        "values": [
                            [
                                "TRACE-XXXX",
                                "api"
                            ]
                        ]
                    }
                ],
                "next_cursor_time": 1772519730000123,
                "next_cursor_token": ""
            }
        ]
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}