단일 VM에 Cloud Monitoring 에이전트 설치

Cloud Monitoring 에이전트는 VM 인스턴스에서 시스템 및 애플리케이션 측정항목을 수집하여 모니터링으로 전송합니다. Monitoring 에이전트를 구성하여 타사 애플리케이션을 모니터링할 수도 있습니다.

이 가이드에서는 Compute Engine 및 Amazon Elastic Compute Cloud (EC2) VM에 Cloud Monitoring 에이전트를 설치하는 방법을 설명합니다. Compute Engine VM 인스턴스에는 에이전트 사용이 선택사항이지만 권장됩니다. 이러한 VM의 경우 Monitoring은 에이전트 없이도 VM의 하이퍼바이저에서 CPU 사용률, 일부 디스크 트래픽 측정항목, 네트워크 트래픽, 업타임을 비롯하여 몇 가지 측정항목에 액세스할 수 있습니다. Amazon Elastic Compute Cloud (EC2) VM에는 에이전트를 사용해야 합니다.

Microsoft Windows를 실행하는 인스턴스에서는 에이전트가 CPU 사용률 및 메모리, 페이지 파일, 볼륨 사용량을 기록합니다. IIS 또는 SQL 서버를 실행하는 경우 에이전트가 기본적으로 이러한 서비스에서 측정항목을 수집합니다.

시작하기 전에

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

  • Google Cloud 프로젝트 또는 Amazon Web Services(AWS) 계정의 지원되는 VM 인스턴스

    • Monitoring 에이전트를 실행하려면 최소 250MiB의 상주(RSS) 메모리가 권장됩니다.

    또한 VM이 지원하는 운영체제를 실행 중인지 확인하세요.

  • VM 인스턴스가 포함된 AWS 계정을 모니터링하는 작업공간. 가격 정보는 Google Cloud 작업 제품군 가격 책정을 참조하세요.

  • Cloud Logging 또는 Cloud Monitoring과의 통신을 승인하는 VM 인스턴스의 사용자 인증 정보. 대개 Compute Engine VM 인스턴스에는 기본적으로 올바른 사용자 인증 정보가 있습니다. 다음 시나리오 중 하나에 해당하면 적절한 사용자 인증 정보가 없어서 에이전트 승인 절차를 수행해야 할 수 있습니다.

    • 실행 중인 AWS EC2 VM 인스턴스. 에이전트를 설치하기 전에 VM에 승인 사용자 인증 정보를 설치해야 합니다.

    • 실행 중인 매우 오래된 Compute Engine 인스턴스 또는 기본 사용자 인증 정보 없이 생성된 Compute Engine 인스턴스

    적절한 사용자 인증 정보가 있는지 확인하려면 Compute Engine 사용자 인증 정보 확인 절차를 수행하세요.

AWS EC2 VM 인스턴스용 Google Cloud 프로젝트

문서가 EC2 VM 인스턴스에 대하여 VM 인스턴스에 연결된 Google Cloud 프로젝트를 참조한다는 것은 AWS 계정에 연결된 AWS 커넥터 프로젝트를 의미합니다.

AWS 계정을 작업공간에 연결하면 AWS 커넥터 프로젝트가 생성됩니다. AWS 커넥터 프로젝트를 식별하려면 작업공간의 설정 탭으로 이동합니다. 커넥터 프로젝트는 AWS 계정이라는 제목 아래에 나열됩니다. 프로젝트 ID 열에는 작업공간과 연결된 Google Cloud 프로젝트가 표시됩니다.

AWS 커넥터 프로젝트에 대한 자세한 내용은 작업공간 페이지를 참조하세요.

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

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

단일 VM에 에이전트 설치

Linux 또는 Microsoft Windows를 실행하는 VM 인스턴스에 에이전트를 설치하려면 다음 안내를 따르세요.

AMAZON LINUX AMI / CENTOS / RHEL

  1. SSH 또는 유사한 도구를 사용하여 VM 인스턴스에 대한 터미널 연결을 엽니다.

  2. sudo에 액세스 가능한지 확인합니다.

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

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

    curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    
  5. 에이전트 설치:

    1. 설치할 버전을 선택하기 위해 사용 가능한 버전의 에이전트를 나열합니다.

      sudo yum list --showduplicates stackdriver-agent
      
    2. 프로덕션 환경에서는 이전 버전과 호환되지 않는 변경사항이 포함될 수 있는 주 버전을 가져오지 않도록 주 버전에 고정하는 것이 좋습니다. 주 버전에 고정하려면 다음을 실행합니다.

      sudo yum install -y stackdriver-agent-major-versio.*
      

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

      sudo yum install -y stackdriver-agent-6.*
      
    3. 주 버전에 고정하지 않으려면 다른 설치 옵션 중 하나를 선택합니다.

      1. 특정 버전의 에이전트를 설치하려면 다음을 실행합니다.

          sudo yum install -y stackdriver-agent-version-number
        
      2. 에이전트의 최신 버전을 설치하려면 다음을 실행합니다.

          sudo yum install -y stackdriver-agent
        
  6. 에이전트 서비스 시작

    sudo service stackdriver-agent start
    

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

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

    sudo service stackdriver-agent status
    

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

  • 로그를 검토하여 오류가 없는지 확인할 수도 있습니다.

    sudo grep collectd /var/log/{syslog,messages} | tail
    

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

Debian / Ubuntu

  1. SSH 또는 유사한 도구를 사용하여 VM 인스턴스에 대한 터미널 연결을 엽니다.

  2. sudo에 액세스 가능한지 확인합니다.

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

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

    curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    sudo apt-get update
    
  5. 에이전트 설치:

    1. 설치할 버전을 선택하기 위해 사용 가능한 버전의 에이전트를 나열합니다.

      sudo apt-cache madison stackdriver-agent
      
    2. 프로덕션 환경에서는 이전 버전과 호환되지 않는 변경사항이 포함될 수 있는 주 버전을 가져오지 않도록 주 버전에 고정하는 것이 좋습니다. 주 버전에 고정하려면 다음을 실행합니다.

      sudo apt-get install -y 'stackdriver-agent=major-version.*'
      

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

      sudo apt-get install -y 'stackdriver-agent=6.*'
      
    3. 주 버전에 고정하지 않으려면 다른 설치 옵션 중 하나를 선택합니다.

      1. 특정 버전의 에이전트를 설치하려면 다음을 실행합니다.

          sudo apt-get install -y stackdriver-agent=version-number
        
      2. 에이전트의 최신 버전을 설치하려면 다음을 실행합니다.

          sudo apt-get install stackdriver-agent
        
  6. 에이전트 서비스 시작

    sudo service stackdriver-agent start
    

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

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

    sudo service stackdriver-agent status
    

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

  • 로그를 검토하여 오류가 없는지 확인할 수도 있습니다.

    sudo grep collectd /var/log/{syslog,messages} | tail
    

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

SLES / SUSE

  1. SSH 또는 유사한 도구를 사용하여 VM 인스턴스에 대한 터미널 연결을 엽니다.

  2. sudo에 액세스 가능한지 확인합니다.

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

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

    curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    
  5. 에이전트 설치:

    1. 설치할 버전을 선택하기 위해 사용 가능한 버전의 에이전트를 나열합니다.

      sudo zypper search -s stackdriver-agent
      
    2. 프로덕션 환경에서는 이전 버전과 호환되지 않는 변경사항이 포함될 수 있는 주 버전을 가져오지 않도록 주 버전에 고정하는 것이 좋습니다. 주 버전에 고정하려면 다음을 실행합니다.

      sudo zypper install -y 'stackdriver-agent<major-version.0.0'
      

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

      sudo zypper install -y 'stackdriver-agent<6+1.0.0'
      
    3. 주 버전에 고정하지 않으려면 다른 설치 옵션 중 하나를 선택합니다.

      1. 특정 버전의 에이전트를 설치하려면 다음을 실행합니다.

          sudo zypper install -y stackdriver-agent=version-number
        
      2. 에이전트의 최신 버전을 설치하려면 다음을 실행합니다.

          sudo zypper install stackdriver-agent
        
  6. 에이전트 서비스 시작

    sudo service stackdriver-agent start
    

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

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

    sudo service stackdriver-agent status
    

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

  • 로그를 검토하여 오류가 없는지 확인할 수도 있습니다.

    sudo grep collectd /var/log/{syslog,messages} | tail
    

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

WINDOWS

Windows를 실행하는 VM 인스턴스에 에이전트를 설치하려면 다음 단계를 수행하세요.

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

  2. PowerShell 터미널을 열고 다음 PowerShell 명령어를 실행합니다. 관리자 권한은 필요하지 않습니다.

    cd $env:UserProfile;
    (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", ".\StackdriverMonitoring-GCM-46.exe")
    .\StackdriverMonitoring-GCM-46.exe
    

    또는 다음 URL로 이동하여 에이전트의 설치 프로그램을 다운로드하고 실행해도 됩니다.

    https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

    에이전트를 자동으로 설치하려면 설치 프로그램 호출에 /S 옵션을 추가하세요.

    .\StackdriverMonitoring-GCM-46.exe /S
    

    '자동' 모드에서는 /D 옵션을 사용하여 설치 디렉터리를 지정합니다. 예를 들면 다음과 같습니다.

    .\StackdriverMonitoring-GCM-46.exe /S /D="C:\Google Cloud's operations suite\Monitoring\"
    

    설치가 성공적으로 완료되면 설치 프로그램을 삭제해도 됩니다.

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

선택적 작업

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

HTTP 프록시 구성

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

LINUX

  1. 다음 구성 파일을 수정합니다(없으면 만들어야 함).

    • 에이전트 버전 6.0.0 이상에서는 다음을 수정합니다.

      /etc/default/stackdriver-agent
      
    • 6.0.0 이전 버전의 에이전트는 OS에 적절한 파일을 수정합니다.

      Debian 및 Ubuntu의 경우 다음을 수정합니다.

      /etc/default/stackdriver-agent
      

      CentOS 및 SLES의 경우 다음을 수정합니다.

      /etc/default/stackdriver-collectd
      
  2. 다음 줄을 추가합니다.

     export http_proxy="http://proxy-ip:proxy-port"
     export https_proxy="http://proxy-ip:proxy-port"
     export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.
    
  3. VM 인스턴스에서 다음 명령어를 실행하여 Monitoring 에이전트를 다시 시작합니다.

     sudo service stackdriver-agent restart
    

WINDOWS

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

    setx HTTP_PROXY http://proxy-ip:proxy-port /m
    setx HTTPS_PROXY http://proxy-ip:proxy-port /m
    setx no_proxy 169.254.169.254 /m
    

에이전트 버전 확인하기

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

AMAZON LINUX AMI / CENTOS / RHEL

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

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     stackdriver-agent

Debian / Ubuntu

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

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

SLES / SUSE

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

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     stackdriver-agent

WINDOWS

현재는 Windows에서 실행 중인 Monitoring 에이전트의 버전을 확인할 수 있는 방법이 없습니다.

에이전트 다시 시작

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

LINUX

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

 sudo service stackdriver-agent restart

WINDOWS

관리자 권한 필요: 에이전트를 다시 시작하려면 PowerShell 터미널에서 다음 명령어를 실행합니다.

Restart-Service -Name StackdriverMonitoring

에이전트 업그레이드

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum update stackdriver-agent

DEBIAN / UBUNTU

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

sudo apt-get update
sudo apt-get install stackdriver-agent

SLES / SUSE

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

sudo zypper update stackdriver-agent

WINDOWS

최신 에이전트 출시 버전으로 업그레이드하려면 이 페이지의 Windows에 설치에 설명된 대로 최신 에이전트를 설치합니다. 설치 프로그램에서 에이전트의 이전 버전을 제거하라는 메시지를 표시합니다.

에이전트 제거

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum remove stackdriver-agent

Debian / Ubuntu

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

sudo apt-get purge stackdriver-agent

SLES / SUSE

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

sudo zypper remove stackdriver-agent

WINDOWS

Windows 제어판에서 프로그램 제거를 선택합니다. 제거할 수 있는 프로그램 목록에 Monitoring 에이전트가 표시되어야 합니다.