Desativar a coleta de métricas

Este documento descreve como desativar a API Cloud Monitoring para um projetoGoogle Cloud e como impedir que o Agente de operações e o agente do Monitoring legados coletem métricas de processo. Por exemplo, talvez você queira desativar a API Cloud Monitoring para impedir a ingestão de métricas faturáveis em um projeto Google Cloud .

Desativar a coleta de todas as métricas

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

Console

  1. No console Google Cloud , selecione o projeto 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 seguinte comando para desativar a API Cloud Monitoring no projeto atual:

gcloud services disable monitoring.googleapis.com

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

Desativar a coleta de métricas de processo

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. Esses procedimentos se aplicam apenas a essa plataforma.

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. No console Google Cloud , acesse a página do  Metrics explorer:

      Acesse o Metrics Explorer

      Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

    2. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.

    3. Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

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

      rate({"agent.googleapis.com/processes/cpu_time", monitored_resource="gce_instance", metadata_system_name="VM_NAME"}[1m])

    5. Selecione Executar consulta.

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.