Telemetry API 사용

이 문서에서는 원격 분석 (OTLP) API, telemetry.googleapis.com를 사용하도록 운영 에이전트를 구성하는 방법을 설명합니다. 원격 분석 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. 아직 사용 설정되지 않은 경우 Google Cloud 프로젝트에서 원격 분석 API를 사용 설정합니다. 다음 명령어를 실행하여 API를 사용 설정할 수 있습니다.

    gcloud services enable telemetry.googleapis.com

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

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

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

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

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

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

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

환경 변수 설정

다음 탭에 표시된 대로 EXPERIMENTAL_FEATURES 환경 변수를 otlp_exporter 값으로 설정하여 운영 에이전트가 원격 분석 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를 사용하지 않도록 운영 에이전트 구성

운영 에이전트가 원격 분석 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. 운영 에이전트를 다시 시작하여 변경사항을 적용합니다.

다음 단계