본문 바로가기
WIKI 기술 지식 베이스

로그 메시지 리매퍼 (Log Message Remapper)

원문 보기 위키 갱신

message는 Datadog에서 핵심 속성이에요. 그 값은 로그에 대한 컨텍스트를 제공하기 위해 Log Explorer의 Content 열에 표시돼요. 검색 바를 사용해 로그 메시지로 로그를 찾을 수 있어요.

출처: 문서

본문

로그 메시지 리매퍼 프로세서를 사용해 하나 이상의 속성을 공식 로그 메시지로 정의하세요. 속성이 존재하지 않을 수 있고 대안이 있는 경우를 위해 둘 이상의 속성을 정의하세요. 예를 들어 정의된 메시지 속성이 attribute1, attribute2, attribute3이고 attribute1이 존재하지 않으면 attribute2가 사용돼요. 마찬가지로 attribute2가 존재하지 않으면 attribute3이 사용돼요.

메시지 속성을 정의하려면 먼저 string builder 프로세서를 사용해 사용하려는 각 속성에 대해 새 문자열 속성을 만드세요. 그런 다음 로그 메시지 리매퍼를 사용해 문자열 속성을 메시지로 리매핑하세요.

참고: 파이프라인 내에서 주어진 로그에 여러 로그 메시지 리매퍼 프로세서가 적용되면 (파이프라인 순서에 따라) 첫 번째 프로세서만 적용됩니다.

사용 사례 (Use cases)

메시지 리매퍼는 로그 이벤트의 공식 메시지를 변경하는 데 사용돼요. 예를 들어 Okta 로그의 경우 메시지 리매퍼를 사용해 displayMessage를 로그의 공식 메시지로 매핑하세요.

API

다음 로그 메시지 리매퍼 JSON 페이로드와 함께 Datadog Log Pipeline API 엔드포인트를 사용하세요:

{
  "type": "message-remapper",
  "name": "Define <SOURCE_ATTRIBUTE> as the official message of the log",
  "is_enabled": true,
  "sources": ["msg"]
}
매개변수 타입 필수 설명
type String 예 프로세서의 타입.
name String 아니오 프로세서의 이름.
is_enabled Boolean 아니오 프로세서가 활성화되었는지 여부. 기본값: false.
sources Array of strings 예 소스 속성 배열. 기본값: msg.

더 알아보기 (Learn more)