O agente do Monitoring é um daemon baseado em collectd que reúne métricas de sistemas e aplicativos das instâncias de máquina virtual e as envia ao Monitoring. Por padrão, o agente do Monitoring coleta métricas de processo, disco, CPU e rede. É possível configurar o agente do Monitoring a fim de monitorar aplicativos de terceiros e receber a lista completa de métricas do agente.
Para instalar o agente, consulte Como instalar o agente do Monitoring.
Finalidade
O uso do agente do Monitoring é opcional, mas recomendado. O Monitoring pode acessar algumas métricas de instância sem o agente do Monitoring, inclusive a utilização da CPU, algumas métricas de tráfego do disco, tráfego de rede e informações do tempo de atividade. O Monitoring usa o agente do Monitoring para acessar recursos de sistema adicionais e serviços de aplicativo em instâncias de máquina virtual (VM, na sigla em inglês). Para ter acesso a esses outros recursos, é preciso instalar o agente do Monitoring.
Depois de instalar o agente do Monitoring, é possível monitorar aplicativos de terceiros compatíveis adicionando configurações collectd específicas do aplicativo. Consulte Como monitorar aplicativos de terceiros para detalhes.
Para uma lista completa das métricas internas que podem ser acessadas com o agente do Monitoring, consulte Métricas do agente.
Para enviar métricas personalizadas para o Monitoring usando o agente, consulte Como monitorar aplicativos personalizados. Se você tiver acesso ao código-fonte do aplicativo, talvez seja mais prático instrumentá-lo com OpenTelemetry. Para mais informações sobre a instrumentação, consulte Instrumentação e observabilidade.
Configurações aceitas
O agente do Monitoring é compatível com os ambientes a seguir.
Instâncias de máquina virtual
É possível instalar o agente do Monitoring nos seguintes tipos de instâncias de VM:
Instâncias do Compute Engine. O agente do Monitoring envia informações de monitoramento para cada projeto associado à instância.
Para instâncias sem endereços IP externos, ative o Acesso privado do Google para que o agente do Monitoring envie métricas.
Para criar uma instância do Compute Engine, consulte o guia de primeiros passos do Compute Engine.
Instâncias do Amazon Elastic Compute Cloud (Amazon EC2).
O agente do Monitoring envia informações de monitoramento da AWS para um projeto do Google Cloud.
Para que o agente do Monitoring funcione corretamente, a instância do Amazon EC2 na qual ele é executado precisa ser capaz de se comunicar com as APIs do Google Cloud, especialmente a API Monitoring. Isso requer um endereço IP externo ou um gateway NAT.
Para criar uma instância do Amazon EC2, consulte o Guia explicativo do Amazon EC2.
Os tipos de instâncias de VM a seguir pertencem a serviços gerenciados que implementam o suporte do Monitoring específico do serviço. Não tente instalar ou configurar manualmente o agente do Monitoring neles:
- O padrão do App Engine inclui suporte integrado do Monitoring. Os agentes não são necessários.
- As instâncias do ambiente flexível do App Engine têm agentes pré-instalados com configurações específicas do serviço.
- As instâncias do Dataflow têm agentes pré-instalados do Monitoring com configurações específicas do serviço.
As instâncias do Dataproc anteriores à versão 2.2 da imagem têm agentes do Monitoring pré-instalados com configurações específicas do serviço.
É possível instalar o Agente de operações em clusters do Dataproc que usam a versão 2.2 e posterior da imagem para coletar registros syslog e métricas de host. Para mais informações, consulte Versões de lançamento do Dataproc 2.2.x.
- Instâncias de nó do Google Kubernetes Engine:
- Os clusters do GKE no Google Cloud são configurados para coletar registros e métricas com o Logging e o Monitoring por padrão. Também é possível configurar a coleta de métricas e registros para clusters de contêiner que já existem. Para mais informações, consulte Como configurar a geração de registros e o monitoramento para o GKE.
- Instâncias do Google Distributed Cloud têm uma solução integrada de geração de registros e monitoramento que coleta o status dos componentes do sistema. Para mais informações, consulte Como realizar o monitoramento e a geração de registros.
Sistemas operacionais
O agente do Monitoring oferece suporte aos seguintes sistemas operacionais em instâncias de VM compatíveis:
Sistemas operacionais Linux
O agente do Monitoring é compatível com os seguintes sistemas operacionais Linux:
- Amazon Linux AMI
- CentOS 7
- CentOS 8
- Rocky Linux 8
- RHEL 7: rhel-7, rhel-7-6-sap-ha, rhel-7-7-sap-ha
- RHEL 8: rhel-8, rhel-8-4-sap-ha, rhel-8-6-sap-ha, rhel-8-8-sap-ha
- Debian 9 (Stretch)
- Debian 10 (Buster)
- Debian 11 (Bullseye)
- SLES 12: sles-12, sles-12-sp5-sap
- SLES 15: sles-15, sles-15-sp2-sap, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap
- OpenSUSE Leap 15: opensuse-leap (opensuse-leap-15-3-*, opensuse-leap-15-4-*)
- Ubuntu 20.04 LTS (Focal Fossa): ubuntu-2004-lts, ubuntu-minimal-2004-lts
No momento, o agente do Monitoring não é compatível com o SO otimizado para contêineres que é o padrão nos clusters do Google Kubernetes Engine.
Sistemas operacionais Windows:
Todas as versões do agente do Monitoring são compatíveis com os seguintes sistemas operacionais Windows:
- Windows Server 2019
- Windows Server Core 2019
- Windows Server 2016.
- Windows Server Core 2016
No momento, o agente do Monitoring não oferece suporte ao Windows Server Core 2019 para contêineres.
Aplicativos compatíveis
É possível configurar o Monitoring para acompanhar uma variedade de aplicativos de software de código aberto conhecidos. A configuração só é possível para agentes em execução no Linux. Os agentes em execução no Windows podem monitorar aplicativos IIS e MS SQL, mas não são configuráveis para outros aplicativos.
Para mais informações, consulte Como monitorar aplicativos de terceiros.
Requisitos de acesso do agente
Para executar o agente, é preciso ter acesso aos seguintes nomes de DNS:
Servidor de token OAuth2:
oauth2.googleapis.comAs versões mais recentes do agente podem exigir acesso a
www.googleapis.com. URL completo:https://www.googleapis.com/oauth2/v3/token.Se você estiver usando uma versão antiga do agente, recomendamos atualizar o agente para a versão mais recente.
APIs de monitoramento:
monitoring.googleapis.com
Para instalar o agente, é preciso ter acesso aos seguintes nomes DNS:
(Linux) Repositório de pacotes do Google Cloud:
packages.cloud.google.com(Linux) Subdomínio de downloads do Google:
dl.google.comServidor de download do Stackdriver legado para Windows:
repo.stackdriver.com
Como conseguir o código-fonte do agente do Monitoring
O código-fonte do agente do Monitoring está disponível apenas para o agente hospedado no Linux. O agente do Monitoring hospedado no Windows não é de código aberto.
O agente do Monitoring é instalado por um script descrito nas instruções de instalação. Você pode pular esta seção se quiser apenas instalar e usar o agente. Se você quiser entender o código-fonte, leia esta seção.
O agente do Monitoring, stackdriver-agent, é baseado no
daemon de coleta de estatísticas do
sistema collectd original. O código-fonte stackdriver-agent está disponível em Stackdriver/collectd.
Os scripts de build e de pacote do agente do Monitoring estão
disponíveis em Stackdriver/agent-packaging.
Os arquivos de configuração de aplicativos de terceiros estão no Repositório de configurações do GitHub do agente.
O pacote de software para stackdriver-agent contém:
- o daemon do collectd;
- As bibliotecas compartilhadas do plug-in, incluindo o plug-in de saída da API do Cloud Monitoring.
- os arquivos de configuração de nível superior do agente do Monitoring.
Política de suspensão de uso
O agente do Monitoring está sujeito à Política de suspensão de uso de agentes.
Para informações sobre a descontinuação de recursos e versões legadas, consulte Descontinuações do Google Cloud Observability.
A seguir
- Consulte o guia de início rápido para monitorar uma instância de VM que executa um servidor da Web do Apache. O guia inclui a instalação do agente.
- Consulte Como instalar o agente do Monitoring para instalar o agente em instâncias de VM do Compute Engine ou do Amazon EC2.