로깅 에이전트

인프라 및 애플리케이션 로그를 수집하여 로깅 에이전트 인스턴스로 직접 전송하도록 IBM Cloud Logs을 구성할 수 있습니다.

로깅 에이전트는 로그 데이터를 수집하고 처리하는 데 사용되는 플루언트 비트 오픈 소스 에이전트를 기반으로 합니다. 지원되는 환경에 로깅 에이전트를 배포하고 다양한 소스 및 형식의 데이터를 관리할 수 있습니다.

다음 다이어그램은 대상이 IBM Cloud Logs 인스턴스인 경우의 상위 수준 보기를 보여 줍니다:

상담원의 로그 흐름
로그 흐름
로그 흐름*

로깅 에이전트 정보

로깅 에이전트 사용하여 IBM Cloud Logs 서비스에 로그를 보낼 때 보내는 로그에는 ' applicationName ' 및 ' subsystemName ' 메타데이터 필드에 대한 값이 포함되어야 합니다. 기본적으로 로깅 에이전트를 구성하면 상담원이 이러한 필드에 대한 기본값을 설정합니다. 기본값을 대체할 사용자 지정 값을 직접 구성할 수 있습니다.

오케스트레이션 환경의 경우 로깅 에이전트 참조

로깅 에이전트를 Red Hat OpenShift on IBM Cloud 또는 IBM Cloud Kubernetes Service 클러스터에 배포할 수 있습니다.

온프레미스에서 실행하는 클러스터, IBM Cloud 또는 다른 클라우드에 에이전트를 배포할 수 있습니다.

로깅 에이전트는 클러스터의 각 노드에서 하나의 파드가 실행되도록 설계된 데몬 세트입니다. 각 파드는 실행 중인 노드에 대한 관련 로그를 수집합니다. 그러면 로깅 에이전트가 해당 로그를 IBM Cloud Logs 서비스로 전달합니다.

기본적으로 로깅 에이전트 ' /var/log/containers/'의 지정된 경로 패턴과 일치하는 파일에서 로그 데이터를 모니터링하고 수집하며, 제외 패턴과 일치하는 파일의 로그는 제외합니다. 새로 고침 간격은 10초로 설정되어 있습니다. 구성 맵 logger-agent-config 에서 이러한 값 등을 변경할 수 있습니다. 자세한 정보는 로그 필터링을 참조하십시오.

다음 플랫폼에 에이전트를 배포할 수 있습니다:

다음 다이어그램은 로그 소스가 Kubernetes 또는 OpenShift 클러스터인 경우의 상위 수준 보기를 보여줍니다:

클러스터에서 로그의
로그의
로그의 흐름*

로깅 에이전트 조율되지 않은 환경용

Linux 및 Windows 환경에서 로깅 에이전트 배포할 수 있습니다.

로깅 에이전트 모니터링하는 로그 파일을 구성하고 해당 데이터를 IBM Cloud Logs 인스턴스로 전달해야 합니다.

에이전트는 systemd를 사용하여 Linux 디먼으로 실행됩니다. systemctl을 사용하여 에이전트를 관리할 수 있습니다.

다음 플랫폼이 지원됩니다.

  • RHEL 8
  • RHEL 9
  • Ubuntu 20
  • Ubuntu 22
  • Debian 11
  • Debian 12
  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022
  • Windows 10 Enterprise
  • Windows 11 엔터프라이즈

자세한 내용은 Linux 환경에서 상담원 관리하기 또는 Windows 환경에서 상담원 관리하기를 참조하세요.

인증 방법

상담원이 IBM® Cloud Logs 서비스를 인증하는 데 사용하는 ID로 서비스 ID 또는 신뢰할 수 있는 프로필을 사용할 수 있습니다.

상담원을 배포하려는 환경에 대해 지원되는 권한 부여 방법을 선택합니다:

지원되는 인증 방법
환경 서비스 ID API 키 신뢰할 수 있는 프로파일
IBM Cloud Kubernetes 클러스터 지원됨 지원됨
IBM Cloud OpenShift 클러스터 지원됨 지원됨
IBM Cloud Linux VSI 지원됨 지원됨
IBM Cloud Windows VSI 지원됨 지원됨
온프레미스 Kubernetes 클러스터 지원됨 지원되지 않음
온프레미스 OpenShift 클러스터 지원됨 지원되지 않음
Linux 서버 지원됨 지원되지 않음
기타 클라우드 Kubernetes 클러스터 지원됨 지원되지 않음
기타 Cloud OpenShift 클러스터 지원됨 지원되지 않음
기타 클라우드 Linux 서버 지원됨 지원되지 않음

컴퓨팅 리소스와 인스턴스가 동일한 계정에 있는 경우에만 ' IBM Cloud Logs ' 인스턴스로 ' IBM Cloud ' 리소스를 인증하는 데 신뢰할 수 있는 프로필을 사용할 수 있습니다.

IBM Cloud Logs 인스턴스와 다른 IBM Cloud 계정으로 프로비저닝된 Kubernetes 클러스터에서 로그를 전송하려면, 에이전트의 권한 부여 방법으로 서비스 ID API 키만 사용할 수 있습니다.

API 키를 생성하는 방법에 대한 자세한 내용은 인증에 서비스 ID를 사용하여 수집을 위한 API 키 생성을 참조하세요.

신뢰할 수 있는 프로필을 만드는 방법에 대한 자세한 내용은 수집을 위한 신뢰할 수 있는 프로필 생성을 참조하세요.

지원되는 형식

상담원이 지원하는 입력 형식은 다음과 같습니다:

  • JSON
  • apache
  • apache2
  • 아파치_오류
  • nginx
  • 도커(도커 전용 타임스탬프 형식의 JSON)
  • cri
  • 시스템 로그(syslog)