Telemetry API 사용

이 문서에서는 Telemetry (OTLP) API 인 telemetry.googleapis.com을 사용하도록 운영 에이전트를 구성하는 방법을 설명합니다. Telemetry API는 오픈소스 OpenTelemetry 프로토콜의 구현입니다. 이 기능을 사용 설정하면 운영 에이전트는 독점 Cloud Monitoring API 및 Cloud Logging API가 아닌 Telemetry API를 사용하여 로그와 측정항목을 모두 Google Cloud 프로젝트로 전송합니다.

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

시작하기 전에

Telemetry API를 사용하려면 다음을 수행하세요.

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

    gcloud services enable telemetry.googleapis.com

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

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

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

미리보기 기간에는 운영 에이전트의 Telemetry API 사용이 환경 변수 EXPERIMENTAL_FEATURES에 의해 제어됩니다. 운영 에이전트와 Telemetry API를 사용하여 원격 분석을 수집하려면 다음 섹션에 설명된 대로 다음을 수행해야 합니다.

  1. Telemetry API를 지원하는 운영 에이전트 버전을 설치합니다.
  2. EXPERIMENTAL_FEATURES 환경 변수를 설정합니다.
  3. 운영 에이전트를 다시 시작하여 변경사항을 적용합니다.

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

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

환경 변수 설정

다음 탭에 표시된 대로 EXPERIMENTAL_FEATURES 환경 변수를 otlp_exporter 값으로 설정하여 운영 에이전트에 Telemetry API에 대한 액세스 권한을 부여합니다.

Linux

운영 에이전트의 환경을 수정하려면 인스턴스에서 다음 명령어를 실행합니다.

for service in \
        google-cloud-ops-agent \
        google-cloud-ops-agent-fluent-bit \
        google-cloud-ops-agent-opentelemetry-collector \
        ; do
        sudo mkdir -p "/etc/systemd/system/${service}.service.d"
        echo -e '[Service]\nEnvironment="EXPERIMENTAL_FEATURES=otlp_exporter"' | sudo tee "/etc/systemd/system/${service}.service.d/otlp_exporter.conf"
done
sudo systemctl daemon-reload

Windows

운영 에이전트의 환경을 수정하려면 다음 단계를 수행합니다.

  1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.
  2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.
  3. 다음 PowerShell 명령어를 실행하여 EXPERIMENTAL_FEATURES 환경 변수를 설정합니다. 
    setx EXPERIMENTAL_FEATURES "otlp_exporter" /M

운영 에이전트 다시 시작

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를 사용하지 않도록 운영 에이전트 구성

운영 에이전트가 Telemetry API를 사용하여 원격 분석을 수집하지 않도록 하고 Cloud Monitoring API 및 Cloud Logging API를 사용하여 원격 분석 수집을 재개하려면 다음을 수행해야 합니다.

  1. EXPERIMENTAL_FEATURES 환경 변수를 설정 해제합니다.

    Linux

    운영 에이전트의 환경을 수정하려면 인스턴스에서 다음 명령어를 실행합니다.

    sudo find /etc/systemd/system -name otlp_exporter.conf | sudo xargs rm
sudo systemctl daemon-reload

    Windows

    운영 에이전트의 환경을 수정하려면 다음 단계를 수행합니다.

    1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.
    2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.
    3. 다음 PowerShell 명령어를 실행하여 EXPERIMENTAL_FEATURES 환경 변수를 삭제합니다. 
      REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /F /V EXPERIMENTAL_FEATURES

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

다음 단계