Fim do suporte aos agentes legados do Monitoring e do Logging

Importante: essa descontinuação se aplica apenas a ambientes em que você instalou o agente legado do Monitoring ou do Logging, não a ambientes gerenciados com agentes de monitoramento e geração de registros integrados ou pré-instalados.

A partir de 28 de setembro de 2026, os agentes legados do Monitoring e do Logging não terão mais suporte. Não vamos mais lançar novas versões desse software, e todo o suporte e manutenção padrão foram encerrados.

As instalações atuais dos agentes legados não serão encerradas e vão continuar transmitindo registros para o Cloud Logging e métricas para o Cloud Monitoring, mas o uso desses agentes não é mais recomendado. No entanto, as distribuições continuam disponíveis para download e instalação.

Se você continuar usando os agentes legados, não vai receber atualizações, correções de bugs ou suporte para novos sistemas operacionais, o que pode levar à incompatibilidade com o Google Cloud Observability. Recomendamos migrar para uma alternativa compatível.

Pontos principais e datas

Confira as datas importantes para a descontinuação do agente legado do Logging:

• Em 28 de setembro de 2026, a manutenção padrão e as correções de bugs regulares para os agentes legados serão encerradas. Um período de carência de 12 meses para a migração começa. Durante esse período, o Cloud Customer Care vai ajudar nos esforços de migração por meio de tíquetes de suporte.
• Em 28 de setembro de 2027, a assistência para migração do Cloud Customer Care será encerrada oficialmente. Após essa data, você será responsável por lidar com a migração de forma independente.

Opções de migração

Recomendamos migrar para uma das seguintes alternativas compatíveis o mais rápido possível:

• Agente de operações:o principal e o preferido para coletar telemetria das instâncias do Compute Engine. Esse agente combina a geração de registros e as métricas em um único agente, fornecendo configurações baseadas em YAML para coletar registros e métricas e apresenta a geração de registros de alta capacidade. Para mais informações, consulte Como migrar dos agentes legados para o Agente de Operações.
• Coletor do OpenTelemetry criado pelo Google:build pronto para produção do Google do coletor do OpenTelemetry de código aberto. Ele permite enviar traces, métricas e registros correlacionados do protocolo OpenTelemetry (OTLP) para o Google Cloud Observability e outros back-ends de aplicativos. Para mais informações, consulte Visão geral do coletor do OpenTelemetry criado pelo Google.
• Fluentd upstream (somente geração de registros): o coletor de dados de registro de código aberto e orientado pela comunidade em que o agente do Logging legado foi criado. Muitos ambientes legados usam configurações do Fluentd altamente personalizadas que não podem ser traduzidas para o Agente de Operações. Ao parear o Fluentd upstream com os plug-ins da plataforma do Google, é possível manter as configurações atuais e garantir que os registros continuem fluindo para o Cloud Logging sem interrupções. Para mais informações, consulte Migrar do agente do Logging legado para o Fluentd upstream.

Identificar instâncias afetadas do Compute Engine

Para identificar instâncias do Compute Engine que executam o agente de monitoramento legado ou o agente do Logging legado, siga estas etapas:

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 com o nome  PromQL.
3. No painel Resultados, selecione Tabela.
4. Digite uma das consultas a seguir no editor e clique em Executar consulta:
   • Para gerar uma tabela que lista a instância de ID de cada VM que executa um agente, junto com a versão do agente, use:

     max by (instance_id, version, ${__groupby}) ({__name__="agent.googleapis.com/agent/uptime", monitored_resource="gce_instance"})
             

   • Para gerar uma tabela que mostre o número total de instâncias que executam cada versão do agente, use:

     count by (version, ${__groupby}) ({__name__="agent.googleapis.com/agent/uptime", monitored_resource="gce_instance"})
             

   Na coluna versão, as entradas que mostram stackdriver_agent se referem ao agente legado do Monitoring, enquanto as entradas que mostram google-fluentd se referem ao agente legado do Logging.