기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

구조화된 JSON 엔드포인트를 사용하여 로그 전송(구조화된 JSON 로그)

구조화된 JSON 로그 엔드포인트(/ingest/json)는 단일 JSON 객체 또는 객체의 JSON 배열인 표준 JSON을 허용합니다. 이 엔드포인트는 각 이벤트가 JSON 객체인 구조화된 로그 데이터를 위해 설계되었습니다.

보유자 토큰 인증을 사용하는 경우 계속하기 보유자 토큰 인증 설정 전에의 설정 단계를 완료합니다.

요청 형식

application/json 만 Content-Type으로 허용됩니다.

단일 JSON 객체:

{"timestamp":1771007942000,"message":"single event","level":"INFO"}

객체의 JSON 배열:

[
  {"timestamp":1771007942000,"message":"event one","level":"INFO"},
  {"timestamp":1771007943000,"message":"event two","level":"ERROR"}
]

허용되는 JSON 값 유형

이 엔드포인트는 엄격합니다. JSON 객체만 이벤트로 허용됩니다.

예 - 혼합 유형이 있는 배열:

[
  {"timestamp":1771007942000,"message":"valid object"},
  "just a string",
  42,
  {"timestamp":1771007943000,"message":"another valid object"}
]

결과: 수집된 이벤트 2개(객체), 건너뛴 이벤트 2개(문자열 및 숫자).

타임스탬프 필드

"timestamp" 필드는 NDJSON 엔드포인트와 동일한 에포크 밀리초 단위입니다.

요청 예제

curl -X POST "https://logs.<region>.amazonaws.com/ingest/json?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '[{"timestamp":1771007942000,"message":"User logged in","user_id":"u-123"},{"timestamp":1771007943000,"message":"Order placed","order_id":"o-456"}]'

응답

성공(모든 이벤트 수락됨):

HTTP 200 OK
{}

부분 성공(일부 이벤트가 거부됨):

{
  "partialSuccess": {
    "rejectedLogRecords": 5,
    "errorMessage": "{\"tooOldLogEventCount\": 3, \"tooNewLogEventCount\": 1, \"expiredLogEventCount\": 1}"
  }
}

rejectedLogRecords 필드는 거부된 총 이벤트 수입니다. errorMessage 필드에는 거부 이유별 JSON 인코딩 분류가 포함되어 있습니다.

모범 사례

이벤트 일괄 처리

성능 및 효율성 향상을 위해:

오류 처리

애플리케이션에서 적절한 오류 처리를 구현합니다. 일반적인 HTTP 상태 코드:

제한 사항