Telemetry API 사용

원격 분석 (OTLP) API를 사용하여 로그, 측정항목, trace를 Google Cloud 프로젝트로 전송하도록 운영 에이전트를 구성할 수 있습니다. 원격 분석 API(telemetry.googleapis.com)는 오픈소스 OpenTelemetry 프로토콜을 구현한 것입니다. 이 API를 사용하도록 운영 에이전트를 구성하면 운영 에이전트는 독점 Cloud Monitoring API, Logging API 또는 Trace API 대신 원격 분석 API를 사용하여 원격 분석을 전송합니다.

운영 에이전트에서 Telemetry API를 사용하고 API 사용량을 모니터링하는 차트 또는 알림 정책이 있는 경우 이러한 아티팩트를 업데이트하여 monitoring.googleapis.com, logging.googleapis.com 또는 cloudtrace.googleapis.com 엔드포인트가 아닌 telemetry.googleapis.com 엔드포인트를 모니터링해야 합니다.

시작하기 전에

Telemetry API를 사용하려면 다음 단계를 따르세요.

  1. 아직 사용 설정되지 않은 경우 Google Cloud 프로젝트에서 원격 분석 API를 사용 설정합니다. 다음 명령어를 실행하여 API를 사용 설정할 수 있습니다.

    gcloud services enable telemetry.googleapis.com

  2. 기본값이 충분하지 않은 경우 원격 분석 API 할당량을 조정합니다. 원격 분석 API의 할당량은 Cloud Monitoring API 및 Cloud Logging API의 할당량과 별개입니다. Telemetry API의 할당량 및 한도에 대한 자세한 내용은 다음을 참고하세요.

    수집하는 원격 분석 데이터의 양에 맞게 이러한 할당량을 조정해야 할 수 있습니다.

  3. trace를 수집하는 경우 운영 에이전트에서 사용하는 서비스 계정에 Cloud Telemetry Traces Writer (roles/telemetry.tracesWriter) 역할을 부여합니다. 이 역할은 트레이스를 작성하는 데 필요한 권한을 제공합니다.

Telemetry API를 사용하도록 운영 에이전트 구성

운영 에이전트는 독점 API(기본값)를 사용하여 원격 분석을 전송하는 것과 원격 분석 API를 사용하여 원격 분석을 전송하는 것 사이를 전환하는 구성 옵션을 제공합니다. 운영 에이전트와 원격 분석 API를 사용하여 원격 분석을 수집하려면 다음 섹션에 설명된 대로 다음을 수행해야 합니다.

  1. 원격 분석 API를 지원하는 버전의 운영 에이전트를 설치합니다.
  2. 운영 에이전트 config.yaml 파일을 업데이트하여 구성 옵션을 설정합니다.
  3. 운영 에이전트를 다시 시작하여 변경사항을 적용합니다.

운영 에이전트 버전 2.71.0 이상 사용

운영 에이전트와 함께 원격 분석 API를 사용하려면 운영 에이전트 버전 2.71.0 이상을 설치해야 합니다. 운영 에이전트 설치에 대한 자세한 내용은 개별 VM의 운영 에이전트 설치를 참고하세요.

구성 옵션 설정

에이전트의 config.yaml 파일에서 otlp_exporter 구성 옵션을 true로 설정하여 운영 에이전트가 Telemetry API에 액세스하도록 합니다.

global:
   otlp_exporter: true

운영 에이전트 다시 시작

Linux

  1. 에이전트를 다시 시작하려면 인스턴스에서 다음 명령어를 실행합니다. 
    sudo systemctl restart google-cloud-ops-agent
  2. 에이전트가 다시 시작되었는지 확인하려면 다음 명령어를 실행하고 '측정항목 에이전트' 및 'Logging 에이전트' 구성요소가 시작되었는지 확인합니다. 
    sudo systemctl status "google-cloud-ops-agent*"

Windows

  1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.
  2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.
  3. 에이전트를 다시 시작하려면 다음 PowerShell 명령어를 실행합니다. 
    Restart-Service google-cloud-ops-agent -Force
  4. 에이전트가 다시 시작되었는지 확인하려면 다음 명령어를 실행하고 '측정항목 에이전트' 및 'Logging 에이전트' 구성요소가 시작되었는지 확인합니다.
    Get-Service google-cloud-ops-agent*

Telemetry API를 사용하지 않도록 운영 에이전트 구성

원격 분석 API를 사용하여 운영 에이전트가 원격 분석을 수집하지 못하도록 하고 Cloud Monitoring API, Logging API, Trace API를 사용하여 원격 분석 수집을 재개하려면 다음 단계를 따르세요.

  1. config.yaml 파일에서 otlp_exporter 옵션을 삭제합니다. 또는 옵션을 false로 설정할 수 있습니다.

  2. 운영 에이전트를 다시 시작하여 변경사항을 적용합니다.

다음 단계