Instalar e gerenciar o Agente de operações usando políticas do VM Extension Manager

É possível instalar e gerenciar o Agente de operações em uma frota de VMs do Compute Engine globalmente ou em uma zona específica usando políticas do Gerenciador de extensões de VM. Por exemplo, é possível usar essas políticas para realizar tarefas como as seguintes:

  • Instalação em toda a frota: instale o Agente de operações nos seguintes itens:

    • Todas as VMs em uma ou mais zonas no projeto Google Cloud .
    • Todas as VMs globalmente (no projeto Google Cloud ).
    • Um subconjunto de VMs em uma zona, identificado por rótulos.
    • Um subconjunto de VMs em todas as zonas do seu projeto do Google Cloud , identificado por rótulos.

  • Controle de versão:

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

  • Gerenciamento de configuração: aplique uma configuração personalizada ao agente de operações em todas as VMs gerenciadas por uma política.

Com o Gerenciador de extensões de VM, você cria políticas que declaram quais extensões quer instalar nas VMs. O agente de operações é uma das extensões disponíveis. As políticas do Gerenciador de extensões de VM podem gerenciar a versão 2.58.0 ou mais recente do Agente de operações quando ele é instalado usando o Gerenciador de extensões de VM. Essas políticas não podem gerenciar versões do agente de operações anteriores à 2.58.0, instâncias do agente de operações instaladas por outros meios ou qualquer versão do agente do Monitoring ou do agente do Logging legados.

É possível criar e gerenciar políticas de extensão de VM zonais usando o console doGoogle Cloud ou a CLI gcloud do Google Cloud. É possível criar e gerenciar políticas globais de extensão de VM usando a gcloud.

Antes de começar

Antes de começar a usar as políticas de extensão do Gerenciador de extensões de VM, faça o seguinte:

Revisar os sistemas operacionais compatíveis

Antes de usar as políticas do Gerenciador de extensões de VM para gerenciar o Agente de operações, verifique se o sistema operacional de destino é compatível com o Agente de operações e o Gerenciador de extensões de VM.

O Gerenciador de extensões de VM é compatível com todos os sistemas operacionais compatíveis com o Agente de operações, exceto SUSE Linux Enterprise Server (SLES) e Ubuntu. Para mais informações sobre os sistemas operacionais compatíveis com o agente de operações, consulte Sistemas operacionais.

Se o sistema operacional for compatível com o Agente de operações e o Gerenciador de extensões de VM, siga o restante deste documento.

Ativar as APIs necessárias para usar o Agente de operações

Para usar o Agente de operações para gravar registros e métricas, ative a API Cloud Logging e a API Cloud Monitoring no seu projeto Google Cloud .

Funções necessárias para ativar APIs

Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

Ativar as APIs

Conceder os papéis necessários para usar o agente de operações

Para receber as permissões necessárias para usar o agente de operações e gravar registros e métricas, peça ao administrador para conceder a você os seguintes papéis do IAM na sua conta de serviço:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Para mais informações sobre papéis e o Agente de operações, consulte Autorizar o Agente de operações.

Conceder as funções necessárias para usar o VM Extension Manager

Para ter as permissões necessárias para criar, visualizar, modificar e excluir políticas de extensão de VM, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para criar, visualizar, modificar e excluir políticas de extensão de VM. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para criar, visualizar, modificar e excluir políticas de extensão de VM:

  • Para criar políticas de extensão: compute.vmExtensionPolicies.create
  • Para conferir as políticas de extensão: compute.vmExtensionPolicies.list
  • Para conferir detalhes de uma política de extensão: compute.vmExtensionPolicies.get
  • Para modificar as políticas de extensão: compute.vmExtensionPolicies.update
  • Para excluir políticas de extensão: compute.vmExtensionPolicies.delete

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações sobre papéis e permissões do IAM no Compute Engine, consulte Papéis e permissões do Compute Engine.

Instalar a CLI do Google Cloud

É possível criar e gerenciar políticas de extensão de VM usando o console Google Cloud ou a CLI gcloud do Google Cloud. Para usar a gcloud, primeiro instale a Google Cloud CLI.

Para conferir os componentes instalados, execute o seguinte comando:

gcloud components list

Para verificar se você tem a versão mais recente, execute o seguinte comando:

gcloud components update

Desinstalar todos os agentes de observabilidade

Antes de criar uma política do Gerenciador de extensões de VM para gerenciar o Agente de operações em uma VM, verifique se não há instâncias do Agente de operações ou do agente legado do Monitoring e do agente do Logging já na VM. A execução do agente de operações e dos agentes legados na mesma VM pode causar a ingestão de registros duplicados ou conflitos no processamento de métricas.

Se você usar uma política de extensão para instalar o Agente de Operações em uma VM em que outro agente de observabilidade já está instalado, a política vai instalar o agente, mas ele não será executado porque um conflito foi detectado.

A forma de remover os agentes depende de como eles foram instalados.

Instalar o Agente de operações criando políticas de extensão de VM

Crie políticas de extensão de VM para instalar e gerenciar automaticamente o agente de operações em uma frota de máquinas virtuais (VMs) do Compute Engine. Ao definir uma política, você garante que extensões específicas, como o agente de operações, sejam instaladas e mantidas em todas as VMs que corresponderem aos critérios especificados, como rótulos de VM.

Conflitos e prioridades de políticas

O Gerenciador de extensões de VM associa uma prioridade a cada nova política. Números menores indicam prioridades mais altas. A prioridade padrão é 1.000. Uma VM pode ser coberta 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 é efetiva na VM.

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

Planos de lançamento de políticas globais

As políticas globais do Gerenciador de extensões de VM usam um plano de implantação para determinar como uma política é distribuída para as VMs de destino. Há dois tipos de planos de lançamento:

  • Planos de lançamento predefinidos. Há dois planos de lançamento predefinidos, escolhidos pelo valor usado com a opção --rollout-predefined-plan para comandos da CLI gcloud.

    • Implantação lenta, que implanta o Agente de operações gradualmente em diferentes zonas ao longo de um período. Este plano de lançamento é recomendado.

      Especifique esse plano de lançamento usando a opção --rollout-predefined-plan=slow_rollout.

    • Implantação rápida, que implanta o agente de operações em todas as VMs segmentadas em todas as zonas e regiões imediatamente.

      Especifique esse plano de lançamento usando a opção --rollout-predefined-plan=fast_rollout.

  • Planos de lançamento personalizados, especificados usando a opção --rollout-custom-plan para comandos da CLI gcloud.

    Crie planos de lançamento personalizados adicionando-os ao conjunto de planos de lançamento no projeto Google Cloud . Para mais informações, consulte o método da API Compute Engine rolloutPlans.insert.

Para mais informações sobre planos de lançamento, consulte Planos de lançamento para políticas globais.

Instalar a versão mais recente do agente de operações em todas as VMs

Para criar uma política que instale a versão mais recente do agente de operações em todas as VMs de uma zona ou globalmente e atualize o agente quando uma nova versão for lançada, faça o seguinte:

Console

Para criar uma política zonal, use o console do Google Cloud .

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

  2. Clique em + Criar.
  3. No campo Nome, digite um nome para a política.
  4. Opcional: no campo Descrição, insira uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Números menores indicam maior prioridade. O valor padrão é 1000.

  6. Na lista Zona, selecione a zona em que você quer aplicar essa política.

  7. Na seção Gerenciar 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 Versão em branco.

  8. Clique em Criar.

gcloud

Para criar uma política zonal ou global, use a CLI gcloud.

Zonal

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

gcloud 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 gcloud compute zone-vm-extension-policies create usa uma opção --version. Se você omitir a opção --version, a política vai instalar a versão mais recente e atualizar o agente de operações quando uma nova versão for lançada.

Global

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

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.

O gcloud compute global-vm-extension-policies create usa uma opção --version. Se você omitir a opção --version, a política vai instalar a versão mais recente e atualizar o agente de operações quando uma nova versão for lançada.

Fixar o agente de operações em uma versão específica em todas as VMs

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

Console

Para criar uma política zonal, use o console do Google Cloud .

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

  2. Clique em + Criar.
  3. No campo Nome, digite um nome para a política.
  4. Opcional: no campo Descrição, insira uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Números menores indicam maior prioridade. O valor padrão é 1000.

  6. Na lista Zona, selecione a zona em que você quer aplicar essa política.

  7. Na seção Gerenciar 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 ser instalada. Use a versão 2.58.0 ou mais recente.

  8. Clique em Criar.

gcloud

Para criar uma política zonal ou global, use a CLI gcloud.

Zonal

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

gcloud 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 Agente de operações a ser instalada. Use a versão 2.58.0 ou mais recente.

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

Global

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.

  • VERSION: a versão do Agente de operações a ser instalada. Use a versão 2.58.0 ou mais recente.

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

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

Instalar o agente de operações em VMs com um rótulo específico

Para criar uma política que instale a versão mais recente do agente de operações nas VMs em uma zona ou globalmente que tenham um rótulo específico, faça o seguinte:

Console

Para criar uma política zonal, use o console do Google Cloud .

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

  2. Clique em + Criar.
  3. No campo Nome, digite um nome para a política.
  4. Opcional: no campo Descrição, insira uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Números menores indicam maior prioridade. O valor padrão é 1000.

  6. Na lista Zona, selecione a zona em que você quer aplicar essa política.

  7. Na seçã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 Versão em branco.

  8. Na seção Instâncias de VM de destino, selecione as VMs para a política. Para selecionar VMs com rótulos específicos, clique em Adicionar rótulos e inclua o par de chave-valor.

  9. Clique em Criar.

gcloud

Para criar uma política zonal ou global, use a CLI gcloud.

Zonal

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

gcloud 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 de chave-valor que definem rótulos de inclusão para um seletor. As VMs precisam ter todos os rótulos especificados em um seletor (AND lógico) para serem incluídas. Se você especificar a opção --inclusion_labels várias vezes, a política vai segmentar as VMs que correspondem a todos os rótulos em qualquer um dos seletores (OR lógico). Se você omitir essa opção, a política vai segmentar todas as VMs na zona especificada.

Global

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.

  • KEY1=VALUE1,KEY2=VALUE2: uma lista separada por vírgulas de pares de chave-valor que definem rótulos de inclusão para um seletor. As VMs precisam ter todos os rótulos especificados em um seletor (AND lógico) para serem incluídas. Se você especificar a opção --inclusion_labels várias vezes, a política vai segmentar as VMs que correspondem a todos os rótulos em qualquer um dos seletores (OR lógico). Se você omitir essa opção, a política vai segmentar todas as VMs na zona especificada.

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

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

Console

Para criar uma política zonal, use o console do Google Cloud .

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

  2. Clique em + Criar.
  3. No campo Nome, digite um nome para a política.
  4. Opcional: no campo Descrição, insira uma descrição para a política.
  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Números menores indicam maior prioridade. O valor padrão é 1000.

  6. Na lista Zona, selecione a zona em que você quer aplicar essa política.

  7. Na seçã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 Versão em branco.
    3. No campo Conteúdo do arquivo de configuração, insira a string de configuração YAML do agente de operações.

  8. Clique em Criar.

gcloud

Para criar uma política zonal ou global, use a CLI gcloud.

Zonal

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

gcloud 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 arquivo que contém a string de configuração YAML do Agente de operações. Esse arquivo precisa estar no ambiente em que você executa o comando gcloud.

    O YAML de configuração do Agente de operações pode ser longo. Colocar a configuração em um arquivo e transmitir o arquivo para a CLI gcloud é muito menos propenso a erros do que tentar inserir YAML formatado corretamente na linha de comando. Mudar esse arquivo depois de criar a política não atualiza a política. Para atualizar uma política, use o comando gcloud compute zone-vm-extension-policies update.

Global

Use a opção --config-from-file no comando gcloud compute global-vm-extension-policies create para especificar um arquivo de configuração:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.

  • OPS_AGENT_CONFIG_PATH: o caminho para um arquivo que contém a string de configuração YAML do Agente de operações. Esse arquivo precisa estar no ambiente em que você executa o comando gcloud.

    O YAML de configuração do Agente de operações pode ser longo. Colocar a configuração em um arquivo e transmitir o arquivo para a CLI gcloud é muito menos propenso a erros do que tentar inserir YAML formatado corretamente na linha de comando. Mudar esse arquivo depois de criar a política não atualiza a política. Para atualizar uma política, use o comando gcloud compute global-vm-extension-policies update.

Se você fornecer uma configuração personalizada para o Agente de operações ao criar ou atualizar uma política de extensão, a política vai implantar o Agente de operações com a configuração personalizada. Não é necessário reiniciar o agente manualmente.

A configuração é armazenada com a política de extensão. Portanto, não inclua dados sensíveis, como senhas, na configuração. Como a configuração é armazenada com a política de extensão, modificar o arquivo de configuração não muda a configuração do agente. Você deve atualizar a configuração armazenada com a política usando o comando gcloud apropriado:

Quando você fornece uma configuração personalizada para o Agente de operações, o Gerenciador de extensões de VM copia a configuração para o local usado pelo Agente de operações para arquivos de configuração especificados pelo usuário 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 houver um arquivo config.yaml na VM, a política de extensão o vai substituir.

Para informações gerais sobre como usar o consoleGoogle Cloud e a CLI gcloud para criar políticas de extensão de VM, consulte Instalar extensões de VM criando políticas de extensão .

Instalar o Agente de operações com um plano de lançamento rápido em prioridade mais alta (somente global)

Para criar uma política global que instale a versão mais recente do Agente de operações usando uma prioridade maior que a padrão e o plano de lançamento rápido, use o seguinte comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

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.

Instalar o agente de operações em um subconjunto de zonas em um projeto do Google Cloud (somente global)

Para criar uma política global que se aplique apenas a um subconjunto de zonas em um projetoGoogle Cloud , use um plano de lançamento personalizado que especifique as zonas em que a política será aplicada. Para informações sobre como criar planos de lançamento personalizados, consulte Sobre planos de lançamento. Para especificar um conjunto de zonas, use o campo locationSelector.includedLocations ao criar o plano de lançamento.

Para criar uma política de extensão que usa um plano de lançamento personalizado, use o seguinte comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

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.

  • CUSTOM_PLAN_NAME: o nome associado ao seu plano de implantação personalizada.

Gerenciar o Agente de Operações atualizando as políticas de extensão de VM

Para mudar como uma política gerencia o agente de operações, atualize a política. Quando você atualiza uma política, o Gerenciador de extensões de VM implanta as mudanças em todas as VMs aplicáveis, geralmente em um minuto. Se você modificar os rótulos de inclusão, o Agente de operações poderá ser instalado em novas VMs ou desinstalado de VMs atuais, dependendo se as VMs corresponderem aos rótulos atualizados.

As seções a seguir mostram como gerenciar o Agente de operações para fazer o seguinte:

Atualizar a versão fixada do agente de operações em todas as VMs de uma zona

Para mudar a versão fixada do agente de operações em todas as VMs de uma zona, faça o seguinte:

Console

Para criar uma política zonal, use o console do Google Cloud .

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

  2. Selecione a política que você quer atualizar.
  3. Clique em Editar.
  4. Na seção Gerenciar extensões, faça o seguinte:
    1. Selecione Google Cloud's Extension for Ops Agent.
    2. Modifique o campo Versão. Use a versão 2.58.0 ou mais recente.
    3. Clique em Concluído.
  5. Clique em Salvar.

gcloud

Para criar uma política zonal ou global, use a CLI gcloud.

Zonal

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

Quando você atualiza uma política usando gcloud, a solicitação funciona como uma substituição completa. Os campos opcionais omitidos voltam aos valores padrão em vez de manter os valores da política modificada.

Para mudar a versão do agente de operações instalada em todas as VMs de uma zona por uma política, use o seguinte comando:

gcloud 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 Agente de operações a ser instalada. 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 de operações no GitHub.

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

Global

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

Quando você atualiza uma política usando gcloud, a solicitação funciona como uma substituição completa. Os campos opcionais omitidos voltam aos valores padrão em vez de manter os valores da política modificada.

Para mudar a versão do agente de operações instalada em todas as VMs por uma política global, use o seguinte comando:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.

  • VERSION: a versão do Agente de operações a ser instalada. 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 de operações no GitHub.

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

Modificar a configuração do agente de operações em todas as VMs

Para modificar a configuração do Agente de operações, faça o seguinte:

Console

Para criar uma política zonal, use o console do Google Cloud .

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

  2. Selecione a política que você quer atualizar.
  3. Clique em Editar.
  4. Na seção Gerenciar extensões, faça o seguinte:
    1. Selecione Google Cloud's Extension for Ops Agent.
    2. Modifique o campo Conteúdo do arquivo de configuração.
    3. Clique em Concluído.
  5. Clique em Salvar.

gcloud

Para criar uma política zonal ou global, use a CLI gcloud.

Zonal

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

Quando você atualiza uma política usando gcloud, a solicitação funciona como uma substituição completa. Os campos opcionais omitidos voltam aos valores padrão em vez de manter os valores da política modificada.

Para mudar a configuração do agente de operações instalado em todas as VMs de uma zona por uma política, use o seguinte comando:

gcloud 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 arquivo que contém a string de configuração YAML do Agente de operações. Esse arquivo precisa estar no ambiente em que você executa o comando gcloud.

    O YAML de configuração do Agente de operações pode ser longo. Colocar a configuração em um arquivo e transmitir o arquivo para a CLI gcloud é muito menos propenso a erros do que tentar inserir YAML formatado corretamente na linha de comando.

Global

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

Quando você atualiza uma política usando gcloud, a solicitação funciona como uma substituição completa. Os campos opcionais omitidos voltam aos valores padrão em vez de manter os valores da política modificada.

Para mudar a configuração do Agente de Operações instalado em todas as VMs por uma política, use o seguinte comando:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.

  • OPS_AGENT_CONFIG_PATH: o caminho para um arquivo que contém a string de configuração YAML do Agente de operações. Esse arquivo precisa estar no ambiente em que você executa o comando gcloud.

    O YAML de configuração do Agente de operações pode ser longo. Colocar a configuração em um arquivo e transmitir o arquivo para a CLI gcloud é muito menos propenso a erros do que tentar inserir YAML formatado corretamente na linha de comando.

Se você fornecer uma configuração personalizada para o Agente de operações ao criar ou atualizar uma política de extensão, a política vai implantar o Agente de operações com a configuração personalizada. Não é necessário reiniciar o agente manualmente.

A configuração é armazenada com a política de extensão. Portanto, não inclua dados sensíveis, como senhas, na configuração. Como a configuração é armazenada com a política de extensão, modificar o arquivo de configuração não muda a configuração do agente. Atualize a configuração armazenada com a política usando o comando gcloud adequado:

Quando você fornece uma configuração personalizada para o Agente de operações, o Gerenciador de extensões de VM copia a configuração para o local usado pelo Agente de operações para arquivos de configuração especificados pelo usuário 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 houver um arquivo config.yaml na VM, a política de extensão o vai substituir.

Para informações gerais sobre como usar o consoleGoogle Cloud e a CLI gcloud para gerenciar políticas de extensão de VM, consulte Modificar extensões atualizando uma política de extensão de VM.

Estender uma política global atual para incluir novas zonas (somente global)

Quando as VMs são criadas em novas zonas depois que uma política global é criada e implantada, o Gerenciador de extensões de VM não aplica automaticamente a política às VMs nas novas zonas. Para incluir as VMs em novas zonas, reinicie o lançamento da política global.

Para reiniciar um lançamento de política global, use o comando gcloud compute global-vm-extension-policies update e forneça a opção --rollout-retry-uuid=UUID.

Por exemplo, suponha que você tenha criado e implantado uma política global usando o seguinte comando:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Para estender a política a VMs criadas em zonas não usadas anteriormente, reinicie o lançamento usando o seguinte comando:

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

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.

  • UUID: um identificador universal exclusivo (UUID) que identifica a solicitação de nova tentativa. Você pode usar qualquer gerador de UUID para criar um. Para mais informações, consulte Tentar de novo um lançamento .

Atualizar uma política global para excluir um conjunto de zonas (somente global)

Para atualizar as zonas de uma política global que exclui algumas zonas em um projetoGoogle Cloud , use um novo plano de lançamento personalizado que especifique as zonas em que a política será aplicada. Para informações sobre como criar planos de lançamento personalizados, consulte Sobre planos de lançamento. Para especificar um conjunto de zonas, use o campo locationSelector.includedLocations ao criar o plano de lançamento.

Para atualizar uma política de extensão que usa um plano de lançamento personalizado, use o seguinte comando gcloud compute global-vm-extension-policies update:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

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.

  • NEW_CUSTOM_PLAN_NAME: o nome associado ao seu plano de lançamento personalizado atualizado.
  • UUID: um identificador universal exclusivo (UUID) que identifica a solicitação de nova tentativa. Você pode usar qualquer gerador de UUID para criar um. Para mais informações, consulte Tentar de novo um lançamento .

Desinstalar o agente de operações excluindo políticas de extensão de VM

Para desinstalar o agente de operações, exclua a política de extensão de VM que gerencia o agente. Se outra política ativa de menor prioridade se aplicar a uma VM e também gerenciar o agente de operações, ele vai permanecer instalado nessa VM com base na política de menor prioridade.

O Gerenciador de extensões de VM remove o Agente de Operações de todas as VMs acessíveis em até um minuto após a exclusão da política. Se uma VM estiver inacessível, o Gerenciador de extensões de VM vai pular a exclusão do agente. Se a VM ficar disponível novamente, o Gerenciador de extensões de VM removerá o agente nesse momento.

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

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

gcloud

Zonal

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

gcloud 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.

Global

Para excluir a política global de extensão de VM que gerencia o agente de operações, use o comando gcloud compute global-vm-extension-policies delete:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

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.

Para acelerar um lançamento de exclusão já iniciado, emita um novo comando de exclusão que use o plano fast_rollout. Você também precisa especificar a opção --rollout-retry-uuid=UUID:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

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.

  • UUID: um identificador universal exclusivo (UUID) que identifica a solicitação de nova tentativa. Você pode usar qualquer gerador de UUID para criar um. Para mais informações, consulte Tentar de novo um lançamento .

Recuperar informações sobre políticas de extensão de VM

É possível recuperar as seguintes informações sobre as políticas de extensão de VM atuais:

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

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão:

    Acessar as políticas de extensão

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

    Nesta página, listamos todas as políticas de extensão de VM no seu projeto.
  2. Para ver detalhes de uma política de extensão específica, clique no nome dela.

gcloud

Zonal

Listar políticas de extensão de VM

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

gcloud 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 serem listadas por página. Por exemplo, 2. Para mais informações sobre as opções de classificação e filtragem, consulte gcloud compute zone-vm-extension-policies list.

Descrever uma política de extensão de VM nomeada

Para recuperar a configuração de uma política nomeada em uma zona, use o gcloud compute zone-vm-extension-policies describe:

gcloud 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.

Global

Listar políticas globais de extensão de VM

Para listar informações sobre políticas globais de extensão de VM, use o gcloud compute global-vm-extension-policies list:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

Substitua as seguintes variáveis no comando:

  • PROJECT_ID: o identificador do projeto.
  • PAGE_SIZE_INTEGER: o número de políticas a serem listadas por página. Por exemplo, 2. Para mais informações sobre as opções de classificação e filtragem, consulte gcloud compute global-vm-extension-policies list.

Descrever uma política de extensão de VM global nomeada

Para recuperar a configuração de uma política nomeada em uma zona, use o gcloud compute global-vm-extension-policies describe:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

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.

Para informações gerais sobre como usar o console doGoogle Cloud e a CLI gcloud para recuperar informações sobre políticas de extensão de VM, consulte Ver políticas de extensão.

Verificar a instalação do Agente de operações

Esta seção explica como fazer o seguinte:

Verificar o status ou a versão de uma instalação do agente de operações

Para determinar o status ou a versão do Agente de operações, use uma das seguintes páginas do consoleGoogle Cloud :

Compute Engine

  1. No Google Cloud console, 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. Selecione uma VM na lista.
  3. Clique na guia Observabilidade.

Cloud Monitoring

  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 essa página, selecione o resultado com o subtítulo Monitoring.

  2. Selecione a visualização Lista.

Quando o agente de operações é instalado na VM e coleta registros e métricas, o status do agente é marcado com uma marca de seleção verde ao lado do rótulo Agente de operações.

Para determinar a versão do agente instalado, passe o cursor sobre o rótulo Agente de operações no painel do Compute Engine ou do Monitoring.

Verificar se o agente de operações está coletando telemetria

Se o Agente de operações foi instalado e está funcionando corretamente, ele envia métricas para o Cloud Monitoring e registros para o Cloud Logging.

Reiniciar um Agente de Operações instalado por uma política de extensão

Quando o Agente de operações é instalado e gerenciado pelo Gerenciador de extensões de VM, ele não é gerenciado pelo serviço de gerenciamento de sistema do sistema operacional, ou seja, systemd no Linux ou o Gerenciador de serviços do Windows no Windows. Portanto, os comandos systemctl do Linux e *-Service do Windows não funcionam com um agente de operações instalado por uma política de extensão.

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

  • Recrie a política.

    1. Exclua a política. A exclusão da política interrompe e desinstala o agente de operações.

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

  • Use uma política temporária de maior prioridade. Se a política original afetar um grande número de VMs, mas você só quiser reiniciar o Agente de Operações em um pequeno número delas, adicione um rótulo a essas VMs e configure a nova política para filtrar com base no rótulo.

    Por exemplo, se uma política com prioridade 1000 não iniciar o agente de operações em uma VM, adicione um rótulo como status=failed à VM. Em seguida, crie uma política com uma prioridade maior, como 500. Por exemplo, um comando da Google Cloud CLI pode ser parecido com este:

    Zonal 

    gcloud 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.

    Global 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

    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.

    Depois que a nova política instalar o agente de operações, exclua a política e remova o rótulo das VMs. O agente de operações permanece instalado na VM porque a política original ainda está ativa.

Ativar o registro de depuração do agente convidado na VM

As políticas do Gerenciador de extensões de VM usam o agente de convidado do Compute Engine para gerenciar o Agente de operações como uma extensão de VM. Para informações sobre como ativar o registro de depuração do agente convidado, consulte Ver registros de depuração do agente convidado.

Resolver problemas com políticas de extensão

Nesta seção, você encontra informações sobre como solucionar problemas no uso de políticas de extensão para gerenciar o Agente de operações:

Para informações sobre como resolver problemas do Agente de operações, consulte Resolver problemas do Agente de operações.

Falha nos comandos gcloud compute zone-vm-extension-policies

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

Se a saída do comando mencionar permissões insuficientes do IAM, consulte os papéis e permissões necessários descritos em Conceder os papéis necessários para usar o Gerenciador de extensões de VM.

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

Você criou uma política de extensão, mas o agente de operações mostra um status "não detectado" na VM.

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

  • A política de extensão não instala o Agente de operações.
  • Um Agente de operações instalado encontra uma condição de erro que impede a execução.

As seções a seguir descrevem como diagnosticar esses casos.

Verificar se o Agente de operações foi instalado pela política

As políticas do Gerenciador de extensões de VM usam o agente de convidado do Compute Engine para gerenciar 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 uma das seguintes opções para procurar entradas de registro do agente convidado:

Análise de registros

  1. No console do Google Cloud , acesse a página Análise de registros:

    Acessar a Análise de registros

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

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

    log_id("GCEGuestAgentManager")

Linux

Execute o comando a seguir na VM do Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Execute o comando a seguir na VM do Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Se você encontrar registros que contenham uma string como Failed to install plugin "ops-agent-plugin" ... ou se a consulta não retornar nenhum registro, a política de extensão não instalou o agente de operações. Para as próximas etapas, consulte A política de extensão não instala o Agente de operações.

Se você encontrar registros com uma string como Successfully installed plugin "ops-agent_nnnnnnnn", a política de extensão instalou o Agente de operações com sucesso. Para as próximas etapas, consulte O Agente de operações instalado não é detectado.

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 condições for verdadeira:

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

    1. Verifique se a VM está usando um dos sistemas operacionais compatíveis com o ambiente para convidado do Compute Engine.

    2. Confira os pacotes instalados na VM 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 convidado está instalado, mas desatualizado. Para diagnosticar e corrigir essa condição, faça o seguinte:

    1. Valide o ambiente de convidado para determinar a versão do pacote google-guest-agent. O Gerenciador de extensões de VM exige a versão 20241209.01 ou mais recente.

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

  • O sistema operacional da VM não é compatível com o Gerenciador de extensões de VM. Para mais informações, consulte Analisar sistemas operacionais compatíveis.

O Agente de operações instalado tem o status "não detectado"

O Agente de operações pode ter o status "não detectado" se uma das seguintes condições for verdadeira:

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

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

Ativar a geração de registros de depuração do agente convidado

Para informações sobre como ativar o registro de depuração do agente convidado, consulte Ver registros de depuração do agente convidado.

Analisar registros de depuração

Análise de registros

  1. No console do Google Cloud , acesse a página Análise de registros:

    Acessar a Análise de registros

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

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

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

Linux

Execute o comando a seguir na VM do Linux Compute Engine:

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

Windows

Execute o comando a seguir 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 você encontrar registros que contenham a string The agent config file is not valid, a configuração personalizada do Agente de operações fornecida ao criar ou atualizar a política de extensão será inválida.

Para corrigir esse problema, faça o seguinte:

  • Corrija a configuração consultando Configurar o agente de operações. Para informações sobre a estrutura de um arquivo de configuração do Agente de operações.

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

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

Você executa um comando como sudo systemctl status google-cloud-ops-agent"*", mas ele não retorna nenhuma informação.

Quando o Agente de operações é instalado e gerenciado pelo Gerenciador de extensões de VM, ele não é gerenciado pelo serviço de gerenciamento de sistema do sistema operacional, ou seja, systemd no Linux ou o Gerenciador de serviços do Windows no Windows.

Para encontrar as informações de status de um agente de operações gerenciado pelo Gerenciador de extensões de VM, consulte o seguinte:

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

Você executa um comando como sudo systemctl restart google-cloud-ops-agent, mas o Agente de operações não é reiniciado.

Quando o Agente de operações é instalado e gerenciado pelo Gerenciador de extensões de VM, ele não é gerenciado pelo serviço de gerenciamento de sistema do sistema operacional, ou seja, systemd no Linux ou o Gerenciador de serviços do Windows no Windows. Portanto, não é possível parar ou iniciar o Agente de operações manualmente, e comandos como os seguintes não funcionam com ele:

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

Para interromper ou reiniciar um agente de operações gerenciado pelo Gerenciador de extensões de VM, desinstale o agente excluindo a política de extensão. Para mais informações sobre como interromper ou reiniciar o agente de operações, consulte Reiniciar um agente de operações instalado por uma política de extensão.

Outras informações sobre solução de problemas

Para mais informações sobre como resolver problemas na criação e no uso de políticas do Gerenciador de extensões de VM, consulte Resolver problemas de extensões de VM.

Para mais informações sobre como resolver problemas do agente de operações, consulte Resolver problemas do agente de operações.

Cota

Para informações sobre o número de políticas de extensão que podem ser criadas em um projeto Google Cloud , consulte Quota.

Preços

Para informações sobre os custos associados ao uso do Gerenciador de extensões de VM, consulte Preços.

Se você instalar o Agente de operações, poderá ser cobrado pelas métricas, pelos registros ou pelos traces que ele enviar ao projeto Google Cloud . Para informações sobre preços, consulte Preços do Google Cloud Observability.

A seguir