Logging 에이전트 개요

이 가이드에서는 가상 머신(VM) 인스턴스에서 실행되는 fluentd 기반 애플리케이션인 Logging 에이전트에 관한 기본 정보를 제공합니다.

Logging 에이전트는 기본 구성에서 일반 타사 애플리케이션과 시스템 소프트웨어의 로그를 Logging으로 스트리밍합니다. 기본 로그의 목록을 참조하세요. 에이전트가 추가 로그를 스트리밍하도록 구성할 수 있습니다. 에이전트 구성 및 작동에 대한 자세한 내용은 Logging 에이전트 구성을 참조하세요.

모든 VM 인스턴스에서 Logging 에이전트를 실행하는 것이 가장 좋습니다. 이 에이전트는 Linux와 Windows 모두에서 실행됩니다.

Logging 에이전트를 설치하려면 Logging 에이전트 설치를 참조하세요.

Logging 에이전트 작동 방식

지원되는 운영체제

다음과 같은 운영체제의 Logging 에이전트를 호환 가상 머신(VM) 인스턴스에서 실행할 수 있습니다.

  • CentOS 7 및 8
  • Rocky Linux 8
  • Red Hat Enterprise Linux 7 및 8
  • Debian 9 'Stretch', 10 'Buster', 11 'Bullseye'
  • Ubuntu LTS 20.04(Focal Fossa)
  • Ubuntu Minimal LTS 20.04(Focal Fossa)
  • SAP용 SUSE Linux Enterprise Server 12 및 12 SP5
  • SUSE Linux Enterprise Server 15, SAP용 15 SP2, SAP용 15 S3, SAP용 15 SP4, SAP용 15 SP5
  • OpenSUSE Leap 15, 15.2, 15.3, 15.4
  • Windows Server 2016 및 2019
  • Windows Server Core 2016 및 2019
  • Amazon Linux AMI(Amazon Linux 2.0 AMI 제외)

Container-Optimized OS VM을 실행하는 경우 VM에서 로그를 수집하려면 Container-Optimized OS 안내를 따르세요.

지원되는 환경

Logging 에이전트는 다음 환경과 호환됩니다.

  • Compute Engine 인스턴스. Logging 에이전트는 각 VM 인스턴스와 연결된 프로젝트로 로그를 전송합니다.

    외부 IP 주소가 없는 인스턴스의 경우 Logging 에이전트가 로그를 전송하도록 비공개 Google 액세스를 사용 설정해야 합니다.

  • Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스. Logging 에이전트는 AWS에서 Google Cloud 프로젝트로 로그를 전송합니다.

    Logging 에이전트가 제대로 작동하려면 에이전트가 실행되는 Amazon EC2 인스턴스가 Google Cloud API, 특히 Logging API와 통신할 수 있어야 합니다. 이를 위해서는 외부 IP 주소나 VPC 인터넷 게이트웨이가 필요합니다.

이러한 VM 인스턴스의 경우 Logging 에이전트를 실행하려면 최소 250MiB의 상주(RSS) 메모리가 필요하지만 1GiB를 확보하는 것이 좋습니다. 예를 들어 1초에 크기가 1KB인 로그 항목 100개를 전송하는 속도라면 Logging 에이전트는 기본 구성 시 1코어 150MiB 메모리에서 CPU 5%를 소모합니다.

다음 VM 인스턴스는 자체 소프트웨어를 사용하여 Logging을 지원하므로 여기에 Logging 에이전트를 직접 설치하는 기능은 지원되지 않습니다.

  • App Engine 표준 환경 인스턴스입니다. App Engine에는 Logging 지원이 기본 제공됩니다. 자세한 내용은 애플리케이션 로그 작성을 참조하세요.

  • App Engine 가변형 환경 인스턴스입니다. App Engine 가변형 환경에서 실행되는 앱은 App Engine 표준 환경에 포함되는 로그 외에 추가로 로그를 작성할 수 있습니다. 자세한 내용은 애플리케이션 로그 작성을 참조하세요.

  • Google Kubernetes Engine 노드 인스턴스 Logging을 사용한 로그 수집은 기본적으로 새 컨테이너 클러스터에 사용 설정되어 있습니다. 또한 기존 클러스터에도 이 수집을 사용 설정할 수 있습니다. 자세한 내용은 GKE의 로깅 및 모니터링 구성을 참조하세요.

  • Google Distributed Cloud에서 실행되는 인스턴스의 경우 에이전트는 시스템 로그를 수집하지만 애플리케이션 로그는 수집하지 않습니다.

  • Cloud Run 컨테이너 인스턴스입니다. Cloud Run에는 Logging을 위한 기본 지원이 포함되어 있습니다. 자세한 내용은 Logging 및 로그 보기를 참조하세요.

  • Cloud Run Functions HTTP 및 백그라운드 함수입니다. Cloud Run Functions에는 Logging 지원이 기본적으로 포함되어 있습니다. 자세한 내용은 로그 쓰기, 보기, 응답하기를 참조하세요.

온프레미스 및 하이브리드 클라우드 지원

Google Cloud는 observIQ와 제휴하여 일관되고 예측 가능한 방식으로 온프레미스 및 하이브리드 클라우드 플랫폼에 로깅 서비스를 제공합니다. BindPlane을 사용하여 자체 데이터를 수집한 후 분석을 위해 Logging으로 보낼 수 있습니다. BindPlane은 Cloud Logging과 통합되어 인프라의 데이터를 캡처하고 추가 비용 없이 프로젝트에 포함되어 있습니다.

observIQ 및 BindPlane에 대한 자세한 내용은 observIQ 및 BindPlane 정보를 참조하세요.

에이전트 액세스 요구사항

에이전트를 실행하려면 다음 DNS 이름에 액세스해야 합니다.

  • OAuth2 토큰 서버: oauth2.googleapis.com

    이전 버전의 에이전트는 www.googleapis.com(전체 URL: https://www.googleapis.com/oauth2/v3/token)에 액세스할 수 있어야 합니다.

    이전 버전의 에이전트를 사용하는 경우 최신 버전으로 에이전트를 업그레이드하는 것이 좋습니다.

  • Logging API: logging.googleapis.com

에이전트를 설치하려면 다음 DNS 이름에 액세스해야 합니다.

  • (Linux) Google Cloud Package Repository: packages.cloud.google.com

  • Google 다운로드 서버: dl.google.com

Logging 에이전트 소스 코드

소스 코드를 이해해야 하거나 다른 특별한 니즈가 있는 경우가 아니면 이 섹션의 정보가 필요 없습니다. Logging 에이전트는 설치 안내에 설명된 스크립트에 의해 설치됩니다.

Logging 에이전트 google-fluentd는 fluentd 로그 데이터 수집기의 수정 버전입니다. google-fluentd는 2가지 개별 패키지로 배포됩니다. 소스 코드는 연결된 GitHub 저장소에 제공됩니다.

  • google-fluentd라는 GitHub 저장소에는 코어 fluentd 프로그램, 커스텀 패키징 스크립트, Cloud Logging API용 출력 플러그인이 포함되어 있습니다.
    • 이 출력 플러그인은 Ruby gem으로 패키징되며 google-fluentd 패키지에 포함되어 있습니다. 또한 Ruby gem 호스팅 서비스(fluent-plugin-google-cloud)에서도 별도로 제공됩니다.
    • Windows 설치 프로그램과 관련된 콘텐츠는 windows-installer 폴더에 있습니다.
  • google-fluentd-catch-all-config라는 GitHub 저장소에는 다양한 타사 소프트웨어 패키지의 로그를 수집하는 Logging 에이전트 구성 파일이 포함되어 있습니다.

Logging 에이전트 출시 노트

  • google-fluentd/releases에서 google-fluentd Linux 패키지의 출시 노트를 확인할 수 있습니다. 여기서 출시 태그는 [Major].[Minor].[Patch] 시맨틱 버전 관리 형식을 따릅니다.

  • Windows 설치 프로그램의 출시 노트도 같은 위치(google-fluentd/releases)에서 확인할 수 있습니다. 하지만 출시 태그가 Windows로 시작됩니다.

  • fluent-plugin-google-cloud/releases에서 독립형 gem fluent-plugin-google-cloud의 출시 노트를 확인할 수 있습니다. 여기서 출시 태그는 [Major].[Minor].[Patch] 시맨틱 버전 관리 형식을 따릅니다.

지원 중단 정책

Logging 에이전트에는 Google Cloud Observability 에이전트 지원 중단 정책이 적용됩니다.

다음 단계