측정항목 수집 중지

이 문서에서는 Google Cloud 프로젝트에 대해 Cloud Monitoring API를 사용 중지하는 방법과 운영 에이전트 및 레거시 Monitoring 에이전트가 프로세스 측정항목을 수집하지 못하도록 하는 방법을 설명합니다. 예를 들어 청구 가능한 측정항목을 Google Cloud 프로젝트로 수집하지 않도록 방지하기 위해 Cloud Monitoring API를 사용 중지해야 할 수 있습니다.

모든 측정항목 수집 사용 중지

모든 측정항목 수집을 방지하려면 Cloud Monitoring API를 사용 중지합니다.

Console

Google Cloud 콘솔에서 Google Cloud 프로젝트를 선택한 후 API 및 서비스 페이지로 이동합니다.

API 및 서비스로 이동
Cloud Monitoring API를 선택합니다.
API 사용 중지를 클릭합니다.

gcloud

다음 명령어를 실행하여 현재 프로젝트에서 Cloud Monitoring API를 사용 중지합니다.

gcloud services disable monitoring.googleapis.com

Google Cloud CLI를 사용하여 API를 사용 중지하는 방법은 서비스 사용 설정 및 사용 중지를 참조하세요.

프로세스 측정항목 수집 사용 중지

Linux에서 운영 에이전트(버전 2.0.0 이상) 및 레거시 Monitoring 에이전트에 따라 이러한 측정항목의 수집을 사용 중지할 수 있는 여러 방법이 있습니다.

에이전트는 Compute Engine VM에서만 실행되며 Monitoring 에이전트의 경우 Amazon Elastic Compute Cloud(EC2) VM에서 실행됩니다. 이 절차는 해당 플랫폼에만 적용됩니다.

Windows에서 2.0.0 미만 버전 또는 레거시 Monitoring 에이전트를 실행하는 경우 운영 에이전트의 수집을 사용 중지할 수 없습니다. Windows에서 이러한 측정항목의 수집을 사용 중지하려면 운영 에이전트 버전 2.0.0 이상으로 업그레이드하는 것이 좋습니다. 자세한 내용은 운영 에이전트 설치를 참조하세요.

일반적인 절차는 다음과 같습니다.

VM에 연결합니다.
기존 구성 파일을 백업으로 복사합니다. 에이전트가 두 파일 모두 로드를 시도하지 않도록 에이전트의 구성 디렉터리 외부에 백업 복사본을 저장합니다. 예를 들어 다음 명령어는 Linux에서 Monitoring 에이전트에 대해 구성 파일을 복사합니다.
```
cp /etc/stackdriver/collectd.conf BACKUP_DIR/collectd.conf.bak
```
다음과 같이 설명된 옵션 중 하나를 사용하여 구성을 변경합니다.
- Linux 또는 Windows의 운영 에이전트
- Linux의 Monitoring 에이전트
에이전트를 다시 시작하여 새 구성을 선택합니다.
- Monitoring 에이전트: sudo service stackdriver-agent restart
- 운영 에이전트: sudo service google-cloud-ops-agent restart
이 VM에 대해 프로세스 측정항목이 더 이상 수집되지 않는지 확인합니다.
1. 측정항목 탐색기를 선택합니다.
2. MQL을 클릭합니다.
3. gce_instance 리소스에 대해 VM_NAME을 이 VM의 이름으로 바꿔 다음 쿼리를 입력합니다.
```
fetch gce_instance
| metric 'agent.googleapis.com/processes/cpu_time'
| filter (metadata.system_labels.name == 'VM_NAME')
| align rate(1m)
| every 1m
```
  aws_ec2_instance 리소스의 경우 쿼리에서 gce_instance를 바꿉니다.
4. 쿼리 실행을 클릭합니다.

Linux 또는 Windows의 운영 에이전트

운영 에이전트의 구성 파일 위치는 운영체제에 따라 달라집니다.

Linux: /etc/google-cloud-ops-agent/config.yaml
Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

운영 에이전트의 모든 프로세스 측정항목 수집을 사용 중지하려면 다음을 config.yaml 파일에 추가합니다.

metrics:
  processors:
    metrics_filter:
      type: exclude_metrics
      metrics_pattern:
      - agent.googleapis.com/processes/*

이렇게 하면 metrics 서비스의 기본 파이프라인에 적용되는 metrics_filter 프로세서의 수집에서 프로세스 측정항목이 제외됩니다.

운영 에이전트의 구성 옵션에 대한 자세한 내용은 운영 에이전트 구성을 참조하세요.

Linux의 Monitoring 에이전트

레거시 Monitoring 에이전트로 프로세스 측정항목 수집을 사용 중지하는 옵션은 다음과 같습니다.

에이전트의 구성 파일을 수정합니다.
에이전트의 구성 파일을 바꿉니다.

다음 섹션에서는 각 옵션에 대해 설명하고 이 옵션과 관련된 이점과 위험을 설명합니다.

에이전트의 구성 파일 수정

이 옵션을 사용하면 에이전트의 기본 구성 파일인 /etc/stackdriver/collectd.conf를 직접 수정하여 프로세스 측정항목 수집을 사용 설정하는 섹션을 삭제할 수 있습니다.

절차

collectd.conf 파일에 세 가지 삭제 그룹을 만들어야 합니다.

다음 LoadPlugin 지시어와 플러그인 구성을 삭제합니다.

LoadPlugin processes

<Plugin "processes">
  ProcessMatch "all" ".*"
  Detail "ps_cputime"
  Detail "ps_disk_octets"
  Detail "ps_rss"
  Detail "ps_vm"
</Plugin>

다음 PostCacheChain 지시어와 PostCache 체인 구성을 삭제합니다.

PostCacheChain "PostCache"

<Chain "PostCache">
  <Rule "processes">
    <Match "regex">
      Plugin "^processes$"
      Type "^(ps_cputime|disk_octets|ps_rss|ps_vm)$"
    </Match>
    <Target "jump">
      Chain "MaybeThrottleProcesses"
    </Target>
    Target "stop"
  </Rule>

  <Rule "otherwise">
    <Match "throttle_metadata_keys">
      OKToThrottle false
      HighWaterMark 5700000000  # 950M * 6
      LowWaterMark 4800000000  # 800M * 6
    </Match>
    <Target "write">
       Plugin "write_gcm"
    </Target>
  </Rule>
</Chain>

PostCache 체인에서 사용되는 MaybeThrottleProcesses 체인을 삭제합니다.

<Chain "MaybeThrottleProcesses">
  <Rule "default">
    <Match "throttle_metadata_keys">
      OKToThrottle true
      TrackedMetadata "processes:pid"
      TrackedMetadata "processes:command"
      TrackedMetadata "processes:command_line"
      TrackedMetadata "processes:owner"
    </Match>
    <Target "write">
       Plugin "write_gcm"
    </Target>
  </Rule>
</Chain>

이점 및 위험

이점
- 측정항목은 수집되지 않으므로 에이전트에서 사용하는 리소스가 줄어듭니다.
- collectd.conf 파일을 변경한 경우 이러한 변경사항을 쉽게 보존할 수 있습니다.
위험
- 이 구성 파일을 수정하려면 root 계정을 사용해야 합니다.
- 파일에 오타가 발생할 위험이 있습니다.

에이전트의 구성 파일 바꾸기

이 옵션을 사용하면 관련 섹션이 삭제된 사전 수정 버전의 에이전트 기본 구성 파일이 대체됩니다.

절차

GitHub 저장소에서 /tmp 디렉터리로 사전 수정 collectd-no-process-metrics.conf 파일을 다운로드한 후 다음을 수행합니다.
```
cd /tmp && curl -sSO https://raw.githubusercontent.com/Stackdriver/agent-packaging/master/collectd-no-process-metrics.conf
```

기존 collectd.conf 파일을 사전 수정 파일로 바꿉니다.

cp /tmp/collectd-no-process-metrics.conf /etc/stackdriver/collectd.conf

이점 및 위험

이점
- 측정항목은 수집되지 않으므로 에이전트에서 사용하는 리소스가 줄어듭니다.
- 파일을 root로 직접 수정할 필요는 없습니다.
- 구성 관리 도구를 사용하면 파일을 쉽게 바꿀 수 있습니다.
위험
- collectd.conf 파일을 변경한 경우 이러한 변경 사항을 대체 파일에 병합해야 합니다.

문제 해결

이 문서에서 설명하는 절차는 에이전트의 구성을 변경하므로 다음과 같은 문제가 발생할 가능성이 높습니다.

구성 파일을 수정할 수 있는 권한이 없습니다. 구성 파일은 root 계정에서 수정해야 합니다.
구성 파일을 직접 수정하는 경우 구성 파일에 입력 오류가 발생합니다.

다른 문제 해결에 대한 자세한 내용은 Monitoring 에이전트 문제 해결을 참조하세요.

Windows의 Monitoring 에이전트

Windows VM에서 실행되는 레거시 Monitoring 에이전트의 프로세스 측정항목 수집을 사용 중지할 수 없습니다. 이 에이전트는 구성 가능하지 않습니다. Windows에서 이러한 측정항목의 수집을 사용 중지하려면 운영 에이전트 버전 2.0.0 이상으로 업그레이드하는 것이 좋습니다. 자세한 내용은 운영 에이전트 설치를 참조하세요.

운영 에이전트를 실행하는 경우 Linux 또는 Windows의 운영 에이전트를 참조하세요.