Syslog 대상

문서 > Observability Pipelines > 대상 > Syslog 대상

이용 가능:

로그

개요

Observability Pipelines의 syslog 대상을 사용하여 rsyslog 또는 syslog-ng로 로그를 전송합니다.

참고: rsyslog 및 syslog-ng 대상은 RFC5424 형식을 지원합니다.

설정

시크릿 관리: syslog 엔드포인트 URL에 대한 식별자와 해당하는 경우 키 암호만 입력하십시오. 실제 값은 입력하지 마세요.

파이프라인을 설정할 때 rsyslog 또는 syslog-ng 대상을 구성하십시오. 파이프라인은 UI, API 또는 Terraform을 사용하여 설정할 수 있습니다. 이 섹션에서 설명하는 단계는 UI에서 설정합니다.

파이프라인 UI에서 rsyslog 또는 syslog-ng 대상을 선택한 후, 엔드포인트 URL에 대한 식별자를 입력하십시오. 비워두면 기본값이 사용됩니다.

필드가 매핑되는 방법에 대한 자세한 내용은 로그 필드를 syslog 필드에 매핑을 참조하십시오.

If you enter secret identifiers and then choose to use environment variables, the environment variable is the identifier entered and prepended with DD_OP_. For example, if you entered PASSWORD_1 for a password identifier, the environment variable for that password is DD_OP_PASSWORD_1.

선택적 설정

TLS 활성화

Toggle the switch to Enable TLS.

If you are using Secrets Management, enter the identifier for the key pass. See Secret defaults for the default used if the field is left blank.
Enter the following certificate and key files:
- Server Certificate Path: The path to the certificate file that has been signed by your Certificate Authority (CA) root file in DER, PEM, or CRT (X.509).
- (Optional) CA Certificate Path: The path to the certificate file that is your Certificate Authority (CA) root file in DER, PEM, or CRT (X.509).
- (Optional) Private Key Path: The path to the .key private key file that belongs to your Server Certificate Path in DER, PEM, or CRT (PKCS #8) format.
- Notes:
  - The configuration data directory /var/lib/observability-pipelines-worker/config/ is automatically appended to the file paths. See Advanced Worker Configurations for more information.
  - The file must be readable by the observability-pipelines-worker group and user.

TCP keepalive 프로브 대기 시간

유휴 연결에서 TCP keepalive 프로브를 보내기 전에 대기할 시간(초)을 입력하십시오.

버퍼링

Toggle the switch to enable Buffering Options. Enable a configurable buffer on your destination to ensure intermittent latency or an outage at the destination doesn’t create immediate backpressure, and allow events to continue to be ingested from your source. Disk buffers can also increase pipeline durability by writing data to disk, ensuring buffered data persists through a Worker restart. See Destination buffers for more information.

If left unconfigured, your destination uses a memory buffer with a capacity of 500 events.
To configure a buffer on your destination:
1. Select the buffer type you want to set (Memory or Disk).
2. Enter the buffer size and select the unit.
  1. Maximum memory buffer size is 128 GB.
  2. Maximum disk buffer size is 5 TB.
    - Note: For Worker versions 2.20.x and older, the maximum disk buffer size is 500 GB.
3. In the Behavior on full buffer dropdown menu, select whether you want to block events or drop new events when the buffer is full.

로그 필드를 syslog 필드에 매핑

rsyslog 및 syslog-ng 대상은 이러한 로그 필드를 다음 syslog 필드에 매핑합니다:

로그 이벤트	SYSLOG 필드	기본값
log[“message”]	MESSAGE	`NIL`
log["procid"]	PROCID	실행 중인 Worker의 프로세스 ID입니다.
log[“appname”]	APP-NAME	`observability_pipelines`
log["facility"]	FACILITY	`8 (log_user)`
log[“msgid”]	MSGID	`NIL`
log[“severity”]	SEVERITY	`info`
log[“host”]	HOSTNAME	`NIL`
log["timestamp"]	TIMESTAMP	현재 UTC 시간입니다.

시크릿 기본값

These are the defaults used for secret identifiers and environment variables.

rsyslog 또는 syslog-ng 엔드포인트 URL 식별자:
- Observability Pipelines Worker가 로그를 전송할 주소 및 포트를 참조합니다. 예를 들어, 127.0.0.1:9997입니다.
- 기본 식별자는 DESTINATION_SYSLOG_ENDPOINT_URL입니다.
rsyslog 또는 syslog-ng TLS 암호 식별자(TLS가 활성화된 경우):
- 기본 식별자는 DESTINATION_SYSLOG_KEY_PASS입니다.

The rsyslog or syslog-ng endpoint URL. For example, 127.0.0.1:9997.
- The Observability Pipelines Worker sends logs to this address and port.
- The default environment variable is DD_OP_DESTINATION_SYSLOG_ENDPOINT_URL.
The ryslog or syslog-ng TLS passphrase (when enabled):
- The default environment variable is DD_OP_DESTINATION_SYSLOG_KEY_PASS.

대상 작동 방식

이벤트 배치 처리

rsyslog 및 syslog-ng 대상은 이벤트를 일괄 처리하지 않습니다.