[GCP] Ops Agent

안녕하세요 MC에몽입니다.

 

이번주는 GCP에서 제공하는 Google Compute Engine 인스턴스에서 원격으로 Monitoring Metric 및 Log를 수집 할 수 있는 에이전트, Ops Agent를 소개하겠습니다.

 

Ops Agent를 각 인스턴스에 설치하여 추가적인 Log 및 Metric을 Cloud Logging과 Cloud Monitoring에 전송하여 인스턴스의 상태에 대한 더 자세한 정보 확인 및 감시를 할 수 있습니다.

 

또한 Ops Agent는 Monitoring 에이전트 와 Logging 에이전트를 하나의 에이전트로 통합하여 사용할 수 있으며 다운로드 및 설치도 매우 간단합니다.

 

표준 Linux & Windows 운영체제에서 지원되며 자세한 지원 운영체제 리스트는 해당 문서[1] 에서 확인 할 수 있습니다.

 

다만 일부 Metric의 경우 Linux 운영체제에서 실행되는 VM에서만 측정 가능함으로 해당 항목[2]을 참고 부탁 드립니다.

 

에이전트를 설치하기 전 다음과 같은 액세스 요구사항이 존재합니다.

 

에이전트를 설치하려면 다음 DNS 이름에 액세스해야 합니다.

• Google Cloud Package Repository: packages.cloud.google.com

 

에이전트를 실행하려면 다음 DNS 이름에 액세스해야 합니다.

• OAuth2 토큰 서버: www.googleapis.com
• Monitoring API: monitoring.googleapis.com
• Logging API: logging.googleapis.com

 

에이전트를 실행하려면 머신에서 다음 포트가 열려 있어야 합니다.

• 20201
• 20202

그러면 실제 Ops Agent를 GCE 인스턴스에 설치하는 방법을 알아보겠습니다.

 

Ops Agent는 VM 인스턴스에 직접 연결하여 설치 하거나, Google Cloud 콘솔 상에서 설치 할 수 있습니다.

 

 

1. VM 인스턴스에 직접 연결하여 Agent 설치

1) SSH 등의 방법으로 VM 인스턴스에 연결합니다.

 

2) 아래 명령어를 실행합니다.

 

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

 

※ 최신 버전이 아닌 특정 버전의 agent를 설치하고 싶은 경우 --version flag를 추가합니다.

 

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

  --version=1.*.*

 

2. Google Cloud Console을 사용하여 Agent 설치

 

 

1) Cloud Monitoring으로 이동합니다.

 

2) Monitoring 탐색창에서 Dashboards를 선택합니다.

 

3) Dashboard에 VM Instances를 검색하여 VM Instances Dashboard로 들어갑니다.

 

4) 대시보드 테이블에서 Ops Agent를 설치하고자 하는 인스턴스를 선택 후 Install/Update Agents를 클릭.

 

5) Run in Cloud Shell을 눌러 설치를 진행합니다.

 

※ Compute Engine의 Observability 탭에서도 Ops Agent를 설치 할 수 있습니다.

 

 

※ Console 상에서 Ops Agent 설치 시, Cloud Shell을 통해 해당 VM에 접속하여 설치하는 방식 이므로 Cloud Shell 접속을 허용하는 방화벽 정책을 구성해야 합니다.

 

오늘은 GCP상에서 Logging & Monitoring 을 돕는 유용한 Tool인 Ops Agent와 설치 방법에 대해 알아 보았습니다.

다음 시간에도 유익한 정보로 찾아오겠습니다.

 

See you next time!

 

참고문헌 : 

[1] https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent#supported_operating_systems

[2] https://cloud.google.com/monitoring/api/metrics_opsagent