Logging 에이전트 정보

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

Logging 에이전트 작동 방식

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

모든 VM 인스턴스에서 Logging 에이전트를 실행하는 것이 가장 좋습니다. 이 에이전트는 Linux와 Windows 모두에서 실행됩니다. Logging 에이전트를 설치하려면 에이전트 설치로 이동하세요.

지원되는 운영체제

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

  • CentOS 6, 7, 8
  • Debian 9 'Stretch' 및 10 'Buster'
  • Red Hat Enterprise Linux 6, 7, 8
  • Ubuntu LTS 16.04(Xenial Xerus), LTS 18.04(Bionic Beaver), 19.10(Eoan Ermine), LTS 20.04(Focal Fossa)
  • Ubuntu Minimal LTS 16.04(Xenial Xerus), LTS 18.04(Bionic Beaver), 19.10(Eoan Ermine), LTS 20.04(Focal Fossa)
  • SUSE Linux Enterprise Server 12 SP3, 12 SP2 for SAP, 12 SP3 for SAP, 15, 15 for SAP, 15 SP1 for SAP
  • Windows Server 2008 R2, 2012 R2, 2016, 2019
  • Amazon Linux AMI(Amazon Linux 2.0 AMI 제외)

지원되는 환경

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

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

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

  • Amazon Web Services Elastic Compute Cloud (AWS EC2) 인스턴스. Logging 에이전트는 작업공간의 AWS 커넥터 프로젝트로 로그를 전송합니다. AWS 계정을 작업공간에 연결하면 Monitoring에서 이 프로젝트를 만듭니다.

    Logging 에이전트가 올바르게 작동하려면 에이전트가 실행되는 Amazon EC2 인스턴스가 Google Cloud APIs, 특히 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 노드 인스턴스 새 컨테이너 또는 기존 컨테이너 클러스터에 통합 모니터링 및 로깅 솔루션인 GKE용 클라우드 작업을 사용 설정할 수 있습니다.

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

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

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

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

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

Blue Medora에 대한 자세한 내용은 Blue Medora 정보를 참조하세요.

에이전트 액세스 요구사항

에이전트를 실행하려면 다음 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

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

Logging 에이전트 소스 코드

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

Logging 에이전트 google-fluentdfluentd 로그 데이터 수집기의 수정 버전입니다. 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의 작업 제품군 에이전트 지원 중단 정책이 적용됩니다.

다음 단계