Desativar a coleta de métricas

Este documento descreve como desativar a API Cloud Monitoring para um projeto do Google Cloud e como impedir que o agente Ops e o agente de monitoramento legado coletem métricas de processo. Você pode desativar a API Cloud Monitoring, por exemplo, para evitar a ingestão de métricas sujeitas a cobrança em um projeto do Google Cloud.

Desativar a coleta de todas as métricas

Para impedir a coleta de todas as métricas, desative a API Cloud Monitoring:

Console

  1. No console do Google Cloud, selecione o projeto do Google Cloud e acesse a página APIs e serviços:

    Acessar APIs e serviços

  2. Selecione API Cloud Monitoring.

  3. Clique em Desativar API.

gcloud

Execute o comando a seguir para desativar a API Cloud Monitoring no seu projeto atual:

gcloud services disable monitoring.googleapis.com

Para informações sobre como desativar uma API usando a CLI do Google Cloud, consulte Como ativar e desativar serviços.

Desativar a coleta de métricas de processos

Há várias maneiras de desativar a coleta dessas métricas pelo agente de operações (versões 2.0.0 e posteriores) e pelo agente legado do Monitoring no Linux.

Os agentes são executados apenas em VMs do Compute Engine e, no caso do agente do Monitoring, VMs do Amazon Elastic Compute Cloud (EC2), esses procedimentos se aplicam apenas a essas plataformas.

Não é possível desativar a coleta pelo agente de operações se você estiver executando versões anteriores a 2.0.0 ou o agente do Monitoring legado no Windows. Se você quiser desativar a coleta dessas métricas no Windows, recomendamos fazer upgrade para o agente de operações versão 2.0.0 ou mais recente. Para mais informações, consulte Como instalar o agente de operações.

O procedimento geral é semelhante a este:

  1. Conecte-se à VM.

  2. Faça uma cópia do arquivo de configuração atual como um backup. Armazene a cópia de backup fora do diretório de configuração do agente para que o agente não tente carregar os dois arquivos. Por exemplo, o comando a seguir faz uma cópia do arquivo de configuração do agente do Monitoring no Linux:

    cp /etc/stackdriver/collectd.conf BACKUP_DIR/collectd.conf.bak

  3. Altere a configuração usando uma das opções descritas na seguinte:

  4. Reinicie o agente para escolher a nova configuração:

    • Agente do Monitoring: sudo service stackdriver-agent restart
    • Agente de operações: sudo service google-cloud-ops-agent restart

  5. Verifique se as métricas do processo não estão mais sendo coletadas para essa VM:

    1. Selecione Metrics Explorer.

    2. Clique em MQL.

    3. Para um recurso gce_instance, insira a seguinte consulta, substituindo VM_NAME pelo nome desta VM:

      fetch gce_instance
| metric 'agent.googleapis.com/processes/cpu_time'
| filter (metadata.system_labels.name == 'VM_NAME')
| align rate(1m)
| every 1m

      Para um recurso aws_ec2_instance, substitua gce_instance na consulta.

    4. Clique em Run.

Agente de operações no Linux ou no Windows

O local do arquivo de configuração do agente de operações depende do sistema operacional:

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

Para desativar a coleta de todas as métricas de processo pelo agente de operações, adicione o seguinte ao arquivo config.yaml:

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

Isso exclui as métricas de processo da coleta no processador metrics_filter que se aplica ao pipeline padrão no serviço metrics.

Para mais informações sobre as opções de configuração do agente de operações, consulte Como configurar o agente de operações.

Agente do Monitoring no Linux

Você tem as opções a seguir para desativar a coleta de métricas de processos com o agente do Monitoring legado:

As seções a seguir descrevem cada opção e listam os benefícios e riscos associados a ela.

Modificar o arquivo de configuração do agente

Essa opção permite editar diretamente o arquivo de configuração principal do agente, /etc/stackdriver/collectd.conf, para remover as seções que permitem a coleta das métricas do processo.

Procedimento

Há três grupos de exclusões que você precisa fazer no arquivo collectd.conf:

  1. Exclua a seguinte diretiva LoadPlugin e a configuração do plug-in:

    LoadPlugin processes

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

  2. Exclua a seguinte diretiva PostCacheChain e a configuração da cadeia 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>

  3. Exclua a cadeia MaybeThrottleProcesses usada pela cadeia PostCache:

    <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>
Benefícios e riscos
  • Benefícios
    • Você reduz os recursos consumidos pelo agente porque as métricas nunca são coletadas.
    • Se você fez outras mudanças no arquivo collectd.conf, talvez consiga preservar essas mudanças facilmente.
  • Riscos
    • Use a conta root para editar este arquivo de configuração.
    • Você corre o risco de introduzir erros tipográficos no arquivo.

Substituir o arquivo de configuração do agente

Com essa opção, você substitui o arquivo de configuração principal do agente por uma versão pré-editada com as seções relevantes removidas para você.

Procedimento

  1. Faça o download do arquivo pré-editado, collectd-no-process-metrics.conf, do repositório do GitHub para o diretório /tmp e faça o seguinte:

    cd /tmp && curl -sSO https://raw.githubusercontent.com/Stackdriver/agent-packaging/master/collectd-no-process-metrics.conf

  2. Substitua o arquivo collectd.conf atual pelo arquivo pré-editado:

    cp /tmp/collectd-no-process-metrics.conf /etc/stackdriver/collectd.conf
Benefícios e riscos
  • Benefícios
    • Você reduz os recursos consumidos pelo agente porque as métricas nunca são coletadas.
    • Não é necessário editar manualmente o arquivo como root.
    • As ferramentas de gerenciamento de configuração podem facilmente substituir um arquivo.
  • Riscos
    • Se você tiver feito outras alterações no arquivo collectd.conf, será necessário mesclar essas alterações no arquivo de substituição.

Solução de problemas

Os procedimentos descritos neste documento são alterações na configuração do agente. Portanto, os problemas a seguir são mais prováveis:

  • Privilégio insuficiente para editar os arquivos de configuração. Os arquivos de configuração precisam ser editados na conta root.
  • Introdução de erros tipográficos no arquivo de configuração, se você editá-lo diretamente.

Para informações sobre como resolver outros problemas, consulte Como solucionar problemas do agente do Monitoring.

Agente do Monitoring no Windows

Não é possível desativar a coleta de métricas do processo pelo agente do Monitoring legado em execução em VMs do Windows. Este agente não é configurável. Se você quiser desativar a coleta dessas métricas no Windows, recomendamos fazer upgrade para o agente de operações versão 2.0.0 ou mais recente. Para mais informações, consulte Como instalar o agente de operações.

Se você estiver executando o agente de operações, consulte Agente de operações no Linux ou no Windows.