타 시스템 로그 조회

개요

API version

2025-02-19

• 최초 등록
• Request Body 수정

용도 및 설명

타 시스템 로그 조회 API

Request

URI

Methods	URL
POST	/v1/siems/externalSearch

URI Parameters

Name	Type	필수	Description

Request Body

Name	Type	필수	Description
size	int	true	검색 결과중 가져올 목록 수
from	json	true	로그 조회 시작 기간(type은 timestamp), 아래 샘플 데이터 참고
to	json	true	로그 조회 종료 기간(type은 timestamp), 아래 샘플 데이터 참고
sort	array	true	정렬 조건 배열
pagination_key	array	false	페이징 기준값을 지정하는 배열(응답 결과의 sort 값을 그대로 사용)
license	string	true	검색대상 라이선스

Response

성공 HTTP Status Code 200 Body (JSON 형식)

Name	Type	Description
code	int	0
msg	string
total	int	검색 전체수
items	json array	조건을 만족하는 통합로그에 등록된 목록 (json)

실패 HTTP Status Code

HTTP status code	HTTP 메시지	설명
400	Bad Request	요청 정보 오류
401	Unauthorized	권한 없음
403	Forbidden
404	Not Found
429	Request limit exceeded	요청 제한 초과
500	Internal Server Error	예외발생
61001	fail to search	검색 실패
61002	Referer does not match system domain	Referer와 SystemDomain 불일치
61003	JSON conversion error	JSON 변환 오류

Example

요청

POST /v1/siems/externalSearch
Content-Type: application/json; charset=utf-8

{
    "size": 10,
    "from": 1735653652984,
    "to": 1747357192199,
    "sort": [
        {
            "time": "desc"
        },
        {
            "_id": "asc"
        }
    ],
    "license": "HWIX-1DGC0-MKQ6-B2HAF"
}

페이징 추가 요청

POST /v1/siems/externalSearch
Content-Type: application/json; charset=utf-8

{
    "size": 10,
    "from": 1735653652984,
    "to": 1747357192199,
    "sort": [
        {
            "time": "desc"
        },
        {
            "_id": "asc"
        }
    ],
    "pagination_key": [
        1747357192199,
        "6263DE9F46D0FD2D19A2ABB6C02630A72349BB6AD10F47C0C42F7BA43D5106DE"
    ],
    "license": "HWIX-1DGC0-MKQ6-B2HAF"
}

응답

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "code": 0,
    "msg": "",
    "total": 5642617,
    "items": [
        {
            "traceId": "4afc75c4-e805-40d1-88e5-ef65dc8bb9dd",
            "time": 1747357192199,
            "ip": "127.0.0.1",
            "userId": "backend",
            "logLevel": "INFO",
            "logType": "APP",
            "brandName": "InfoLineage",
            "serviceName": "InfoLineage",
            "tenantId": "3CJ55MSE-xLO7Sxt4-qUBKzbcs-XP2cgGEq",
            "target": "log_archive_20250511_20250515.zip",
            "event": "LOG_ARCHIVE_CREATE",
            "description": "",
            "detail": "",
            "corp": {
                "id": "3CJ55MSE-xLO7Sxt4-qUBKzbcs-XP2cgGEq"
            },
            "user": {},
            "file": {},
            "folder": {},
            "device": {},
            "process": {},
            "source": {},
            "branch": {},
            "drmDoc": null,
            "policy": null,
            "storage": null,
            "urlFile": null,
            "edgeServer": null,
            "workSystem": null,
            "serviceId": "7325bbd0-9d1f-4f6d-8b0a-b7d97188d4bd",
            "serviceHostname": "",
            "crc32": 4265737200,
            "sort": [
                1747357192199,
                "6263DE9F46D0FD2D19A2ABB6C02630A72349BB6AD10F47C0C42F7BA43D5106DE"
            ],
            "detail6000": null,
            "category": 0
        }
    ]
}