Syslog 로깅 드라이버

Syslog 로깅 드라이버 (Syslog logging driver)

syslog 로깅 드라이버는 로그를 syslog 서버로 라우팅해요. syslog 프로토콜은 로그 메시지로 원시 문자열을 사용하고 제한된 메타데이터 집합을 지원해요. syslog 메시지는 유효하려면 특정 방식으로 형식화되어야 해요. 유효한 메시지에서 수신자는 다음 정보를 추출할 수 있어요:

• Priority: debug, warning, error, info 같은 로깅 수준.
• Timestamp: 이벤트가 발생한 시점.
• Hostname: 이벤트가 발생한 위치.
• Facility: mail 또는 kernel 같은 메시지를 기록한 하위 시스템.
• Process name and process ID (PID): 로그를 생성한 프로세스의 이름과 ID.

형식은 RFC 5424에 정의되어 있고 Docker의 syslog 드라이버는 ABNF reference를 다음과 같이 구현해요:

                TIMESTAMP SP HOSTNAME SP APP-NAME SP PROCID SP MSGID
                    +          +             +           |        +
                    |          |             |           |        |
                    |          |             |           |        |
       +------------+          +----+        |           +----+   +---------+
       v                            v        v                v             v
2017-04-01T17:41:05.616647+08:00 a.vm {taskid:aa,version:} 1787791 {taskid:aa,version:}

출처: 문서

본문

사용법 (Usage)

syslog 드라이버를 기본 로깅 드라이버로 사용하려면 daemon.json 파일에서 log-driver와 log-opt 키를 적절한 값으로 설정해요. daemon.json으로 Docker를 구성하는 것에 대한 자세한 내용은 daemon.json을 참고하세요.

Note Docker Desktop을 사용한다면 Docker Desktop Dashboard를 통해 데몬 구성을 편집해요. Settings를 열고 Docker Engine을 선택해요. 자세한 내용은 Docker Engine 설정을 참고하세요.

다음 예시는 로그 드라이버를 syslog로 설정하고 syslog-address 옵션을 설정해요. syslog-address 옵션은 UDP와 TCP를 모두 지원해요. 이 예시는 UDP를 사용해요.

{
  "log-driver": "syslog",
  "log-opts": {
    "syslog-address": "udp://1.2.3.4:1111"
  }
}

변경 사항을 적용하려면 Docker를 재시작해요.

Note daemon.json 구성 파일의 log-opts 구성 옵션은 문자열로 제공해야 해요. 따라서 숫자 및 부울 값(syslog-tls-skip-verify 값 등)은 따옴표(")로 감싸야 해요.

docker container create 또는 docker run에 --log-driver 플래그를 사용해 특정 컨테이너의 로깅 드라이버를 설정할 수 있어요:

$ docker run \
      --log-driver syslog --log-opt syslog-address=udp://1.2.3.4:1111 \
      alpine echo hello world

옵션 (Options)

다음 로깅 옵션은 syslog 로깅 드라이버의 옵션으로 지원돼요. daemon.json에서 log-opts JSON 배열에 키-값 쌍으로 추가해 기본값으로 설정할 수 있어요. 또한 컨테이너를 시작할 때 각 옵션에 --log-opt <key>=<value> 플래그를 추가해 주어진 컨테이너에 설정할 수도 있어요.

더 알아보기 (Learn more)

• 로깅 개요
• 로그 태그 옵션
• RFC 5424