개별 VM에 Monitoring 에이전트 설치

기존 에이전트입니다. 이 에이전트는 Linux에서 계속 지원되지만 새 Google Cloud 워크로드에는 사용하지 않는 것이 좋습니다.

대신 새 Google Cloud 워크로드에 운영 에이전트를 사용하고 결국 운영 에이전트를 사용하도록 기존 Compute Engine VM을 전환하는 것이 좋습니다. 측정항목 수집 및 로깅을 단일 에이전트로 결합하는 운영 에이전트가 기존 에이전트를 결국 대체하게 됩니다.

운영 에이전트가 활발하게 개발되고 있지만 지원되지 않는 사용 사례도 있을 수 있습니다. 운영 에이전트가 사용 사례를 지원하지 않는 경우에도 Linux에서 Monitoring 에이전트를 사용할 수 있습니다.

기존 Monitoring 에이전트에 대한 새 기능 개발이나 새 운영체제 지원은 제공되지 않습니다.

Windows에서 기존 Monitoring 에이전트를 사용하지 않는 것이 좋습니다. Windows의 기존 Monitoring 에이전트는 지원되지 않으며 모든 기능은 운영 에이전트에서 사용할 수 있습니다. Windows 인스턴스를 모니터링할 때는 운영 에이전트를 사용하는 것이 좋습니다. 그러나 Windows에서 기존 Logging 에이전트를 실행하고 측정항목도 수집해야 하는 경우에는 기존 Monitoring 에이전트를 사용해야 합니다. 운영 에이전트와 기존 에이전트를 동일한 머신에서 실행할 수는 없습니다.

Monitoring 에이전트는 Compute Engine 인스턴스에서 로그와 측정항목을 수집하여 로그를 Cloud Logging으로, 측정항목을 Cloud Monitoring으로 보냅니다.

시작하기 전에

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

Google Cloud 프로젝트 또는 Amazon Web Services(AWS) 계정의 지원되는 VM 인스턴스
- Monitoring 에이전트를 실행하려면 최소 250MiB의 상주(RSS) 메모리가 권장됩니다.
또한 VM이 지원하는 운영체제를 실행 중인지 확인하세요.
Cloud Logging 또는 Cloud Monitoring과의 통신을 승인하는 VM 인스턴스의 사용자 인증 정보 대개 Compute Engine VM 인스턴스에는 기본적으로 올바른 사용자 인증 정보가 있습니다. 다음 시나리오 중 하나에 해당하면 적절한 사용자 인증 정보가 없어서 모니터링 에이전트 승인 절차를 수행해야 할 수 있습니다.
- 실행 중인 AWS EC2 VM 인스턴스. 에이전트를 설치하기 전에 VM에 승인 사용자 인증 정보를 설치해야 합니다.
- 실행 중인 매우 오래된 Compute Engine 인스턴스 또는 기본 사용자 인증 정보 없이 생성된 Compute Engine 인스턴스
적절한 사용자 인증 정보가 있는지 확인하려면 Compute Engine 사용자 인증 정보 확인 절차를 수행하세요.
가격 정보는 Google Cloud Observability 가격 책정을 참조하세요.
원격 패키지 저장소에 대해 액세스 권한이 없는 VM을 사용하는 경우 원격 패키지 액세스 권한이 없는 VM 섹션에서 자세한 내용을 확인하세요.

명령줄에서 에이전트 설치

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

Linux

SSH 또는 유사한 도구를 사용하여 VM 인스턴스와의 터미널 연결을 열고 sudo 액세스 권한이 있는지 확인합니다.
홈 디렉터리와 같은 쓰기 액세스 권한이 있는 디렉터리로 변경합니다.
다음 명령어를 사용하여 에이전트 설치 스크립트를 다운로드하고 실행합니다.
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
sudo bash add-monitoring-agent-repo.sh --also-install
```
설치 후 에이전트가 자동으로 시작됩니다.

Windows

RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.
PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.

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

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

특정 버전의 에이전트 설치

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

Linux

SSH 또는 유사한 도구를 사용하여 VM 인스턴스와의 터미널 연결을 열고 sudo 액세스 권한이 있는지 확인합니다.
홈 디렉터리와 같은 쓰기 액세스 권한이 있는 디렉터리로 변경합니다.
에이전트 설치 스크립트를 다운로드합니다.
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
```
add-monitoring-agent-repo.sh 스크립트를 실행할 때 다음 플래그를 설정할 수도 있습니다.
- --verbose: 스크립트 실행 중 상세 로깅을 설정합니다.
- --also-install: 에이전트 패키지 저장소를 추가한 후 에이전트를 설치합니다.
- --version: 스크립트로 설치할 에이전트 버전을 설정합니다. 버전 정보는 모든 에이전트 버전 나열을 참조하세요.
- --uninstall: 에이전트를 제거합니다.
- --remove-repo: 에이전트를 설치하거나 제거한 후 해당 에이전트 패키지 저장소를 삭제합니다.
- --dry-run: 스크립트 실행에 대한 테스트 실행만 트리거하고 실행해야 하는 명령어를 출력합니다.
자세한 내용 및 사용 예시는 스크립트 주석을 참조하세요.
에이전트의 패키지 저장소를 추가하고 에이전트를 설치합니다.
1. 사용 가능한 에이전트 버전을 나열하려면 모든 에이전트 버전 나열을 참조하세요.
2. 프로덕션 환경에서는 이전 버전과 호환되지 않는 변경사항이 포함될 수 있는 주 버전을 설치하지 않도록 주 버전에 고정하는 것이 좋습니다. 주 버전에 고정하려면 다음을 실행합니다.
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*
```
  예를 들어 에이전트의 6.x.x에 고정하려면 다음을 실행합니다.
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=6.*.*
```
3. 특정 버전의 에이전트를 설치하려면 다음을 실행합니다.
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
```
에이전트 서비스 시작
```
sudo service stackdriver-agent start
```

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

에이전트가 예상대로 작동하는지 확인하려면 다음을 실행합니다.
```
sudo service stackdriver-agent status
```
에이전트의 상태는 OK여야 합니다.

로그를 검토하여 오류가 없는지 확인할 수도 있습니다.
```
sudo grep collectd /var/log/{syslog,messages} | tail
```

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

Windows

RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.
PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.

참고: 에이전트의 최신 버전만 Windows를 실행하는 VM 인스턴스에서 지원됩니다. 이전 버전 설치는 권장되지 않습니다.
1. 다음 PowerShell 명령어를 실행합니다.
```
(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
```
또는 다음 URL로 이동하여 에이전트의 설치 프로그램을 다운로드하고 실행해도 됩니다.

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

주의: 시스템 디렉터리가 아닌 디렉터리(예: C:\Users\[USERNAME])에 설치 프로그램을 다운로드해야 합니다. 보안상의 이유로 설치 프로그램은 C:\ 디렉터리를 포함한 시스템 디렉터리에서는 실행되지 않습니다.
설치 프로그램을 시스템 디렉터리에 다운로드할 경우 다른 디렉터리로 옮긴 후에 실행하세요.
참고: 에이전트 설치 프로그램은 설치 스크립팅에 사용할 수 있는 '자동' 옵션인 /S도 지원합니다.

에이전트를 자동으로 설치하려면 설치 프로그램 호출에 /S 옵션을 추가하세요.
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
```
주의: 자동 설치는 비동기 작업입니다. 설치 명령어가 종료되면 에이전트가 아직 설치되지 않은 것입니다. StackdriverMonitoring 서비스를 찾아 성공적으로 설치되었는지 확인할 수 있습니다.
참고: 설치 프로그램은 에이전트를 기본적으로 `C:\Program Files (x86)\Stackdriver\Google Cloud ObservabilityAgent` 디렉터리에 배치합니다. 설치 과정에서 이 디렉터리를 변경할 수 있습니다.

'자동' 모드에서는 /D 옵션을 사용하여 설치 디렉터리를 지정합니다. 예를 들면 다음과 같습니다.
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Google Cloud Observability\"
```
설치가 성공적으로 완료되면 설치 프로그램을 삭제해도 됩니다.

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

Google Cloud 콘솔을 사용하여 에이전트 정보 보기

사전 구성된 Monitoring VM 인스턴스 대시보드에서 에이전트에 대한 상태 정보를 찾을 수 있습니다. 이 대시보드를 사용하려면 다음을 수행합니다.

Google Cloud 콘솔에서 VM 인스턴스 대시보드 페이지로 이동합니다.

VM 인스턴스 대시보드로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

대시보드의 인벤토리 탭에 있는 목록 보기에는 모든 VM이 나열되고 다음 스크린샷에 표시된 것처럼 에이전트의 상태 열이 포함됩니다.

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

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

감지되지 않음: 에이전트가 설치되어 있지 않거나 실행되고 있지 않습니다. 에이전트를 설치했는지 확실하지 않으면 설치된 버전을 쿼리하면 됩니다. 에이전트를 설치한 경우 에이전트를 다시 시작할 수 있습니다.
운영 에이전트: 운영 에이전트를 실행 중입니다. 항목 옆에 녹색 체크표시가 보이지 않으면 VM의 감지된 운영체제를 기반으로 에이전트 업그레이드를 사용할 수 있다는 것입니다.

테이블의 운영 에이전트 표시기에 마우스를 가져가면 운영 에이전트 버전에 대한 정보가 표시됩니다. 이전 버전을 실행 중인 경우 에이전트를 업그레이드하기 위한 권장사항도 표시됩니다.
대기 중: 운영 에이전트가 설치 중이거나 업그레이드 중입니다.
기존 에이전트: 기존 Monitoring 또는 Logging 에이전트를 실행 중입니다. 운영 에이전트로 전환하는 방법에 대한 자세한 내용은 기존 에이전트에서 운영 에이전트로 마이그레이션을 참조하세요.
해당 없음: 이 VM은 에이전트를 실행하는 데 지원되는 플랫폼이 아닙니다.
알 수 없음: VM이 실행되고 있지 않으므로 에이전트의 상태를 알 수 없습니다.

다음을 수행하여 운영 에이전트를 설치할 수 있습니다.

에이전트를 설치할 VM 인스턴스를 선택하세요.
인스턴스 테이블에서 운영 에이전트 설치/업데이트 옵션을 클릭합니다.

특정 VM의 VM 세부정보 페이지에서 운영 에이전트를 설치하거나 업데이트할 수도 있습니다.

가능한 경우 운영 에이전트 OS 정책을 사용하여 에이전트가 설치됩니다. 자세한 내용은 운영 에이전트 OS 정책이 적용되는 VM 관리를 참조하세요. 모든 운영체제의 모든 버전에서 운영 에이전트 OS 정책을 지원하지는 않습니다. 이 경우 운영 에이전트 설치/업데이트를 클릭하면 Cloud Shell에서 실행할 일련의 명령어가 제공됩니다.

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

선택적 작업

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

Monitoring 에이전트 구성

에이전트 구성을 조정하려면 Monitoring 에이전트 구성을 참조하세요.

HTTP 프록시 구성

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

Linux

다음 구성 파일을 수정합니다(아직 없는 경우 파일 생성).
- 에이전트 버전 6.0.0 이상에서는 다음을 수정합니다.
```
/etc/default/stackdriver-agent
```
- 6.0.0 이전 버전의 에이전트는 OS에 적절한 파일을 수정합니다.
  
  Debian 및 Ubuntu의 경우 다음을 수정합니다.
```
/etc/default/stackdriver-agent
```
  CentOS 및 SLES의 경우 다음을 수정합니다.
```
/etc/default/stackdriver-collectd
```
  참고: 이 파일이 존재하지 않으면 만드세요.

파일에 다음을 추가합니다.

 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.

VM 인스턴스에서 다음 명령어를 실행하여 에이전트를 다시 시작합니다.
```
 sudo service stackdriver-agent restart
```

Windows

HTTP 프록시를 사용하는 경우 관리자 명령 프롬프트에서 다음 명령어를 실행합니다. 그러면 에이전트에서 아웃바운드 HTTPS를 사용하여 데이터를 전송할 수 있도록 HTTP_PROXY 및 HTTPS_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

RDP 또는 유사한 도구를 사용하여 인스턴스에 연결하고 Windows에 로그인합니다.
PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행을 선택하여 관리자 권한이 있는 PowerShell 터미널을 엽니다.
다음 PowerShell 명령어를 실행합니다.

Restart-Service -Name StackdriverMonitoring

에이전트 업그레이드

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

Linux

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

sudo bash add-monitoring-agent-repo.sh --also-install

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

sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

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

모든 에이전트 버전 나열

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum list --showduplicates stackdriver-agent

DEBIAN / UBUNTU

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

sudo apt-cache madison stackdriver-agent

SLES / SUSE

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

sudo zypper search -s stackdriver-agent

WINDOWS

Windows에서 이전 버전의 에이전트 설치는 지원되지 않습니다.

에이전트 제거

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

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

Linux

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

sudo bash add-monitoring-agent-repo.sh --uninstall

필요한 경우 에이전트를 제거하는 것 외에도 저장소를 삭제하려면 --remove-repo를 이전 명령어에 추가합니다.

Windows

Windows 제어판에서 프로그램 제거를 선택합니다. 제거할 수 있는 프로그램 목록에 Monitoring 에이전트가 표시됩니다. Monitoring 에이전트를 설치한 디렉터리에서 uninstall.exe를 실행할 수도 있습니다.

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

Monitoring 에이전트를 설치하려면 에이전트 패키지 및 (Linux의 경우) 종속 항목의 원격 패키지 저장소에 대한 액세스가 필요합니다.

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

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

다음 단계

에이전트가 기본 구성을 사용하여 Cloud Logging으로 전송하는 로그에 대해 알아보기

개별 VM에 Monitoring 에이전트 설치

시작하기 전에

명령줄에서 에이전트 설치

최신 버전의 에이전트 설치

Linux

Windows

특정 버전의 에이전트 설치

Linux

Windows

Google Cloud 콘솔을 사용하여 에이전트 정보 보기

선택적 작업

Monitoring 에이전트 구성

HTTP 프록시 구성

Linux

Windows

에이전트 버전 확인

AMAZON LINUX AMI / CENTOS / RHEL

Debian / Ubuntu

SLES / SUSE

WINDOWS

에이전트 다시 시작

LINUX

Windows

에이전트 업그레이드

Linux

Windows

모든 에이전트 버전 나열

AMAZON LINUX AMI / CENTOS / RHEL

DEBIAN / UBUNTU

SLES / SUSE

WINDOWS

에이전트 제거

Linux

Windows

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

다음 단계