Gerenciar monitores sintéticos

Neste documento, descrevemos como gerenciar os monitores sintéticos. É possível conferir uma lista de monitores sintéticos e, para cada monitor sintético, é possível visualizar e modificar a configuração, visualizar o histórico de execução e conferir detalhes sobre cada execução. É possível gerenciar os monitores sintéticos usando o console do Google Cloud ou a API Cloud Monitoring.

Para informações sobre como explorar os resultados da execução e as métricas e registros de um monitor sintético, consulte Explorar os resultados do monitor sintético.

Antes de começar

  • Para receber as permissões necessárias para visualizar e modificar monitores sintéticos usando o console do Google Cloud, peça ao administrador para conceder a você os seguintes papéis do IAM no seu projeto:

    Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

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

  • As instruções da API nesta página são referentes ao APIs Explorer. No entanto, você também pode emitir um comando curl. O APIs Explorer fornece a sintaxe curl.

Listar monitores sintéticos

Console

Para listar os monitores sintéticos no seu projeto do Google Cloud, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Monitoramento sintético:

    Acesse Monitoramento sintético

  2. Opcional: adicione filtros para restringir os monitores sintéticos listados.

    Cada filtro é composto por um nome e um valor. Você pode definir o valor como uma correspondência exata para um nome de monitor sintético ou uma correspondência parcial. As correspondências não diferenciam maiúsculas de minúsculas. Por exemplo, para listar todos os monitores sintéticos que têm default no nome, faça o seguinte:

    • Clique em Filtrar tabela e selecione Exibir nome.
    • Digite default e pressione a tecla Enter.

    Se você tiver vários filtros, os filtros serão unidos automaticamente por um AND lógico, a menos que você insira um filtro OR. O exemplo anterior usa o filtro OR para que uma verificação de tempo de atividade seja listada se o nome corresponder a default ou Testing check.

A página Monitores sintéticos exibe as seguintes informações para cada monitor sintético:

  • Status da execução mais recente.
  • Um link para informações detalhadas sobre o monitor sintético.
  • A taxa de sucesso e o tempo médio de execução.
  • O número de políticas de alertas.
  • Para editar, copiar ou excluir o monitor sintético e criar uma política de alertas, use o menu Mais opções.

gcloud

Para listar as verificações de tempo de atividade e os monitores sintéticos, execute o comando gcloud monitoring uptime list-configs:

gcloud monitoring uptime list-configs

Os dados retornados incluem o seguinte:

  • Nome e nome de exibição.
  • Verificar identificador.
  • Recurso monitorado.
  • Período entre verificações.

É possível configurar o comando da Google Cloud CLI para filtrar e classificar os resultados.

API

Para listar os monitores sintéticos no projeto do Google Cloud, incluindo verificações de tempo de atividade, chame o método projects.uptimeCheckConfigs.list:

  1. Clique em projects.uptimeCheckConfigs.list.

  2. Usar o APIs Explorer.

    Defina o parent do método como o nome do projeto. Use o seguinte formato:

    projects/PROJECT_ID

    Na expressão anterior, PROJECT_ID é o ID do projeto do Google Cloud.

Para um monitor sintético, o resultado contém um campo chamado syntheticMonitor.

Mais detalhes de um monitor sintético

Console

Para visualizar os detalhes de um monitor sintético no seu projeto do Google Cloud, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Monitoramento sintético:

    Acesse Monitoramento sintético

  2. Para abrir a página Detalhes do monitor sintético, localize o monitor sintético que você quer ver e clique no nome dele.

    Se você quiser ver sua função do Cloud na página Detalhes das funções fornecida pelo Cloud Functions, selecione a guia Código e clique no nome da função. A página Detalhes do Functions é aberta em uma nova janela. As guias dessa página permitem visualizar métricas, registros e informações de configuração.

gcloud

Para listar os detalhes de uma verificação de tempo de atividade ou monitor sintético, execute o comando gcloud monitoring uptime describe:

gcloud monitoring uptime describe CHECK_ID

Antes de executar o comando anterior, substitua CHECK_ID pelo identificador da verificação de tempo de atividade ou do monitor sintético. Para encontrar o identificador, execute o comando gcloud monitoring uptime list-configs e examine o campo name. Para mais informações, consulte Encontrar o identificador exclusivo de um monitor sintético.

Os dados retornados para a verificação de tempo de atividade incluem o seguinte:

  • Nome e nome de exibição.
  • Verificar identificador.
  • Recurso monitorado.
  • Período entre verificações.

API

Para listar os detalhes de um monitor sintético específico no seu projeto do Google Cloud, chame o método projects.uptimeCheckConfigs.get:

  1. Clique em projects.uptimeCheckConfigs.get.

  2. Usar o APIs Explorer.

    Defina o parent do método como o identificador do monitor sintético e use o seguinte formato:

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    Na expressão anterior, PROJECT_ID é o ID do projeto do Google Cloud e CHECK_ID é o ID do monitor sintético.

    Por exemplo, o valor do campo pai pode ser:

    projects/my-project/uptimeCheckConfigs/10863117100295372627

    Para encontrar o valor do CHECK_ID, você pode emitir o método projects.uptimeCheckConfigs.list. Para reduzir o número de resultados retornados, inclua um filtro. Por exemplo, adicione o filtro displayName="MySyntheticMonitor".

Editar um monitor sintético ou uma função do Cloud

Console

Para editar um monitor sintético ou a respectiva função do Cloud usando a página Detalhes do monitor sintético, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Monitoramento sintético:

    Acesse Monitoramento sintético

  2. Localize o monitor sintético que você quer editar, clique em Mais opções e selecione Editar.

  3. Opcional: para editar a função do Cloud, clique em Editar função, faça as alterações e clique em Aplicar função.

    Em verificadores de links corrompidos, para modificar o URI de origem ou as opções que definem quais links são testados, edite a função do Cloud e atualize o objeto options no arquivo index.js. Para informações sobre os campos e a sintaxe desse objeto, consulte broken-links-ok/index.js.

  4. Para manter as modificações, clique em Salvar. Caso contrário, clique em Cancelar.

gcloud

Para modificar uma verificação de tempo de atividade ou um monitor sintético, execute o comando gcloud monitoring uptime update:

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS

Antes de executar o comando anterior, faça o seguinte:

  • Substitua CHECK_ID pelo identificador da verificação de tempo de atividade ou do monitor sintético. Para encontrar o identificador, execute o comando gcloud monitoring uptime list-configs e examine o campo name. Para mais informações, consulte Encontrar o identificador exclusivo de uma verificação de tempo de atividade.

  • Defina quais campos você quer modificar. Para monitores sintéticos, só é possível atualizar os seguintes campos:

    • Período
    • Nome de exibição
    • Tempo limite
    • Identificadores do usuário

Por exemplo, para definir o período de um monitor sintético como 10 minutos, execute o seguinte comando:

gcloud monitoring uptime update CHECK_ID --period=10

API

As políticas e funções de alertas não são contidas em um monitor sintético e, portanto, não podem ser editadas pelo procedimento descrito nesta seção:

Para editar um monitor sintético, chame o método projects.uptimeCheckConfigs.patch:

  1. Clique em projects.uptimeCheckConfigs.patch.

  2. Usar o APIs Explorer.

    1. Defina o parent do método como o identificador do monitor sintético e use o seguinte formato:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

      Na expressão anterior, PROJECT_ID é o ID do projeto do Google Cloud e CHECK_ID é o ID do monitor sintético.

      Para encontrar o valor do CHECK_ID, você pode emitir o método projects.uptimeCheckConfigs.list. Para reduzir o número de resultados retornados, inclua um filtro. Por exemplo, adicione o filtro displayName="MySyntheticMonitor".

    2. Defina o parâmetro de consulta do método, updateMask, para identificar quais campos no objeto estão sendo modificados. Por exemplo, para atualizar o valor de displayName, o parâmetro de consulta é o seguinte:

      updateMask=displayName

Copiar um monitor sintético

Console

Para copiar um monitor sintético no seu projeto do Google Cloud, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Monitoramento sintético:

    Acesse Monitoramento sintético

  2. Localize o monitor sintético que você quer editar, clique em Mais opções e selecione Copiar.

    A caixa de diálogo Copiar verificação sintética é aberta com campos pré-preenchidos, incluindo uma cópia da função do Cloud.

  3. Clique em Criar função, atualize a função conforme necessário e, em seguida, clique em Aplicar função.

  4. Para manter as modificações, clique em Criar. Caso contrário, clique em Cancelar.

    Quando você clica em Criar, a função do Cloud é criada e implantada e, em seguida, o monitor sintético é criado.

gcloud

Não há um método do Google Cloud CLI que permita copiar um monitor sintético.

API

Não existe um método de API que permita copiar um monitor sintético. No entanto, é possível fazer uma cópia seguindo estas etapas:

  1. Chame o método projects.uptimeCheckConfigs.get e salve a resposta. Para mais informações, consulte Visualizar detalhes de um monitor sintético.
  2. Edite a resposta.
  3. Chame o método projects.uptimeCheckConfigs.create e transmita a resposta editada para o método.

Excluir um monitor sintético

Console

Para excluir um monitor sintético e qualquer política de alertas associada, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Monitoramento sintético:

    Acesse Monitoramento sintético

  2. Localize o monitor sintético que você quer excluir e clique no nome.

  3. Opcional: se você quiser excluir a função do Cloud, selecione a guia Código e clique no nome da função. A página Detalhes do Functions é aberta em uma nova janela.

  4. Na página Detalhes do monitor sintético, clique em Excluir e preencha a caixa de diálogo.

    Você excluiu o monitor sintético.

  5. Para excluir a função do Cloud, acesse a página Detalhes das funções, clique em Excluir e preencha a caixa de diálogo.

gcloud

Para excluir uma verificação de tempo de atividade ou monitor sintético, execute o comando gcloud monitoring uptime delete:

gcloud monitoring uptime delete CHECK_ID

Antes de executar o comando anterior, substitua CHECK_ID pelo identificador da verificação de tempo de atividade ou do monitor sintético. Para encontrar o identificador, execute o comando gcloud monitoring uptime list-configs e examine o campo name. Para mais informações, consulte Encontrar o identificador exclusivo de um monitor sintético.

API

Para excluir um monitor sintético e as políticas de alertas associadas, chame o método projects.uptimeCheckConfigs.delete:

  1. Clique em projects.uptimeCheckConfigs.delete.

  2. Usar o APIs Explorer.

    Defina o parent do método como o identificador do monitor sintético e use o seguinte formato:

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    Na expressão anterior, PROJECT_ID é o ID do projeto do Google Cloud e CHECK_ID é o ID do monitor sintético.

    Para encontrar o valor do CHECK_ID, você pode emitir o método projects.uptimeCheckConfigs.list. Para reduzir o número de resultados retornados, inclua um filtro. Por exemplo, adicione o filtro displayName="MySyntheticMonitor".

Encontrar o identificador exclusivo de um monitor sintético

Quando o monitor sintético é criado, o Monitoring atribui um identificador a ele. Esse identificador é incorporado ao nome do recurso do monitor sintético e tem o seguinte formato:

projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

O CHECK_ID está incluído na resposta dos métodos da Google Cloud CLI e da API Cloud Monitoring que criam ou listam monitores sintéticos.

A seguir