개별 VM에 작업 에이전트 설치

작업 에이전트는 Compute Engine 인스턴스의 로그 및 측정항목을 수집하여 로그는 Cloud Logging으로 전송하고 측정항목은 Cloud Monitoring으로 보냅니다.

시작하기 전에

에이전트를 설치하려면 다음 항목이 있는지 확인하세요.

명령줄을 사용하여 에이전트 설치

명령줄을 사용하여 에이전트를 설치하려면 다음 안내를 따르세요.

최신 버전의 에이전트 설치

에이전트의 최신 버전을 설치하려면 다음 단계를 완료하세요.

Linux

  1. SSH 또는 유사한 도구를 사용하여 VM 인스턴스와의 터미널 연결을 열고 sudo 액세스 권한이 있는지 확인합니다.

  2. 홈 디렉터리와 같은 쓰기 액세스 권한이 있는 디렉터리로 변경합니다.

  3. 실행:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
    sudo bash add-google-cloud-ops-agent-repo.sh --also-install
    

Windows

  1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.

  2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.

  3. 다음 PowerShell 명령어를 실행합니다.

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
    Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"
    

특정 버전의 에이전트 설치

에이전트의 특정 버전을 설치하려면 다음 단계를 완료하세요.

Linux

  1. SSH 또는 유사한 도구를 사용하여 VM 인스턴스와의 터미널 연결을 열고 sudo 액세스 권한이 있는지 확인합니다.

  2. 홈 디렉터리와 같은 쓰기 액세스 권한이 있는 디렉터리로 변경합니다.

  3. 에이전트 설치 스크립트를 다운로드합니다.

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
    

    add-google-cloud-ops-agent-repo.sh 스크립트를 실행할 때 다음 플래그를 설정할 수도 있습니다.

    • --verbose: 스크립트 실행 중 상세 로깅을 설정합니다.
    • --also-install: 에이전트 패키지 저장소를 추가한 후 에이전트를 설치합니다.
    • --version: 스크립트로 설치할 에이전트 버전을 설정합니다.
    • --uninstall: 에이전트를 제거합니다.
    • --remove-repo: 에이전트를 설치하거나 제거한 후 해당 에이전트 패키지 저장소를 삭제합니다.
    • --dry-run: 스크립트 실행에 대한 테스트 실행만 트리거하고 실행해야 하는 명령어를 출력합니다.
    • --uninstall-standalone-logging-agent: 기존 Logging 에이전트(StackdriverLogging)를 제거합니다.
    • --uninstall-standalone-monitoring-agent: 기존 Monitoring 에이전트(StackdriverMonitoring)를 제거합니다.

    자세한 내용 및 사용 예시는 스크립트 주석을 참조하세요.

  4. 에이전트의 패키지 저장소를 추가하고 에이전트를 설치합니다.

    1. 설치할 버전을 선택하기 위해 사용 가능한 에이전트 버전을 확인하려면 모든 에이전트 버전 나열을 참조하세요.

    2. 프로덕션 환경에서는 이전 버전과 호환되지 않는 변경사항이 포함될 수 있는 주 버전을 설치하지 않도록 주 버전에 고정하는 것이 좋습니다. 주 버전에 고정하려면 다음을 실행합니다.

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      예를 들어 에이전트의 1.x.x에 고정하려면 다음을 실행합니다.

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=1.*.*
      
    3. 특정 버전의 에이전트를 설치하려면 다음을 실행합니다.

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      

성공적으로 실행된 후에는 설치 스크립트를 삭제해도 됩니다.

  • 에이전트가 예상대로 작동하는지 확인하려면 다음을 실행합니다.

    sudo systemctl status google-cloud-ops-agent"*"
    

    에이전트의 상태는 OK여야 합니다.

설치에 문제가 있으면 문제 해결 페이지를 참조하세요.

Windows

  1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.

  2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.

  3. 에이전트 설치 스크립트를 다운로드합니다.

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
    

    add-google-cloud-ops-agent-repo.ps1 스크립트를 실행할 때 다음 플래그를 설정할 수도 있습니다.

    • -Verbose: 스크립트 실행 중 상세 로깅을 설정합니다.
    • -AlsoInstall: 에이전트 패키지 저장소를 추가한 후 에이전트를 설치합니다.
    • -Version: 스크립트로 설치할 에이전트 버전을 설정합니다.
    • -Uninstall: 에이전트를 제거합니다.
    • -RemoveRepo: 에이전트를 설치하거나 제거한 후 해당 에이전트 패키지 저장소를 삭제합니다.
    • -WhatIf: 스크립트 실행에 대한 테스트 실행만 트리거하고 실행해야 하는 명령어를 출력합니다.
    • -UninstallStandaloneLoggingAgent: 기존 Logging 에이전트(StackdriverLogging)를 제거합니다.
    • -UninstallStandaloneMonitoringAgent: 기존 Monitoring 에이전트(StackdriverMonitoring)를 제거합니다.

    자세한 내용 및 사용 예시는 스크립트 주석을 참조하세요.

  4. 에이전트의 패키지 저장소를 추가하고 에이전트를 설치합니다.

    1. 설치할 버전을 선택하기 위해 사용 가능한 에이전트 버전을 확인하려면 모든 에이전트 버전 나열을 참조하세요.

    2. 프로덕션 환경에서는 이전 버전과 호환되지 않는 변경사항이 포함될 수 있는 주 버전을 설치하지 않도록 주 버전에 고정하는 것이 좋습니다. 주 버전에 고정하려면 다음을 실행합니다.

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"
      

      예를 들어 에이전트의 1.x.x에 고정하려면 다음을 실행합니다.

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"
      
    3. 특정 버전의 에이전트를 설치하려면 다음을 실행합니다.

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"
      

      예를 들면 다음과 같습니다.

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"
      

성공적으로 실행된 후에는 설치 스크립트를 삭제해도 됩니다.

  • 에이전트가 예상대로 작동하는지 확인하려면 다음을 실행합니다.

    Get-Service google-cloud-ops-agent
    

    에이전트의 상태는 Running이어야 합니다.

설치에 문제가 있으면 문제해결 페이지를 참조하세요.

Google Cloud Console을 사용하여 에이전트 설치

Cloud Monitoring 대시보드 Compute Engine 또는 Cloud Console 페이지에서 개별 VM에 에이전트를 설치할 수 있습니다.

Cloud Monitoring

  1. Cloud Console에서 Google Cloud 프로젝트를 선택합니다.

    Cloud Console로 이동

  2. 탐색창에서 Monitoring을 선택합니다.

  3. Monitoring 탐색창에서 대시보드를 선택합니다.

  4. 대시보드 테이블에서 VM 인스턴스 항목을 찾은 다음 이름을 클릭합니다.

VM 인스턴스 대시보드의 인벤토리 탭에 다음 스크린샷과 같이 모든 VM이 나열되고 에이전트의 상태 열이 포함됩니다.

에이전트의 상태가 표시되는 Monitoring의 VM 인스턴스 대시보드

에이전트 열은 다음 값을 보고합니다.

  • 감지되지 않음: 에이전트가 설치되어 있지 않습니다. Cloud Monitoring에서 Compute Engine 인스턴스에 설치된 에이전트를 감지하지 않으면 다음을 수행하여 에이전트를 설치할 수 있습니다.

    • 에이전트를 설치할 VM 인스턴스를 선택합니다.
    • 인스턴스 테이블에서 에이전트 설치 옵션을 클릭하여 대시보드에 설치 워크플로를 가져오고 안내를 따릅니다. 작업 에이전트는 설치된 기본 에이전트이지만 설치 워크플로는 기존 에이전트를 설치할 수 있는 링크를 제공합니다.

      작업 에이전트는 기본적으로 측정항목과 로그를 모두 수집합니다. 작업 에이전트를 구성하여 이 기본 동작을 변경할 수 있습니다.

  • 작업 에이전트: 작업 에이전트를 실행 중입니다.

  • 기존 에이전트: 기존 Monitoring 또는 Logging 에이전트를 실행 중입니다. 작업 에이전트로 전환하는 방법에 대한 자세한 내용은 기존 에이전트에서 작업 에이전트로 마이그레이션을 참조하세요.

  • 해당 없음: 이 VM은 에이전트를 실행하는 데 지원되는 플랫폼이 아닙니다.

  • VM 중지됨: VM이 실행되고 있지 않으므로 에이전트의 상태를 알 수 없습니다.

Compute Engine

  1. Cloud Console에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스

  2. 에이전트를 설치할 VM의 이름을 클릭합니다. 세부정보 페이지가 열립니다.

  3. 관측 가능성 탭을 클릭합니다. 관측 가능성 페이지가 열립니다.

  4. 작업 에이전트 설치를 클릭합니다.

  5. Cloud Shell에서 실행을 클릭합니다. Cloud Shell이 열리면 설치 명령어를 붙여넣습니다.

  6. 키보드의 Enter를 누르고 명령어를 실행합니다.

  7. 승인을 클릭하여 Cloud Shell에서 에이전트를 설치하도록 허용합니다. Cloud Shell에 다음과 비슷한 줄이 표시되면 설치가 성공한 것입니다.

    Instance: projects/example-project/zones/us-west1-a/instances/example-vm successfully runs ops-agent
    

선택적 작업

이 섹션에서는 일반적인 유지보수 작업을 수행하는 방법을 설명합니다.

HTTP 프록시 구성

Logging 및 Monitoring API로 요청을 프록시하기 위해 HTTP 프록시를 사용하는 경우 다음을 수행합니다.

Linux

  1. 다음 구성 파일을 수정합니다(아직 없는 경우 파일 생성).

     /etc/systemd/system.conf
    
  2. 파일에 다음을 추가합니다.

     DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.
    
  3. 환경 변수를 다시 로드합니다.

     sudo systemctl daemon-reload
    
  4. VM 인스턴스에서 다음 명령어를 실행하여 에이전트를 다시 시작합니다.

     sudo systemctl restart google-cloud-ops-agent.target
    

Windows

  1. HTTP 프록시를 사용하는 경우 관리자 명령 프롬프트에서 다음 명령어를 실행합니다. 그러면 아웃바운드 HTTPS를 사용하여 Logging에 데이터를 전송할 수 있도록 HTTP_PROXYHTTPS_PROXY 환경 변수가 설정됩니다.

    setx HTTP_PROXY http://proxy-ip:proxy-port /m
    setx HTTPS_PROXY http://proxy-ip:proxy-port /m
    setx no_proxy metadata.google.internal /m
    

에이전트 버전 확인하기

시스템에서 Logging 에이전트 버전을 확인하려면 VM 인스턴스에서 다음 명령어를 실행합니다.

CENTOS / RHEL

Red Hat 또는 CentOS Linux에서 다음 명령어를 실행합니다.

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-cloud-ops-agent

DEBIAN / UBUNTU

Debian 또는 Ubuntu에서 다음 명령어를 실행합니다.

dpkg-query --show --showformat \
    '${Package} ${Version} ${Architecture} ${Status}\n' \
     google-cloud-ops-agent

SLES / SUSE

SUSE에서 다음 명령어를 실행합니다.

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-cloud-ops-agent

WINDOWS

Windows에서 다음 명령어를 실행합니다.

googet installed google-cloud-ops-agent

에이전트 다시 시작

구성 파일의 변경사항을 적용하려면 Logging 에이전트를 다시 시작해야 합니다. 에이전트를 다시 시작하려면 다음 안내를 따르세요.

LINUX

인스턴스에서 다음 명령어를 실행합니다.

 sudo service google-cloud-ops-agent restart

Windows

  1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.

  2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.

  3. 다음 PowerShell 명령어를 실행합니다.

Restart-Service google-cloud-ops-agent -Force

에이전트 업그레이드

Logging 에이전트를 최신 출시 버전으로 업그레이드하려면 다음 안내에 따르세요.

Linux

에이전트를 최신 버전으로 업그레이드하려면 다음 명령어를 실행합니다.

sudo bash add-google-cloud-ops-agent-repo.sh --also-install

특정 주 버전의 최신 포인트 출시 버전으로 에이전트를 업그레이드하려면 다음 명령어를 실행합니다.

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

최신 에이전트 출시 버전으로 업그레이드하려면 다음 안내를 따르세요.

  1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.

  2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.

    Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"
    
  3. 다음 PowerShell 명령어를 실행하여 설치된 에이전트를 삭제하고 설치 명령어를 실행합니다.

    googet -noconfirm remove google-cloud-ops-agent
    googet -noconfirm install google-cloud-ops-agent
    

모든 에이전트 버전 나열

사용 가능한 에이전트 버전을 나열하려면 다음 명령어를 실행합니다.

CENTOS / RHEL

사용 가능한 에이전트 버전을 나열합니다.

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN / UBUNTU

사용 가능한 에이전트 버전을 나열합니다.

sudo apt-cache madison google-cloud-ops-agent

SLES / SUSE

사용 가능한 에이전트 버전을 나열합니다.

sudo zypper search -s google-cloud-ops-agent

WINDOWS

사용 가능한 에이전트 버전을 나열합니다.

googet available google-cloud-ops-agent

에이전트 제거

Logging 에이전트와 구성 파일을 삭제하려면 다음 안내를 따르세요.

에이전트를 제거한 후 Google Cloud Console이 이 변경사항을 보고하는 데 최대 1시간이 걸릴 수 있습니다.

Linux

다음 명령어를 실행합니다.

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

Windows

작업 에이전트를 제거하려면 다음 단계를 따르세요.

  1. RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.

  2. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.

  3. 다음 PowerShell 명령어를 실행합니다.

    googet -noconfirm remove google-cloud-ops-agent
    

원격 패키지 액세스가 없는 VM

Logging 에이전트를 설치하려면 에이전트 패키지와 (Linux의 경우) 종속 항목 모두 원격 패키지 저장소에 액세스해야 합니다.

VPC-SC 또는 비공개 네트워크를 사용하는 경우 네트워크 구성이 업스트림 저장소의 에이전트 종속 항목 설치 기능에 영향을 줄 수 있습니다. 에이전트 패키지 자체는 비공개 Google 액세스를 사용하여 액세스할 수 있습니다.

VM 호스트의 보안 정책에 따라 원격 패키지 저장소에 대한 액세스가 거부되는 경우 이미지에서 에이전트가 사전 설치된 커스텀 VM 이미지를 만들고 패키지 관리를 사용 중지하는 것이 좋습니다.

다음 단계