[GCP] VM의 Disk, Memory 수집을 위한 Ops Agent 설치

설치 개요

클라우드 정책 상 Memory, Disk 정보는 기본으로 제공을 하지 않는다.

AWS, Azure, GCP 모두 마찬가지이며, 해당 utilization이나 기타 추가적인 메트릭을 수집을 원하면 각 벤더 마다 지원하는 agent를 설치해서 수집을 진행해야한다.
GCP는 기존에 Stack Driver Agent를 설치하는 듯 했으나 곧 지원 종료로 보이며, 현재는 Ops Agent 설치를 권장하고 있다.

 

공통 기본 설정

Cloud Monitoring API 사용 체크 (API 활성화)

https://console.cloud.google.com/apis/api/monitoring/metrics

 

역할 생성

monotoring.timeSerires.create 권한이 필요하다

 

역할 추가

생성한 역할을 서비스 어카운트에 추가한다.

새 주 구성원에 서비스 어카운트를 입력해주고 역할 선택에서 커스텀을 확인하면 위에서 만든 역할 명이 존재한다.

 

Linux

인스턴스 생성

부팅 디스크 : Linux 계열 OS 지정 (예제 : Ubuntu 18.04LTS)

ID 및 액세스 - 서비스 계정 : monitoring.timeSeries.create 역할을 할당한 서비스 계정 지정 필요

 

Ops Agent 설치

인스턴스 ssh 접속 후 아래 설치 명령어 실행 

 

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

 

확인

- 서비스 정상 동작 확인

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

sudo service google-cloud-ops-agent status *

active가 떴다면 정상 설치 완료

 

- 버전 확인

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

- 설정을 바꿨다면 다시 재시작

sudo service google-cloud-ops-agent restart

 

따로 메트릭 설정을 커스텀하게 하려면 /etc/google-cloud-ops-agent/config.yaml 수정. (mem, disk등 기본적인 메트릭 수집만 체크 하려면 따로 설정은 안건드려도 됨)

 

Windows

인스턴스 생성

부팅 디스크 : Windows 계열 OS 지정 (예제 : Windows Server 2016 Datacenter)

ID 및 액세스 - 서비스 계정 : monitoring.timeSeries.create 역할을 할당한 서비스 계정 지정 필요

 

Ops Agent 설치

인스턴스 RDP 접속

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"

확인

- 서비스 정상 동작 확인

googet installed google-cloud-ops-agent

 

 

Linux, Windows 모두 설치가 완료되면 Memory, Disk Utilization 정보가 수집된다.

 

Trouble Shooting

공식 가이드대로 설치를 다 진행했는데 Monitoring Dashboard에서는 계속 Agent 설치를 하라고 뜨고 아무런 정보를 수집을 못했다.

막상 VM에 접속하여 Agent 상태 체크를 했을 때는 정상적으로 설치되어 있고 Active 상태인데 수집되는 데이터는 없는 상황.

수집 로그를 확인해보니 결국 권한 이슈 였다.(/var/log -> vi syslog 확인)

VM 생성시 자동으로 지정되는 어카운트가 아니라 서비스 어카운트를 선택했고, 해당 서비스 어카운트에 monitoring.timeSeries.create 권한을 줬어야 했다.

권한 적용 후 정상적으로 메트릭이 수집되는 것을 확인했다.

 

느낀점

gcp는 권한이 참 어렵다.....

 

참고 문서

에이전트 설치 Linux https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent/installation?hl=ko

에이전트 설치 Windows https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent/installation?hl=ko#agent-install-latest-windows

문제 해결 https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent/troubleshooting