개요

Observability Pipelines의 소켓 소스를 사용하여 소켓 연결(TCP 또는 UDP)을 통해 Worker로 로그를 전송하세요.

전제 조건

If your forwarders are globally configured to enable SSL, you need the appropriate TLS certificates and the password for your private key.

설정

파이프라인을 설정할 때 이 소스를 설정하세요. 파이프라인은 UI, API 또는 Terraform을 사용하여 설정할 수 있습니다. 이 섹션의 지침은 UI에서 소스를 설정하기 위한 것입니다.

참고: Worker는 TCP 또는 UDP를 통해서만 로그를 수신할 수 있습니다. 애플리케이션이 UNIX 도메인 소켓에 쓰는 경우 자세한 내용은 UNIX 도메인 소켓을 참조하세요.

파이프라인 UI에서 소켓 소스를 선택한 후:

1. 소켓 주소에 대한 식별자를 입력하세요. 비워두면 기본값이 사용됩니다.
2. Mode 드롭다운 메뉴에서 사용할 소켓 유형을 선택하세요.
3. Framing 드롭다운 메뉴에서 이벤트 스트림을 구분할 방법을 선택하세요.

   프레이밍 방식	설명
   newline_delimited	바이트 프레임은 줄 바꿈 문자로 구분됩니다.
   bytes	바이트 프레임은 기본 I/O 경계에 따라 그대로 전달됩니다(예: 메시지 또는 스트림 세그먼트 간 분할).
   character_delimited	바이트 프레임은 선택한 문자로 구분됩니다.
   chunked_gelf	바이트 프레임은 청크된 GELF 메시지입니다.
   octet_counting	바이트 프레임은 옥텟 계산 형식에 따라 구분됩니다.

선택 사항 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.

• (Optional) Toggle Verify certificate to require connecting clients to present a valid client certificate. This enforces mutual TLS (mTLS), where the Worker verifies the identity of each connecting client.

UNIX 도메인 소켓

소켓 소스는 TCP 또는 UDP를 통한 로그 수신만 지원합니다. 애플리케이션이 UNIX 도메인 소켓에 쓰는 경우 socat을 사용하여 이를 TCP 또는 UDP 소켓으로 브리지하고 Worker로 로그를 전송하세요.

독립형 브리지

UNIX 소켓에서 Worker로 전달하려면 애플리케이션과 함께 socat을 실행하세요.

socat UNIX-RECV:/var/run/app.sock TCP:<OPW_HOST>

<OPW_HOST>를 Observability Pipelines Worker와 연결된 호스트 IP 주소 또는 로드 밸런서 URL로 바꾸세요.

Kubernetes 사이드카

Kubernetes에서 Observability Pipelines Worker는 일반적으로 서비스 뒤의 StatefulSet으로 실행되므로 localhost를 통해 연결할 수 없습니다. 애플리케이션과 동일한 포드에서 사이드카 컨테이너로 socat을 실행하고 소켓 파일을 위한 볼륨을 공유하세요. 예:

volumes:
  - name: app-socket
    emptyDir: {}

initContainers:
  # Remove any stale socket file before the sidecar starts
  - name: socket-cleanup
    image: busybox:1.36
    command: ["sh", "-c", "rm -f /var/run/app/app.sock"]
    volumeMounts:
      - name: app-socket
        mountPath: /var/run/app

containers:
  # Your application container
  - name: app
    # ...
    volumeMounts:
      - name: app-socket
        mountPath: /var/run/app

  # socat sidecar: bridges the UNIX socket to the Worker's Service
  - name: socat-opw-bridge
    image: alpine/socat:1.8.0.0
    args:
      - UNIX-RECV:/var/run/app/app.sock,fork
      - TCP:<RELEASE_NAME>-observability-pipelines-worker.<NAMESPACE>.svc.cluster.local:5000
    volumeMounts:
      - name: app-socket
        mountPath: /var/run/app

# Monitor and adjust resources as necessary
    resources:
      requests:
        cpu: 10m
        memory: 16Mi
    securityContext:
      runAsNonRoot: true
      runAsUser: 1000
      allowPrivilegeEscalation: false
      readOnlyRootFilesystem: true

TCP 인수가 localhost 대신 Observability Pipelines Worker의 Kubernetes 서비스 엔드포인트를 가리키도록 설정하세요. Observability Pipelines Worker의 StatefulSet 포드가 모든 노드에서 실행된다는 보장이 없으므로 localhost에서 Observability Pipelines Worker 포드에 연결하지 못할 수 있습니다. Observability Pipelines Worker와 워크로드에 대해 전용 노드 그룹이 있는 경우 특히 그렇습니다.

시크릿 기본값

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