Instale e faça a gestão do agente de operações através de políticas do Gestor de extensões de VMs

Pode instalar e gerir o agente de operações numa frota de VMs do Compute Engine numa zona específica através de políticas do VM Extension Manager. Por exemplo, pode usar estas políticas para realizar tarefas como as seguintes:

  • Instalação ao nível da frota: instale o agente de operações em todas as VMs numa zona ou num conjunto de VMs identificadas por etiquetas numa zona.

  • Controlo de versões:

    • Mantenha o agente de operações atualizado para a versão mais recente.
    • Afixe a versão do agente de operações a um lançamento específico.

  • Gestão da configuração: aplique uma configuração personalizada ao agente Ops em todas as VMs geridas por uma política.

Com o Gestor de extensões de VMs, cria políticas que declaram as extensões que quer instalar em VMs. O agente de operações é uma das extensões disponíveis. As políticas do VM Extension Manager podem gerir a versão 2.58.0 ou mais recente do Ops Agent quando este tiver sido instalado através do VM Extension Manager. Estas políticas não podem gerir versões do agente Ops anteriores à versão 2.58.0, instâncias do agente Ops instaladas através de outros meios nem qualquer versão do agente de monitorização ou do agente de registo antigo.

Pode criar e gerir políticas de extensões de VMs através da Google Cloud consola ou da Google Cloud CLI, gcloud.

Antes de começar

Antes de começar a usar as políticas da extensão VM Extension Manager, faça o seguinte:

Reveja os sistemas operativos compatíveis

Antes de tentar usar as políticas do VM Extension Manager para gerir o agente de operações, verifique se o sistema operativo de destino é compatível com o agente de operações e o VM Extension Manager.

O VM Extension Manager suporta todos os sistemas operativos suportados pelo agente de operações, exceto o SUSE Linux Enterprise Server (SLES) e o Ubuntu. Para mais informações sobre os sistemas operativos suportados pelo agente de operações, consulte Sistemas operativos.

Se o seu sistema operativo for suportado pelo agente de operações e pelo Gestor de extensões de VMs, siga o resto deste documento.

Ative as APIs necessárias para usar o agente de operações

Para usar o agente de operações para escrever registos e métricas, tem de ativar a API Cloud Logging e a API Cloud Monitoring no seu Google Cloud projeto.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Conceda as funções necessárias para usar o agente de operações

Para receber as autorizações de que precisa para usar o agente de operações para escrever registos e métricas, peça ao seu administrador que lhe conceda as seguintes funções do IAM na sua conta de serviço:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para mais informações sobre as funções e o agente de operações, consulte o artigo Autorize o agente de operações.

Conceda as funções necessárias para usar o Gestor de extensões de VMs

Para receber as autorizações de que precisa para criar, ver, modificar e eliminar políticas de extensões de VMs, peça ao seu administrador para lhe conceder as seguintes funções de IAM no projeto:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para criar, ver, modificar e eliminar políticas de extensão de VMs. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para criar, ver, modificar e eliminar políticas de extensões de VMs:

  • Para criar políticas de extensão: compute.vmExtensionPolicies.create
  • Para ver as políticas de extensões: compute.vmExtensionPolicies.list
  • Para ver os detalhes de uma política de extensões: compute.vmExtensionPolicies.get
  • Para modificar as políticas de extensão: compute.vmExtensionPolicies.update
  • Para eliminar políticas de extensão: compute.vmExtensionPolicies.delete

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Para mais informações sobre as funções e as autorizações de IAM no Compute Engine, consulte o artigo Funções e autorizações do Compute Engine.

Instale a CLI Google Cloud

Pode criar e gerir políticas de extensões de VMs através da Google Cloud consola ou da Google Cloud CLI, gcloud. Para usar o gcloud, tem de o instalar primeiro através dos seguintes passos:

  1. Se ainda não o fez, instale a CLI do Google Cloud.

    As políticas de extensão descritas neste documento usam o grupo de comandos beta.

  1. Se ainda não o fez, instale o componente beta da CLI gcloud executando o seguinte comando:

    gcloud components install beta

    Para verificar se tem o componente beta instalado, execute o seguinte comando:

    gcloud components list

    Se instalou anteriormente o componente beta, verifique se tem a versão mais recente:

    gcloud components update

Desinstale todos os agentes de observabilidade

Antes de criar uma política do Gestor de extensões de VMs para gerir o agente de operações numa VM, certifique-se de que não existem instâncias do agente de operações nem do agente de monitorização e do agente de registo antigos já na VM. A execução do agente Ops e dos agentes antigos na mesma VM pode causar o carregamento de registos duplicados ou conflitos no carregamento de métricas.

Se usar uma política de extensão para instalar o agente de operações numa VM onde já está instalado outro agente de observabilidade, a política instala o agente, mas o agente não é executado porque é detetado um conflito.

A forma como remove os agentes existentes depende da forma como foram instalados.

Instale o agente de operações criando políticas de extensão de VMs

Crie políticas de extensão de VMs para instalar e gerir automaticamente o agente de operações numa frota de máquinas virtuais (VMs) do Compute Engine. Ao definir uma política, pode garantir que extensões específicas, como o agente de operações, são instaladas e mantidas em todas as VMs que correspondam aos critérios especificados, como etiquetas de VMs.

Conflitos e prioridades de políticas

O VM Extension Manager associa uma prioridade a cada nova política, sendo que os números mais baixos indicam prioridades mais elevadas. A prioridade predefinida é 1000. Uma VM pode ser abrangida por várias políticas para uma extensão, como o agente de operações, mas apenas uma política para a extensão do agente de operações é eficaz na VM.

O Gestor de extensões de VMs usa prioridades para resolver conflitos entre políticas aplicadas a uma VM. Para mais informações sobre o processo de resolução, consulte o artigo Prioridade e resolução de conflitos de políticas.

Instale o agente de operações mais recente em todas as VMs numa zona

Para criar uma política que instala a versão mais recente do agente de operações em todas as VMs numa zona e atualiza o agente de operações quando é lançada uma nova versão, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

  2. Clique em + Criar.
  3. No campo Nome, introduza um nome para a política.
  4. Opcional: no campo Descrição, introduza uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Os números mais baixos indicam uma prioridade mais elevada. O valor predefinido é 1000.

  6. Na lista Zona, selecione a zona onde quer aplicar esta política.

  7. Na secção Gerir extensões, clique em Adicionar extensão e faça o seguinte:

    1. Na lista Extensão, selecione Google Cloud's Extension for Ops Agent.
    2. Deixe o campo Version em branco.

  8. Clique em Criar.

gcloud

Use o seguinte comando gcloud beta compute zone-vm-extension-policies create para criar a política:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

O elemento gcloud beta compute zone-vm-extension-policies create usa a opção --version. Se omitir a opção --version, a política instala a versão mais recente e atualiza o agente de operações quando é lançada uma nova versão.

Restrinja o agente Ops a uma versão específica em todas as VMs numa zona

Para criar uma política que instala uma versão específica do agente de operações em todas as VMs numa zona, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

  2. Clique em + Criar.
  3. No campo Nome, introduza um nome para a política.
  4. Opcional: no campo Descrição, introduza uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Os números mais baixos indicam uma prioridade mais elevada. O valor predefinido é 1000.

  6. Na lista Zona, selecione a zona onde quer aplicar esta política.

  7. Na secção Gerir extensões, clique em Adicionar extensão e faça o seguinte:

    1. Na lista Extensão, selecione Google Cloud's Extension for Ops Agent.
    2. Na lista Versão, selecione a versão a instalar. Use a versão 2.58.0 ou mais recente.

  8. Clique em Criar.

gcloud

Use o seguinte comando gcloud beta compute zone-vm-extension-policies create para criar a política:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --version=ops-agent=VERSION

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

  • VERSION: a versão do Ops Agent a instalar. Use a versão 2.58.0 ou mais recente.

    Se omitir a opção --version, a política instala a versão mais recente e atualiza o agente de operações quando é lançada uma nova versão, conforme mostrado no exemplo que instala a versão mais recente.

Para ver uma lista das versões do agente Ops, consulte a página de lançamentos no GitHub.

Instale o agente de operações em VMs numa zona com uma etiqueta específica

Para criar uma política que instala a versão mais recente do agente de operações nas VMs numa zona com uma etiqueta específica, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

  2. Clique em + Criar.
  3. No campo Nome, introduza um nome para a política.
  4. Opcional: no campo Descrição, introduza uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Os números mais baixos indicam uma prioridade mais elevada. O valor predefinido é 1000.

  6. Na lista Zona, selecione a zona onde quer aplicar esta política.

  7. Na secção Extensões, clique em Adicionar extensão e faça o seguinte:

    1. Na lista Extensão, selecione Google Cloud's Extension for Ops Agent.
    2. Deixe o campo Version em branco.

  8. Na secção Instâncias de VM de destino, selecione as VMs para a política. Para selecionar VMs com etiquetas específicas, clique em Adicionar etiquetas e adicione o par de chave-valor.

  9. Clique em Criar.

gcloud

Use a opção --inclusion-labels para o comando gcloud beta compute zone-vm-extension-policies create para especificar uma lista de pares de chave/valor separados por vírgulas:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

  • KEY1=VALUE1,KEY2=VALUE2: uma lista separada por vírgulas de pares chave-valor que definem etiquetas de inclusão para um seletor. As VMs têm de ter todas as etiquetas especificadas num seletor (AND lógico) para serem incluídas. Se especificar a opção --inclusion_labels várias vezes, a política segmenta as VMs que correspondem a todas as etiquetas em qualquer um dos seletores (OR lógico). Se omitir esta opção, a política segmenta todas as VMs na zona especificada.

Instale o agente de operações com uma configuração personalizada em todas as VMs numa zona

Para criar uma política que instala a versão mais recente do agente de operações em todas as VMs numa zona e fornece uma configuração personalizada para o agente de operações, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

  2. Clique em + Criar.
  3. No campo Nome, introduza um nome para a política.
  4. Opcional: no campo Descrição, introduza uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Os números mais baixos indicam uma prioridade mais elevada. O valor predefinido é 1000.

  6. Na lista Zona, selecione a zona onde quer aplicar esta política.

  7. Na secção Extensões, clique em Adicionar extensão e faça o seguinte:

    1. Na lista Extensão, selecione Google Cloud's Extension for Ops Agent.
    2. Deixe o campo Version em branco.
    3. No campo Conteúdo do ficheiro de configuração, introduza a string de configuração YAML para o Ops Agent.

  8. Clique em Criar.

gcloud

Use a opção --config-from-file para o comando gcloud beta compute zone-vm-extension-policies create para especificar um ficheiro de configuração:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

  • OPS_AGENT_CONFIG_PATH: O caminho para um ficheiro que contém a string de configuração YAML para o Ops Agent. Este ficheiro tem de existir no ambiente onde executa o comando gcloud.

    O YAML de configuração do agente de operações pode ser longo. Colocar a configuração num ficheiro e transmitir o ficheiro para a CLI gcloud é muito menos propenso a erros do que tentar introduzir YAML formatado corretamente na linha de comandos. A alteração deste ficheiro após a criação da política não atualiza a política. Para atualizar uma política, use o comando gcloud beta compute zone-vm-extension-policies update.

Se fornecer uma configuração personalizada para o agente de operações ao criar ou atualizar uma política de extensão, a política implementa o agente de operações com a configuração personalizada. Não precisa de reiniciar o agente manualmente.

A configuração é armazenada com a política de extensões, por isso, não inclua dados confidenciais, como palavras-passe, na configuração. Uma vez que a configuração é armazenada com a política de extensões, a modificação do ficheiro de configuração não altera a configuração do agente. Tem de atualizar a configuração armazenada com a política através do comando gcloud beta compute zone-vm-extension-policies update.

Quando fornece uma configuração personalizada para o agente de operações, o Gestor de extensões de VMs copia a configuração para a localização usada pelo agente de operações para ficheiros de configuração especificados pelo utilizador na VM de destino:

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

Se existir um ficheiro config.yaml na VM, a política de extensões substitui-o.

Para obter informações gerais sobre a utilização da consola e da CLI gcloud para criar políticas de extensões de VMs, consulte o artigo Instale extensões de VMs criando políticas de extensões.Google Cloud

Faça a gestão do agente de operações atualizando as políticas de extensão de VMs

Para alterar a forma como uma política gere o agente de operações, atualize a política. Quando atualiza uma política, o VM Extension Manager implementa as alterações em todas as VMs aplicáveis, normalmente no prazo de um minuto. Se modificar as etiquetas de inclusão, o agente Ops pode ser instalado em novas VMs ou desinstalado de VMs existentes com base no facto de as VMs corresponderem às etiquetas atualizadas.

As secções seguintes mostram como gerir o agente de operações para fazer o seguinte:

Atualize a versão afixada do agente de operações em todas as VMs numa zona

Para alterar a versão afixada do agente de operações em todas as VMs numa zona, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

  2. Selecione a política que quer atualizar.
  3. Clique em Edit.
  4. Na secção Gerir extensões, faça o seguinte:
    1. Selecione Google Cloud's Extension for Ops Agent.
    2. Modifique o campo Version (Versão). Use a versão 2.58.0 ou mais recente.
    3. Clique em Concluído.
  5. Clique em Guardar.

gcloud

Use o comando gcloud beta compute zone-vm-extension-policies update com o comando de opção --version para modificar a versão do agente fixada.

Quando atualiza uma política através do gcloud, o pedido funciona como uma substituição completa. Todos os campos opcionais que omitir revertem para os respetivos valores predefinidos, em vez de manterem os valores existentes da política modificada.

Para alterar a versão do agente de operações instalada em todas as VMs numa zona através de uma política, use o seguinte comando:

gcloud beta compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --version=ops-agent=VERSION

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

  • VERSION: a versão do Ops Agent a instalar. Use a versão 2.58.0 ou mais recente. Para ver uma lista de versões, consulte a página de lançamentos do agente Ops no GitHub.

    Se omitir a opção --version, a política instala a versão mais recente e atualiza o agente de operações quando é lançada uma nova versão, conforme mostrado no exemplo que instala a versão mais recente.

Modifique a configuração do agente Ops em todas as VMs numa zona

Para modificar a configuração do agente de operações em todas as VMs numa zona, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

  2. Selecione a política que quer atualizar.
  3. Clique em Edit.
  4. Na secção Gerir extensões, faça o seguinte:
    1. Selecione Google Cloud's Extension for Ops Agent.
    2. Modifique o campo Conteúdo do ficheiro de configuração.
    3. Clique em Concluído.
  5. Clique em Guardar.

gcloud

Use o gcloud beta compute zone-vm-extension-policies update com a opção --config-from-file ou a opção --config para especificar uma nova configuração.

Quando atualiza uma política através do gcloud, o pedido funciona como uma substituição completa. Todos os campos opcionais que omitir revertem para os respetivos valores predefinidos, em vez de manterem os valores existentes da política modificada.

Para alterar a configuração do agente de operações instalado em todas as VMs numa zona através de uma política, use o seguinte comando:

gcloud beta compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

  • OPS_AGENT_CONFIG_PATH: O caminho para um ficheiro que contém a string de configuração YAML para o Ops Agent. Este ficheiro tem de existir no ambiente onde executa o comando gcloud.

    O YAML de configuração do agente de operações pode ser longo. Colocar a configuração num ficheiro e transmitir o ficheiro para a CLI gcloud é muito menos propenso a erros do que tentar introduzir YAML formatado corretamente na linha de comandos.

Se fornecer uma configuração personalizada para o agente de operações quando criar ou atualizar uma política de extensão, a política implementa o agente de operações com a configuração personalizada. Não precisa de reiniciar o agente manualmente.

A configuração é armazenada com a política de extensões, por isso, não inclua dados confidenciais, como palavras-passe, na configuração. Uma vez que a configuração é armazenada com a política de extensões, a modificação do ficheiro de configuração não altera a configuração do agente. Tem de atualizar a configuração armazenada com a política através do comando gcloud beta compute zone-vm-extension-policies update.

Quando fornece uma configuração personalizada para o agente de operações, o Gestor de extensões de VMs copia a configuração para a localização usada pelo agente de operações para ficheiros de configuração especificados pelo utilizador na VM de destino:

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

Se existir um ficheiro config.yaml na VM, a política de extensões substitui-o.

Para obter informações gerais sobre a utilização da consolaGoogle Cloud e da CLI gcloud para gerir políticas de extensões de VMs, consulte o artigo Modifique extensões atualizando uma política de extensões de VMs.

Desinstale o agente de operações eliminando as políticas de extensão de VMs

Para desinstalar o agente de operações, elimine a política de extensão da VM que gere o agente. Se outra política ativa de prioridade mais baixa se aplicar a uma VM e também gerir o agente de operações, o agente permanece instalado nessa VM com base na política de prioridade mais baixa.

O VM Extension Manager remove o agente de operações de todas as VMs acessíveis no prazo de um minuto após a eliminação da política. Se uma VM for inacessível, o VM Extension Manager ignora a eliminação do agente. Se a VM ficar novamente disponível, o VM Extension Manager remove o agente nesse momento.

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

  2. Selecione a política que quer eliminar.
  3. Clique em Eliminar.
  4. Na caixa de diálogo de confirmação, clique em Eliminar.

gcloud

Para eliminar a política de extensão de VM que gere o agente de operações, use o comando gcloud beta compute zone-vm-extension-policies delete:

gcloud beta compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

Obtenha informações sobre as políticas de extensões de VMs

Pode obter as seguintes informações sobre as políticas de extensões de VMs existentes:

  • Uma lista de todas as políticas no seu Google Cloud projeto.
  • Informações de configuração sobre uma política específica.

Consola

  1. Na Google Cloud consola, aceda à página Políticas de extensão:

    Aceda a Políticas de extensão

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Compute Engine.

    Esta página lista todas as políticas de extensões de VMs no seu projeto.
  2. Para ver os detalhes de uma política de extensões específica, clique no nome da política.

gcloud

Apresente as políticas de extensão de VMs

Para apresentar informações sobre todas as políticas de extensão de VM numa zona, use o comando gcloud beta compute zone-vm-extension-policies list:

gcloud beta compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

Substitua as seguintes variáveis no comando:

  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.
  • PAGE_SIZE_INTEGER: o número de políticas a apresentar por página; por exemplo, 2. Para mais informações sobre as opções de ordenação e filtragem, consulte gcloud beta compute zone-vm-extension-policies list.

Descreva uma política de extensão de VM com nome

Para obter a configuração de uma política com nome numa zona, use o comando gcloud beta compute zone-vm-extension-policies describe:

gcloud beta compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Substitua as seguintes variáveis no comando:

  • POLICY_NAME: um nome para a política de extensão de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino; por exemplo, us-central1-f.

Para obter informações gerais sobre a utilização da consola e da CLI gcloud para obter informações acerca das políticas de extensões de VMs, consulte o artigo Ver políticas de extensões.Google Cloud

Valide a instalação do agente de operações

Esta secção descreve como fazer o seguinte:

Valide o estado ou a versão de uma instalação do Ops Agent

Para determinar o estado ou a versão do agente de operações, use uma das seguintes Google Cloud páginas da consola:

Compute Engine

  1. Na Google Cloud consola, aceda à página Instâncias de VM:

    Aceda a Instâncias de VM

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda seja Compute Engine.

  2. Selecione uma VM na lista.
  3. Clique no separador Observabilidade.

Cloud Monitoring

  1. Na Google Cloud consola, aceda à página Instâncias de VM:

    Aceda a Instâncias de VM

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

  2. Selecione a vista Lista.

Quando o agente de operações é instalado na VM e está a recolher registos e métricas, o estado do agente é marcado com uma marca de verificação verde junto à etiqueta Agente de operações.

Para determinar a versão do agente instalado, passe o cursor do rato sobre a etiqueta Agente Ops no painel de controlo do Compute Engine ou do Monitoring.

Verifique se o agente de operações está a recolher telemetria

Se o agente de operações tiver sido instalado com êxito e estiver a ser executado corretamente, envia métricas para o Cloud Monitoring e registos para o Cloud Logging.

Reinicie um agente de operações instalado por uma política de extensão

Quando o agente Ops é instalado e gerido pelo Gestor de extensões de VMs, o agente Ops não é gerido pelo serviço de gestão do sistema do sistema operativo, ou seja, systemd no Linux ou o Gestor de serviços do Windows no Windows. Por conseguinte, os comandos do Linux systemctl e os comandos do Windows *-Service não funcionam com um agente de operações instalado por uma política de extensão.

Para reiniciar um agente de operações que foi instalado por uma política de extensão, faça uma das seguintes ações:

  • Recrie a política.

    1. Elimine a política. A eliminação da política para e desinstala o agente de operações.

    2. Crie uma nova política. A nova política instala o agente de operações e inicia-o.

  • Usar uma política temporária de prioridade mais elevada. Se a política original afetar um grande número de VMs, mas só quiser reiniciar o agente de operações num pequeno número, adicione uma etiqueta a essas VMs e configure a nova política para filtrar pela etiqueta.

    Por exemplo, se uma política com a prioridade 1000 não conseguir iniciar o agente de operações numa VM, pode adicionar uma etiqueta como status=failed à VM. Em seguida, crie uma nova política com uma prioridade mais elevada, como 500. Por exemplo, um comando da Google Cloud CLI pode ter o seguinte aspeto:

    gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

    Substitua as seguintes variáveis no comando:

    • POLICY_NAME: um nome para a política de extensão de VM.
    • PROJECT_ID: o identificador do projeto.
    • ZONE: a zona de destino; por exemplo, us-central1-f.

    Depois de a nova política instalar com êxito o agente de operações, elimine a política e remova a etiqueta das VMs. O agente de operações permanece instalado na VM porque a política original ainda está ativa.

Ative o registo de depuração do agente convidado na VM

As políticas do VM Extension Manager usam o agente convidado do Compute Engine para gerir o agente de operações como uma extensão de VM. Para ver informações sobre como ativar o registo de depuração para o agente convidado, consulte o artigo Veja registos de depuração para o agente convidado.

Resolva problemas com políticas de extensões

Esta secção fornece informações sobre a resolução de problemas da utilização de políticas de extensões para gerir o agente de operações:

Para informações sobre a resolução de problemas do agente de operações, consulte o artigo Resolva problemas do agente de operações.

Os comandos gcloud beta compute zone-vm-extension-policies falham

Quando um comando gcloud beta compute zone-vm-extension-policies falha, a resposta inclui sugestões de resolução de problemas. Corrija quaisquer erros nas flags ou nos argumentos do comando sugeridos pela mensagem de erro.

Se o resultado do comando mencionar autorizações de IAM insuficientes, reveja as funções e as autorizações necessárias descritas no artigo Conceda as funções necessárias para usar o Gestor de extensões de VMs.

A política de extensões é criada, mas o estado do agente de operações é "não detetado"

Criou uma política de extensão com êxito, mas o agente de operações mostra o estado "não detetado" na VM.

O agente de operações pode ser apresentado como "não detetado" se ocorrer uma das seguintes situações:

  • A política de extensões não instala o agente de operações.
  • Um agente Ops instalado encontra uma condição de erro que o impede de ser executado.

As secções seguintes descrevem como diagnosticar estes casos.

Confirme se o agente de operações foi instalado pela política

As políticas do VM Extension Manager usam o agente convidado do Compute Engine para gerir o agente de operações como uma extensão de VM.

Para determinar se o agente de operações foi instalado pela política de extensão, use um dos seguintes métodos para procurar entradas de registo do agente convidado:

Logs Explorer

  1. Na Google Cloud consola, aceda à página Explorador de registos:

    Aceda ao Explorador de registos

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

  2. Introduza a seguinte consulta e clique em Executar consulta:

    log_id("GCEGuestAgentManager")

Linux

Execute o seguinte comando na VM do Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Execute o seguinte comando na VM do Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Se vir registos que contenham uma string como Failed to install plugin "ops-agent-plugin" ... ou a consulta não devolver registos, significa que a política de extensão não instalou o agente de operações. Para os passos seguintes, consulte o artigo A política de extensões não instala o agente de operações.

Se vir registos que contenham uma string como Successfully installed plugin "ops-agent_nnnnnnnn", significa que a política de extensão instalou o agente de operações com êxito. Para os passos seguintes, consulte o artigo O agente de operações instalado "não é detetado".

A política de extensão não instala o agente de operações

Uma política de extensão pode ser ineficaz se uma das seguintes afirmações for verdadeira:

  • O agente convidado não está instalado na VM. Para diagnosticar e corrigir esta condição, faça o seguinte:

    1. Verifique se a VM está a usar um dos sistemas operativos suportados para o ambiente convidado do Compute Engine.

    2. Veja os pacotes instalados na MV para verificar se google-guest-agent está incluído.

    3. Se o google-guest-agent não estiver instalado, instale o agente convidado.

  • O agente de hóspedes está instalado, mas está desatualizado. Para diagnosticar e corrigir esta condição, faça o seguinte:

    1. Valide o ambiente convidado para determinar a versão do pacote google-guest-agent. O VM Extension Manager requer a versão 20241209.01 ou mais recente.

    2. Se a versão do google-guest-agent for anterior a 20241209.01, atualize o ambiente convidado.

  • O sistema operativo da VM não é suportado pelo VM Extension Manager. Para mais informações, consulte o artigo Reveja os sistemas operativos suportados.

O agente de operações instalado tem o estado "não detetado"

O agente de operações pode ter o estado "não detetado" se uma das seguintes afirmações for verdadeira:

Valide se a configuração do agente de operações é válida

Forneceu uma configuração personalizada ao agente de operações criando ou atualizando uma política de extensão, mas o estado do agente é "não detetado". O problema pode ser um erro na sua configuração personalizada. Use os registos de depuração do agente convidado para procurar erros de configuração.

Ative o registo de depuração do agente convidado

Para ver informações sobre como ativar o registo de depuração para o agente convidado, consulte o artigo Veja registos de depuração para o agente convidado.

Examine os registos de depuração

Logs Explorer

  1. Na Google Cloud consola, aceda à página Explorador de registos:

    Aceda ao Explorador de registos

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

  2. Introduza a seguinte consulta e clique em Executar consulta:

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

Execute o seguinte comando na VM do Compute Engine Linux:

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

Execute o seguinte comando na VM do Compute Engine do Windows:

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

Se vir registos que contêm a string The agent config file is not valid, significa que a configuração personalizada do agente de operações que forneceu quando criou ou atualizou a política de extensão é inválida.

Para corrigir este problema, faça o seguinte:

  • Corrija a configuração consultando o artigo Configure o agente de operações. Para ver informações sobre a estrutura de um ficheiro de configuração do agente de operações.

  • Atualize a política de extensões com a configuração corrigida.

Os comandos do Linux systemctl status e do Windows Get-Service não funcionam com o agente de operações

Executa um comando como sudo systemctl status google-cloud-ops-agent"*" mas não devolve informações.

Quando o agente Ops é instalado e gerido pelo VM Extension Manager, o agente Ops não é gerido pelo serviço de gestão do sistema do sistema operativo, ou seja, systemd no Linux ou o Gestor de serviços do Windows no Windows.

Para encontrar as informações de estado de um agente de operações gerido pelo VM Extension Manager, consulte o seguinte:

Os comandos do Linux systemctl restart e do Windows Restart-Service não funcionam com o agente de operações

Executa um comando como sudo systemctl restart google-cloud-ops-agent, mas o agente do Google Cloud Operations Suite não é reiniciado.

Quando o agente Ops é instalado e gerido pelo VM Extension Manager, o agente Ops não é gerido pelo serviço de gestão do sistema do sistema operativo, ou seja, systemd no Linux ou o Gestor de serviços do Windows no Windows. Por conseguinte, não pode parar nem iniciar o agente Ops manualmente. Além disso, os comandos como os seguintes não funcionam com o agente Ops:

  • Linux: sudo systemctl [stop|start|restart]
  • Windows: Stop-Service, Start-Service e Restart-Service

Para parar ou reiniciar um agente de operações gerido pelo VM Extension Manager, tem de desinstalá-lo eliminando a política de extensão. Para mais informações sobre como parar ou reiniciar o agente de operações, consulte Reinicie um agente de operações instalado por uma política de extensão.

Informações adicionais de resolução de problemas

Para mais informações sobre a resolução de problemas da criação e utilização de políticas do VM Extension Manager, consulte o artigo Resolva problemas de extensões de VMs.

Para mais informações sobre a resolução de problemas do agente de operações, consulte o artigo Resolva problemas do agente de operações.

Quota

Para ver informações sobre o número de políticas de extensões que pode criar num Google Cloud projeto, consulte o artigo Quota.

Preços

Para informações sobre os custos associados à utilização do VM Extension Manager, consulte a secção Preços.

Se instalar o agente de operações, pode ser-lhe cobrado o valor das métricas, dos registos ou dos rastreios que o agente envia para o seu Google Cloud projeto. Para ver informações sobre preços, consulte os preços da Google Cloud Observability.

O que se segue?