콘텐츠로 이동

동일 조직 Trace 조회¶

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

개요¶

traceId를 기준으로 현재 워크스페이스 또는 동일 조직 내 지정된 워크스페이스의 tracing 데이터를 조회합니다.

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"
}