Gerenciar monitores sintéticos

Neste documento, descrevemos como gerenciar monitores sintéticos. Você pode consultar uma lista dos monitores sintéticos e, para cada monitor sintético, acessar e modificar a configuração, visualizar o histórico de execução e detalhes sobre cada execução. Você pode gerenciar seus monitores sintéticos usando o console do Google Cloud ou a API Cloud Monitoring.

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

Antes de começar

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

  • Editor do Monitoring (roles/monitoring.editor)
  • Desenvolvedor do Cloud Functions (roles/cloudfunctions.developer)

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

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

• As instruções da API nesta página são referentes ao APIs Explorer. No entanto, também é possível emitir um comando curl. O APIs Explorer fornece o comando syntax.

Listar monitores sintéticos

Console

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

1. No console do Google Cloud, acesse Página  Monitoramento sintético:

   Acesse Monitoramento sintético

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

2. Opcional: para restringir os monitores sintéticos que são listados, adicione filtros.

   Cada filtro é composto por um nome e um valor. É possível definir o valor como uma correspondência exata para um nome de monitor sintético ou parcial. As correspondências não diferenciam maiúsculas de minúsculas. Por exemplo, para listar todos monitores sintéticos com o nome default, 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 listado se o nome corresponder a default ou Testing check.

A página Monitores sintéticos exibe o seguinte 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 um política de alertas, use o Menu Mais opções.

gcloud

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

gcloud monitoring uptime list-configs

Os dados retornados incluem o seguinte:

• Nome e nome de exibição.
• Verificar identificador.
• Recurso monitorado.
• Período entre as 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 seu projeto do Google Cloud, incluindo: verificações de tempo de atividade, chame o método Método projects.uptimeCheckConfigs.list:

1. Clique em projects.uptimeCheckConfigs.list.

2. Usar a ferramenta APIs Explorer.

   Defina o pai do método como o nome do projeto, verifique se você 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 acessar os detalhes de um monitor sintético no seu projeto do Google Cloud, faça o seguinte: faça o seguinte:

1. No console do Google Cloud, acesse Página  Monitoramento sintético:

   Acesse Monitoramento sintético

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

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

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

gcloud

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

gcloud monitoring uptime describe CHECK_ID

Antes de executar o comando anterior, substitua CHECK_ID por o identificador da verificação de tempo de atividade ou do monitor sintético. Encontre a identificador executando o comando gcloud monitoring uptime list-configs e examine o campo name. Para mais informações, consulte Encontre 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 as verificações.

API

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

1. Clique em projects.uptimeCheckConfigs.get.

2. Usar a ferramenta APIs Explorer.

   Defina o pai do método como o identificador do monitor sintético. 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, emita a 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

Observação :se você quiser modificar apenas a função do Cloud, você pode usar o Página Detalhes da função ou Detalhes do monitor sintético. Em ambos os casos, você deve selecionar a opção de edição, fazer as alterações e implantar a função do Cloud modificada.

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

1. No console do Google Cloud, acesse Página  Monitoramento sintético:

   Acesse Monitoramento sintético

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

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.

   Para verificadores de links corrompidos, para modificar o URI de origem ou as opções que definir quais links serão testados, editar a função do Cloud 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, executar gcloud monitoring uptime update comando:

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 monitor sintético. Para encontrar o identificador, execute o comando o comando gcloud monitoring uptime list-configs e examine o campo name. Para mais informações, consulte Encontre o identificador exclusivo de uma verificação de tempo de atividade.

• Defina os campos que você quer modificar. Para monitores sintéticos, você pode atualize apenas 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 fazem parte de um monitor sintético. Por isso, elas não podem ser editadas pelo procedimento descrito nesta seção:

• Para modificar uma política de alertas, use o console do Google Cloud ou chame o método método alertPolicies.patch. Para mais informações, consulte Gerenciar políticas de alertas por API.

• Para modificar uma função do Cloud, depois de atualizar a origem da função você precisa reimplantá-la. Para mais informações, consulte Implantar uma função do Cloud.

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

1. Clique em projects.uptimeCheckConfigs.patch.

2. Usar a ferramenta APIs Explorer.

   1. Defina o pai do método como o identificador do monitor sintético. 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, emita a 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 do objeto estão sendo modificados. Por exemplo, para atualizar valor de displayName, o parâmetro de consulta ficará assim:

      updateMask=displayName
      

Copiar um monitor sintético

Console

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

1. No console do Google Cloud, acesse Página  Monitoramento sintético:

   Acesse Monitoramento sintético

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

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 os campos pré-preenchidos. incluindo uma cópia da função do Cloud.

3. Clique em Criar função, atualize conforme necessário e 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, sua função do Cloud é criada e implantado, e o monitor sintético é criado.

gcloud

Não existe um método da 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 faça uma cópia seguindo estas etapas:

1. Chame o método projects.uptimeCheckConfigs.get. e salvar a resposta. Para mais informações, consulte Veja os detalhes de um monitor sintético.
2. Edite a resposta.
3. Chame o método projects.uptimeCheckConfigs.create e passar a resposta editada ao método.

Excluir um monitor sintético

Console

Observação: quando você exclui uma verificação de tempo de atividade ou um monitor sintético usando o console do Google Cloud, as políticas de alertas associadas também são excluídas. No entanto, excluir um monitor sintético não exclui a função do Cloud.

Para excluir um monitor sintético e todas as políticas de alertas associadas, faça o seguinte: faça o seguinte:

1. No console do Google Cloud, acesse Página  Monitoramento sintético:

   Acesse Monitoramento sintético

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

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, em seguida, selecione a guia Código e, em seguida, clique no nome da função. A página Detalhes das funções é 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

Observação: não é possível excluir uma verificação de tempo de atividade ou um monitor sintético usando o Google Cloud CLI ou API Cloud Monitoring quando há uma política de alertas associada a essa verificação de tempo de atividade ou monitor sintético. Você deve exclua a política de alertas primeiro. Não é possível excluir um monitor sintético excluir a função do Cloud.

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

gcloud monitoring uptime delete CHECK_ID

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

API

Observação: não é possível excluir uma verificação de tempo de atividade ou um monitor sintético usando o Google Cloud CLI ou API Cloud Monitoring quando há uma política de alertas associada a essa verificação de tempo de atividade ou monitor sintético. Você deve exclua a política de alertas primeiro. Não é possível excluir um monitor sintético excluir a função do Cloud.

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

1. Clique em projects.uptimeCheckConfigs.delete.

2. Usar a ferramenta APIs Explorer.

   Defina o pai do método como o identificador do monitor sintético. 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, emita a 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 a ele uma identificador. Esse identificador está incorporado O nome do recurso do monitor sintético e tem o formato:

projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

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

A seguir

• Criar um monitor sintético
• Explorar os resultados do monitor sintético