Como instalar o Agente de operações em VMs individuais

O agente de operações coleta registros e métricas em instâncias do Compute Engine, enviando registros para o Cloud Logging e métricas para o Cloud Monitoring.

Antes de começar

Para instalar o agente, verifique se você tem os seguintes itens:

Instalar o agente automaticamente durante a criação da VM

Para mais informações, consulte Instalar o Agente de operações durante a criação da VM.

Instalar o agente pela linha de comando

Para instalar o agente usando a linha de comando, siga as instruções abaixo.

Instalar a versão mais recente do agente de operações

Para instalar a versão mais recente do agente, conclua as etapas a seguir.

Linux

  1. Abra uma conexão de terminal com a instância de VM usando SSH ou uma ferramenta semelhante e verifique se você tem acesso a sudo.

  2. Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

  3. Faça o download e execute o script de instalação do agente usando os seguintes comandos:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
sudo bash add-google-cloud-ops-agent-repo.sh --also-install

    Depois de instalado, o agente é iniciado automaticamente.

Windows

  1. Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.

  2. Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

  3. Execute os seguintes comandos do PowerShell:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"

Como instalar uma versão específica do agente

Para instalar uma versão específica do agente, conclua as etapas a seguir.

Linux

  1. Abra uma conexão de terminal com a instância de VM usando SSH ou uma ferramenta semelhante e verifique se você tem acesso a sudo.

  2. Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

  3. Faça o download do script de instalação do agente:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh

    Ao executar o script add-google-cloud-ops-agent-repo.sh, também é possível definir as seguintes sinalizações:

    • --verbose: ativa o registro detalhado durante a execução do script.
    • --also-install: instala o agente após adicionar o repositório de pacotes.
    • --version: define a versão do agente a ser instalada pelo script. Para saber mais sobre as versões, consulte Listar todas as versões do agente.
    • --uninstall: desinstala o agente.
    • --remove-repo: remove o repositório do pacote do agente correspondente depois de instalar ou desinstalar o agente.
    • --dry-run: aciona apenas uma simulação da execução do script e imprime os comandos que ele precisa executar.
    • --uninstall-standalone-logging-agent: desinstala o agente do Logging legado (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: desinstala o agente legado do Monitoring (StackdriverMonitoring).

    Consulte os comentários do script para mais informações e exemplos de uso.

  4. Adicione o repositório de pacotes do agente e instale-o:

    1. Para listar as versões disponíveis do agente, consulte Listar todas as versões do agente.

    2. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar instalar versões principais que podem incluir mudanças incompatíveis com versões anteriores. Para fixar em uma versão principal, execute:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

      Por exemplo, para fixar no 1.x.x do agente, execute:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=1.*.*

    3. Para instalar uma versão específica do agente, execute:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION

Exclua o script de instalação depois que ele for executado com sucesso.

  • Para verificar se o agente está funcionando conforme o esperado, execute:

    sudo systemctl status google-cloud-ops-agent"*"

    Verifique se os componentes "Agente do Logging" e "Agente de Métricas" estão em execução.

Se você tiver problemas com a instalação, consulte a página Solução de problemas.

Windows

  1. Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.

  2. Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

  3. Faça o download do script de instalação do agente:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")

    Ao executar o script add-google-cloud-ops-agent-repo.ps1, também é possível definir as seguintes sinalizações:

    • -Verbose: ativa o registro detalhado durante a execução do script.
    • -AlsoInstall: instala o agente após adicionar o repositório de pacotes.
    • -Version: define a versão do agente a ser instalada pelo script. Para saber mais sobre as versões, consulte Listar todas as versões do agente.
    • -Uninstall: desinstala o agente.
    • -RemoveRepo: remove o repositório do pacote do agente correspondente depois de instalar ou desinstalar o agente.
    • -WhatIf: aciona apenas uma simulação da execução do script e imprime os comandos que ele precisa executar.
    • -UninstallStandaloneLoggingAgent: desinstala o agente do Logging legado (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: desinstala o agente legado do Monitoring (StackdriverMonitoring).

    Consulte os comentários do script para mais informações e exemplos de uso.

  4. Adicione o repositório de pacotes do agente e instale-o:

    1. Para listar as versões disponíveis do agente, consulte Listar todas as versões do agente.

    2. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar instalar versões principais que podem incluir mudanças incompatíveis com versões anteriores. Para fixar em uma versão principal, execute:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"

      Por exemplo, para fixar no 1.x.x do agente, execute:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"

    3. Para instalar uma versão específica do agente, execute:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"

      Exemplo:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"

Exclua o script de instalação depois que ele for executado com sucesso.

  • Para verificar se o agente está funcionando conforme o esperado, execute:

    Get-Service google-cloud-ops-agent

    O status do agente precisa ser Running.

Se você tiver problemas com a instalação, consulte a página Solução de problemas.

Instalar o agente usando o console do Google Cloud

É possível instalar o Agente de operações em uma ou mais VMs do Compute Engine usando o console do Google Cloud nas páginas do Cloud Monitoring ou do Compute Engine.

Cloud Monitoring

No Console do Google Cloud, acesse a página painel de Instâncias de VM.

Acessar o painel de instâncias de VM

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

A visualização Lista na guia Inventário do painel lista todas as VMs e inclui uma coluna de status para seu agente, conforme mostrado na captura de tela a seguir:

O painel "Instâncias de VM" no Monitoring mostra o status dos agentes.

A coluna Agente informa os seguintes valores:

  • Não detectado: você não tem um agente instalado ou ele não está em execução. Se você não tiver certeza se instalou um agente, consulte a versão instalada. Se você já instalou o agente, é possível reiniciá-lo. Se você tiver instalado e iniciado o Agente de operações, mas o status permanecer Não detectado, talvez o agente não tenha sido iniciado corretamente ou não consiga enviar métricas.

    Para solucionar problemas de inicialização, consulte O agente está instalado, mas não em execução. Para resolver problemas de ingestão de métricas, consulte Resolver problemas de ingestão de dados. O script de diagnóstico do agente geral e as verificações de integridade também podem ser úteis.

  • Agente de operações: você está executando o agente de operações. Se você não vir uma marca de seleção verde ao lado da entrada, isso significa que há um upgrade de agente disponível, baseado no sistema operacional detectado da sua VM.

    Ao passar o cursor sobre o indicador "Agente de operações" na tabela, você vê informações sobre a versão. Se você estiver executando uma versão mais antiga, também vai ver uma recomendação para fazer upgrade do agente.

  • Pendente: o agente de operações está sendo instalado ou atualizado.

    Se a instalação do agente permanecer Pendente por mais de 10 minutos, talvez haja um problema ao aplicar a política do SO do agente de operações ou iniciar o agente. Para informações de solução de problemas, consulte Ferramenta de diagnóstico de agente para políticas de instalação automática.

  • Agente legado: você está executando o agente legado do Monitoring ou do Logging. Consulte Como migrar dos agentes legados para o agente de operações para informações sobre como fazer a transição para o agente de operações.

  • Não aplicável: esta VM não é uma plataforma compatível para executar o agente.

  • Desconhecido: a VM não está em execução, então o status do agente é desconhecido.

É possível instalar o Agente de operações fazendo o seguinte:

  • Selecione as instâncias de VM em que você quer instalar agentes.
  • Clique na opção Instalar/atualizar Agente de operações na tabela Instâncias.

Também é possível instalar ou atualizar o Agente de operações na página Detalhes da VM de uma VM específica.

Quando possível, o agente é instalado usando uma política de SO do agente de operações. Para mais informações, consulte Gerenciar VMs cobertas pela política de SO do agente de operações. As políticas de SO do agente de operações não são compatíveis com todas as versões de todos os sistemas operacionais. Nesse caso, clicar em Instalar/atualizar Agente de operações fornece uma série de comandos a serem executados no Cloud Shell.

Por padrão, o agente de operações coleta métricas e registros. É possível alterar esse comportamento padrão configurando o agente de operações.

Compute Engine

  1. No Console do Google Cloud, acesse a página Instâncias de VM.

    Acessar Instâncias de VM

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

  2. Clique no nome da VM em que você quer instalar o agente.

  3. Clique na guia Observabilidade.

  4. Clique em Install Ops Agent.

    Quando possível, o agente é instalado usando uma política de SO do agente de operações. Para mais informações, consulte Gerenciar VMs cobertas pela política de SO do agente de operações. As políticas de SO do agente de operações não são compatíveis com todas as versões de todos os sistemas operacionais. Nesse caso, clicar em Instalar/atualizar Agente de operações fornece uma série de comandos a serem executados no Cloud Shell.

    Por padrão, o agente de operações coleta métricas e registros. É possível alterar esse comportamento padrão configurando o agente de operações.

    Se a instalação do agente permanecer Pendente por mais de 10 minutos, talvez haja um problema ao aplicar a política do SO do agente de operações ou iniciar o agente. Para informações de solução de problemas, consulte Ferramenta de diagnóstico de agente para políticas de instalação automática.

Verifique se o agente de operações está em execução

Para verificar se o Agente de operações está em execução, você pode usar um dos seguintes procedimentos:

  • Painel de instâncias de VM: esse painel permite visualizar o status de instalação do agente em toda a sua frota de VMs. No entanto, o status poderá ser impreciso se a VM não tiver os escopos de acesso necessários ou se a conta de serviço associada tiver funções do IAM insuficientes.

  • gcpdiag: o gcpdiag fornece informações mais confiáveis e robustas sobre o status do agente do que o painel de Instâncias de VM, verificando a instalação do agente e a transmissão de telemetria da VM. O uso do gcpdiag tem alguns pré-requisitos e oferece uma maneira melhor de monitorar o status do agente.

Use o painel de instâncias de VM

No Console do Google Cloud, acesse a página painel de Instâncias de VM.

Acessar o painel de instâncias de VM

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

Em seguida, verifique se a coluna Agente dessa VM indica o Agente de operações.

Usar gcpdiag

Para informações sobre como usar o gcpdiag, consulte Verificar o status do agente usando o gcpdiag.

Tarefas opcionais

Veja nesta seção como executar tarefas comuns de manutenção.

Configurar um proxy HTTP

Se você usa um proxy HTTP para representar solicitações de proxy para as APIs Logging e Monitoring, faça o seguinte:

Linux

  1. Edite o seguinte arquivo de configuração (crie o arquivo, se ele ainda não existir):

     /etc/systemd/system.conf

  2. Adicione o seguinte ao arquivo:

     DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.

  3. Atualize as variáveis de ambiente:

     sudo systemctl daemon-reload

  4. Reinicie o agente ao executar o comando a seguir na instância de VM.

     sudo systemctl restart google-cloud-ops-agent"*"

Windows

  1. Se você usar um proxy HTTP, gere o comando a seguir em um prompt de comando de administrador. Isso define as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY para que o agente possa enviar dados usando HTTPS de saída:

    setx HTTP_PROXY http://proxy-ip:proxy-port /m
setx HTTPS_PROXY http://proxy-ip:proxy-port /m
setx no_proxy metadata.google.internal /m

Determinar a versão do agente

Para determinar a versão do agente de operações no seu sistema, execute os seguintes comandos na instância de VM:

Console do Google Cloud

Para ver a versão do agente de operações em uma VM, siga estas etapas:

  • Localize a entrada da VM na tabela Instâncias da página Instâncias de VM do Monitoring. Para informações de navegação, consulte Instalar o agente usando o console do Google Cloud.

  • Passe o cursor sobre o indicador Agente de operações na entrada da tabela.

CENTOS/RHEL

Execute o seguinte comando nos sistemas Linux Red Hat ou CentOS:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

DEBIAN/UBUNTU

Execute este comando no Debian ou no Ubuntu:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-cloud-ops-agent

SLES/SUSE

Execute o comando a seguir no SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

WINDOWS

Execute o comando a seguir no Windows:

googet installed google-cloud-ops-agent

Reinicie o agente.

Você precisa reiniciar o agente de operações para selecionar as alterações nos arquivos de configuração. Para reiniciar o agente, use as instruções a seguir.

LINUX

Execute o seguinte comando na instância:


     sudo systemctl restart google-cloud-ops-agent

Windows

  1. Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.

  2. Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

  3. Execute o seguinte comando do PowerShell:

Restart-Service google-cloud-ops-agent -Force

Fazer upgrade do agente

Para atualizar o agente de operações para a versão mais recente, siga estas instruções:

Console do Google Cloud

É possível fazer upgrade do agente de operações usando as instruções de instalação do Cloud Monitoring. Para mais informações, consulte Instalar o agente usando o console do Google Cloud.

Linux

Para fazer upgrade do agente para a versão mais recente, execute o comando abaixo:

sudo bash add-google-cloud-ops-agent-repo.sh --also-install

Para fazer upgrade do agente para a versão pontual mais recente de uma versão principal específica, execute o comando abaixo:

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Para fazer upgrade para a versão mais recente do agente:

  1. Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.

  2. Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

    Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"

  3. Execute os seguintes comandos do PowerShell para remover o agente instalado e executar o comando de instalação:

    googet -noconfirm remove google-cloud-ops-agent
googet -noconfirm install google-cloud-ops-agent

Listar todas as versões do agente

Para listar as versões disponíveis do agente, execute o seguinte comando:

CENTOS/RHEL

Liste as versões disponíveis do agente:

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN/UBUNTU

Liste as versões disponíveis do agente:

sudo apt-cache madison google-cloud-ops-agent

SLES/SUSE

Liste as versões disponíveis do agente:

sudo zypper search -s google-cloud-ops-agent

WINDOWS

Liste as versões disponíveis do agente:

googet available google-cloud-ops-agent

Desinstalar o agente

Para remover o agente de operações e os respectivos arquivos de configuração, use as instruções a seguir.

Depois de desinstalar o agente, o console do Google Cloud pode levar até uma hora para informar essa alteração.

Linux

Execute este comando:

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

Outra opção é anexar --remove-repo ao comando anterior para remover o repositório e desinstalar o agente.

Windows

Para desinstalar o agente de operações, siga estas etapas:

  1. Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.

  2. Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

  3. Execute o seguinte comando do PowerShell:

    googet -noconfirm remove google-cloud-ops-agent

VMs sem acesso ao pacote remoto

A instalação do agente de operações requer acesso aos repositórios de pacotes remotos, tanto para o pacote do agente quanto para as dependências (no Linux).

Se você estiver usando o VPC-SC ou uma rede privada, a configuração da rede também poderá afetar a instalação de dependências do agente a partir de repositórios upstream. Os próprios pacotes de agente podem ser acessados usando o Acesso privado do Google. Isso pode ser configurado em Ativar o Acesso privado do Google.

Se a política de segurança da VM host negar o acesso aos repositórios de pacotes remotos, recomendamos criar uma imagem de VM personalizada com o agente pré-instalado e desativar o gerenciamento de pacotes nessa imagem.

A seguir