Crie e gerencie canais de notificação | Monitoramento da nuvem | Google Cloud, Formulário Notificações de email – Google Workspace Marketplace
Notificação do Google
Esta seção descreve a versão 1.2 do diagrama de carga útil. Certos campos podem não aparecer em todos os pacotes retornados ou apresentar valores vazios, dependendo da configuração da regra de alerta, do estado do incidente ou do recurso monitorado. Alguns campos usam estruturas integradas como valores. Essas estruturas são descritas por referência, porque seu conteúdo também pode variar.
Criar e gerenciar canais de notificação
Este documento explica como configurar canais de notificação usando o Google Cloud Console. O Monitoramento da Cloud usa esses canais para avisá -lo ou enviar uma notificação para a sua equipe ON -CALL quando uma regra de alerta é acionada. Ao criar uma regra de alerta, você pode selecionar usuários que recebem uma notificação selecionando -os na lista de canais de notificação configurados. Por exemplo, você pode configurar alertas que monitoram as instâncias de computação do motor para publicar um pub/sub -sujeito e alertar o canal Slack da equipe ON -Call.
Se o seu canal de notificação favorito não for compatível, considere criar um pipeline baseado no envio de notificações para o pub/sub. Para obter um exemplo python usando o Flask, consulte a página Criar notificações personalizadas com monitoramento da nuvem e corrida em nuvem. Para outros exemplos, consulte o depósito de alerta de nuvem no git de alerta-notificação.
Para configurar canais de notificação usando a API de monitoramento em nuvem, consulte Criar e gerenciar canais de notificação de API.
Percebido : Os dados enviados aos destinatários da cadeia podem conter informações confidenciais. Consulte suas práticas regulatórias antes de criar o canal de notificação.
Para obter mais informações sobre as notificações das regras de alerta, consulte as seguintes páginas:
- Para obter mais informações sobre o atraso entre o início de um problema e a criação de um alerta, consulte a seção de latência de notificações.
- Para saber mais sobre o número de notificações geradas para uma regra de alerta, consulte a seção de notificações de incidentes.
Por padrão, uma regra de alerta envia apenas notificação para a criação de um incidente. Para receber uma notificação quando o incidente estiver aberto ou fechado, modifique a regra de alerta. Na seção de notificações, selecione Notificar o fechamento do incidente.
Antes que você comece
Para obter as autorizações necessárias para exibir e configurar os canais de notificação usando o Google Cloud Console, peça ao seu administrador para atribuir a função de monitoramento do editor do IAM (funções/monitoramento.Editor) em seu projeto. Para saber mais sobre a alocação de funções, consulte a seção Gerenciar acesso.
Você também pode obter as autorizações necessárias por meio de funções personalizadas ou outros papéis predefinidos.
Para saber mais sobre funções de monitoramento em nuvem, consulte a página de acesso de controle com gerenciamento de identidade e acesso.
Crie um canal de notificação
Ao criar uma regra de alerta, você pode selecionar qualquer canal de notificação configurado e adicioná -lo à sua regra. Você pode pré -configurar seus canais de notificação ou configurá -los como parte da criação de uma regra de alerta. Para mais informações, consulte Crie um canal sob demanda.
Percebido : Recomendamos que você crie vários canais de notificação para fins de redundância. O Google não tem controle sobre um grande número de sistemas de entrega depois de transmitir a notificação para eles. Além disso, apenas um serviço do Google é compatível com o App Mobile Cloud, PagerDuty, Webhooks e Slacks. Se você usar um desses canais de notificação, use mensagens redundantes, SMS ou pub/sub.
Para criar um canal de notificação usando o Google Cloud Console, siga as instruções específicas no canal contido na tabela a seguir:
Endereço de email
Para adicionar um canal de notificação por e-mail, prossiga da seguinte maneira:
- No Google Cloud Console, selecione Monitoramento, Então notificaçõesAlerta, ou clique no botão a seguir: acesse a interface de alerta
- Clique em Modificar canais de notificação.
- Na seção E-mail, Clique em Novo.
- Digite um único endereço de e -mail e uma descrição.
- Clique em Salvar.
Se você usar um endereço de e-mail do grupo como um canal de notificação para uma regra de alerta, configure o grupo para aceitar e-mail.com .
Você pode criar canais de mensagens ao criar uma regra de alerta. Para saber mais, consulte Crie uma corrente sob demanda.
Aplicativo móvel
Use o aplicativo móvel do Google Cloud para monitorar os recursos do console do Google Cloud e monitoramento de informações onde quer que você esteja. As notificações do aplicativo móvel do console do Google Cloud são enviadas para um dispositivo ou usuário específico:
- O valor que Dispositivo (Dispositivo) indica que as notificações são enviadas apenas para o dispositivo específico que criou o canal de notificação. Para níveis de dispositivo na escala do dispositivo, o campo Nome de exibição (Nome a ser exibido) Inclui informações do dispositivo.
- Do utilizador indica que as notificações são enviadas para todos os seus dispositivos nos quais o aplicativo móvel do Google Cloud Console está instalado.
O monitoramento em nuvem determina o escopo das notificações ao criar o canal. Você não pode selecionar nem modificar o escopo.
Para configurar um canal de notificação de aplicativos móveis no Google Cloud Console para um projeto específico do Google Cloud, prossiga da seguinte forma:
- Instale o aplicativo móvel do Google Cloud Console na plataforma de download de aplicativos para o seu dispositivo móvel.
- Selecione um projeto a ser exibido no aplicativo móvel do Google Cloud Console. Depois que o projeto foi selecionado, uma troca de dados entre o aplicativo e o projeto selecionado do Google Cloud ocorre. Um canal de notificação é criado quando não há. Depois de alguns minutos, está listado na seção Dispositivos móveis da página Canais de notificação.
Para adicionar seu dispositivo móvel como um canal de notificação para uma regra de alerta, vá para a seção Notificações e selecione Google Cloud Console (Mobile), Em seguida, escolha seu dispositivo móvel na lista.
PagerDuty
A integração com PagerDuty permite a sincronização unidirecional ou bidirecional com o monitoramento. Independentemente da sua configuração, as seguintes condições se aplicam:
- Quando um incidente é criado no monitoramento, um incidente no espelho também é aberto em PagerDuty.
- Você não pode usar PagerDuty para fechar um incidente de monitoramento.
Se você usar uma sincronização de um caminho e corrigir o incidente em Pagerduty, o estado do incidente em Pagerduty será dissociado do estado do incidente no monitoramento. De fato, se você resolver um incidente em PagerDuty, ele está definitivamente fechado em PagerDuty e não pode ser reaberto.
Se você usar a sincronização bidirecional, o monitoramento controla o estado indicado por PagerDuty. Se você corrigir o incidente em PagerDuty e ele estiver aberto pelo monitoramento, o incidente será reaberto em PagerDuty.
Para configurar as notificações PagerDuty, prossiga da seguinte maneira:
- Em Pagerduty : Crie uma conta PagerDuty no site PagerDuty.
- Adicione o canal de notificação PagerDuty:
- No Google Cloud Console, selecione Monitoramento, Então notificaçõesAlerta, ou clique no botão a seguir: acesse a interface de alerta
- Clique em Modificar canais de notificação.
- Na seção PagerDuty, Clique em Novo.
- Digite Nome de exibição (Nome a ser exibido). Este nome deve corresponder ao fornecido à PagerDuty quando você adicionou a integração.
- Digite Chave de serviço de integração gerado por PagerDuty no campo Chave de serviço.
- Clique em Salvar.
- Open PagerDuty
- Selecione Configuração, Selecione Serviços, Então o nome do serviço que você entrou ao configurar a integração.
- Clique em Modificar os parâmetros, Selecione Criar incidentes, Em seguida, desmarque a caixa Criar alertas e incidentes.
Quando você cria uma regra de alerta, selecione PagerDuty na seção Notificações E escolha sua configuração de PagerDuty.
O pacote JSON PagerDuty está no seguinte formato:
Para exibir um exemplo e o esquema de campo detalhado, desenvolva as seguintes seções.
Exemplos JSON
Por padrão, o back -end de alerta está tentando gerar um pacote JSON no formato da versão 1.2. Para saber mais sobre esta formatação, consulte a próxima seção.
Aqui está um exemplo desse tipo de pacote:
< "incident": < "incident_id": "0.opqiw61fsv7p", "scoping_project_id": "internal-project", "scoping_project_number": 12345, "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project", "started_at": 1577840461, "ended_at": 1577877071, "state": "closed", "resource_id": "11223344", "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_type_display_name": "VM Instance", "resource": < "type": "gce_instance", "labels": < "instance_id": "11223344", "project_id": "internal-project", "zone": "us-central1-c" >>, "Métrica": < "type": "compute.googleapis.com/instance/cpu/utilization", "displayName": "CPU utilization", "labels": < "instance_name": "the name of the VM instance" >>, "Metadados": < "system_labels": < "labelkey": "labelvalue" >, "User_labels": < "labelkey": "labelvalue" >>, "Policy_Name": "Monitor-Project-Cluster", "Policy_User_labels": < "user-label-1" : "important label", "user-label-2" : "another label" >, "Condition_name": "VM Instância - Utilização da CPU [max]", "Threshold_value": "0.9 "," observado_value ":" 0.835 "," Condição ": < "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789", "displayName": "VM Instance - CPU utilization [MAX]", "conditionThreshold": < "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"", "aggregations": [ < "alignmentPeriod": "120s", "perSeriesAligner": "ALIGN_MEAN" >], "Comparação": "comparação_gt", "limholdValue": 0.9, "Duração": "0s", "Trigger": < "count": 1 >>>, "Documentação": < "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n", "mime_type": "text/markdown" >, "Resumo": "Utilização da CPU para GGH-cluster interno-projeto-1-16-Defaul-e2df4cbd-dgp3 com rótulos métricos e etiquetas de sistema retornados ao normal com um valor de 0.835.">," versão ":" 1.2 ">
Estrutura do esquema, versão 1.2
Esta seção descreve a versão 1.2 do diagrama de carga útil. Certos campos podem não aparecer em todos os pacotes retornados ou apresentar valores vazios, dependendo da configuração da regra de alerta, do estado do incidente ou do recurso monitorado. Alguns campos usam estruturas integradas como valores. Essas estruturas são descritas por referência, porque seu conteúdo também pode variar.
Em um pacote retornado, os campos podem aparecer em qualquer ordem. Na descrição a seguir, eles são organizados em grupos relacionados.
<
“versão”: “1.2 “,
“incidente”:: < Informações de incidentes “ID de incidente” : corrente ; ID gerado para este incidente.
“Scoping_Project_id” : Canal, ID do projeto que hospeda o escopo das métricas.
“Scoping_Project_Number” : vigilância do número do projeto
“Url” : canal, URL do Google Cloud Console para este incidente.
“Começou às” : Número, tempo (em segundos da época unix) no qual o incidente foi aberto.
“Ended_at” : Número (em segundos epoch unix) durante o qual o incidente foi fechado. Apenas informado quando o estado é fechado .
“Estado” : cadeia, condição do incidente: aberto ou fechado . Se o valor estiver aberto, ended_at é zero.
“Resumo” : cadeia, resumo textual do incidente gerado.
“Apigee_url” : Cadeia, URL de Apigee deste incidente, apenas para os tipos de ambiente de Apigee e Proxy* Recursos* .
“Observado_value” : Cadeia, valor observado tendo acionado/resolvido o alerta, pode estar vazio se a condição tivesse expirado.Informações sobre o recurso monitorado para o qual o incidente foi aberto.
“Recurso”:: <
“tipo” : Cadeia, identificador do tipo de recurso monitorado sujeito a um alerta (por exemplo, gce_instance; veja a lista de recursos monitorados).
“Rótulos” : Pares de objeto/vale-chave para rótulos associados ao recurso supervisionado.
>,
“Resource_type_display_name” : cadeia, nome para exibir o tipo de recurso monitorado.
“Resource_id” : Cadeia, ID da instância do recurso monitorado, o mesmo valor que o recurso.Rótulos.instance_id .
“Resource_Display_Name” : cadeia, nome a exibir recursos supervisionados.
“Nome do recurso” : cadeia, nome gerado para este recurso supervisionado; Contém os valores de outros campos.Informações sobre o tipo de métrica de dados de séries temporais.
“Métrica”:: <
“tipo” : cadeia, identificador do tipo de métrica sujeita a um alerta (por exemplo, calcular.googleapis.com/instância/cpu/utilização; Veja a lista de métricas).
“Nome do Display” : cadeia, nome para exibir o tipo métrico.
“Rótulos” : Pares de objeto/valor para rótulos associados a métricas.
>,
“Metadados”:: <
“System_labels” : Pares de objetos/chaves para etiquetas de metadados do sistema.
“User_labels” : pares de objetos/chaves para etiquetas de metadados do usuário.
>,Informações sobre a regra de alerta e a condição que abriu/resolveu o incidente.
Os valores são extraídos do objeto alertpolicy em questão.“Nome da política” : cadeia, nome a ser exibido para a regra de alerta.
“Policy_User_labels” : pares de chave/valor para toda a redação do usuário associada à regra.
“documentação” : objeto, estrutura integrada no formato de documentação .
“doença” : objeto, estrutura integrada no formato da condição .
“Condition_name” : cadeia, nome para exibir condição, mesmo valor que condição.disputa .
“Valor limiar” : Cadeia (valor limiar dessa condição) pode estar vazio se a condição não for uma condição limite.
>,
>Regras relacionadas ao abandono
O esquema de carga útil está sujeito aos regulamentos relacionados ao abandono do Google Cloud descrito na Seção 1.4 (d) Termos de uso da plataforma do Google Cloud. Observe que o diagrama não controla os formatos dos valores de campo gerados e que esses formatos podem mudar sem aviso prévio. Por exemplo, incidente.Resumo, incidente.documentação.feliz e incidente.O URL pretende incluir dados pertencentes a seus campos, mas o esquema não tem restrições para garantir uma análise precisa desses campos. Você pode usar o valor como um todo e esperar que ele respeite os regulamentos relacionados a abandonos, mas não confie na análise dos campos gerados.
SMS
Para configurar notificações pelo SMS, prossiga da seguinte maneira:
- No Google Cloud Console, selecione Monitoramento, Então notificaçõesAlerta, ou clique no botão a seguir: acesse a interface de alerta
- Clique em Modificar canais de notificação.
- Na seção SMS, Clique em Adicionar.
- Informe a caixa de diálogo e clique em Salvar.
Ao configurar sua regra de alerta, selecione o tipo de notificação SMS E escolha um número de telefone validado na lista.
Folga
Percebido : Para executar essas etapas, você deve ser o proprietário ou administrador do espaço de trabalho Slack. Para mais informações, consulte Gerencie solicitações de convite.
A integração do monitoramento com o Slack permite que suas regras de alerta publiquem dados em um canal Slack quando um incidente é criado. Para configurar notificações de folga, prossiga da seguinte maneira:
- Em folga : Crie um espaço de trabalho e um canal de folga no site Slack. Salve o URL do canal.
- No Google Cloud Console, selecione Monitoramento, Então notificaçõesAlerta, ou clique no botão a seguir: acesse a interface de alerta
- Clique em Modificar canais de notificação.
- Na seção Folga, Clique em Adicionar Para abrir a página de conexão Slack:
- Selecione seu espaço de trabalho Slack.
- Clique em Permitir Para permitir que o monitoramento da nuvem acesse seu espaço de trabalho Slack. Esta ação o leva de volta à página de configuração de monitoramento do seu canal de notificação.
- No campo Nome do Canal Slack, Digite o nome do canal Slack que você deseja usar para notificações.
- No campo Nome do alerta da nuvem, Entre em uma breve investigação. O monitoramento exibe o valor deste campo na página Canal de notificação.
- (Opcional) Para testar a conexão entre o monitoramento da nuvem e o espaço de trabalho do Slack, clique em Envie uma mensagem de teste. Se a conexão resultar, uma mensagem é uma notificação de alerta de teste. é exibido no canal de notificação Slack que você especificou. Consulte o canal de notificação para confirmar a recepção.
/Monitoramento de nuvem @Google
Quando você cria uma regra de alerta, selecione Folga na seção Notificações E escolha sua configuração de folga.
Webhooks
Percebido: Webhooks são compatíveis apenas com pontos de rescisão pública. Se você precisar das notificações a serem enviadas para um ponto de rescisão não público, crie um canal de pub/sub -notificação e configure uma assinatura para o pub/sub. Para obter mais informações, consulte a seção de falhas das notificações de webhook quando configurado para um ponto de rescisão privado.
Percebido: Se uma função em nuvem for configurada como um ponto de terminação webhook para um canal de notificação, verifique se o usuário chamando a função possui a autorização de autenticação necessária. Para saber mais, consulte as seções Autentifique as funções para chamadas de função e ativar o acesso a uma função.
Atenção: Para receber notificações com o Google CAT, implante um serviço em nuvem e envie suas notificações para o anúncio. Para um exemplo dessa configuração, consulte Crie notificações personalizadas com monitoramento da nuvem e execução de nuvem.
Não configure uma notificação do WebHook e depois configure o Google Cat para usar este webhook.
Para configurar as notificações do Webhook, prossiga da seguinte maneira:
- Webhooks Manager : Identifique o URL do ponto de rescisão do público que receberá dados do monitoramento de webhooks.
- No Google Cloud Console, selecione Monitoramento, Então notificaçõesAlerta, ou clique no botão a seguir: acesse a interface de alerta
- Clique em Modificar canais de notificação.
- Na seção Webhook, Clique em Adicionar.
- Preencha a caixa de diálogo.
- Clique em Teste a conexão Para enviar uma taxa de teste do teste no ponto final do webhook. Você pode acessar o ponto de terminação da recepção para verificar a transmissão.
- Clique em Salvar.
Quando você cria uma regra de alerta, selecione Webhook na seção Notificações E escolha sua configuração de webhook. As notificações enviadas por relatórios de erro seguem o diagrama 1.0, enquanto os enviados pelo monitoramento seguem o diagrama 1.2:
Exemplos JSON
Por padrão, o back -end de alerta está tentando gerar um pacote JSON no formato da versão 1.2. Para saber mais sobre esta formatação, consulte a próxima seção.
Aqui está um exemplo desse tipo de pacote:
< "incident": < "incident_id": "0.opqiw61fsv7p", "scoping_project_id": "internal-project", "scoping_project_number": 12345, "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project", "started_at": 1577840461, "ended_at": 1577877071, "state": "closed", "resource_id": "11223344", "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_type_display_name": "VM Instance", "resource": < "type": "gce_instance", "labels": < "instance_id": "11223344", "project_id": "internal-project", "zone": "us-central1-c" >>, "Métrica": < "type": "compute.googleapis.com/instance/cpu/utilization", "displayName": "CPU utilization", "labels": < "instance_name": "the name of the VM instance" >>, "Metadados": < "system_labels": < "labelkey": "labelvalue" >, "User_labels": < "labelkey": "labelvalue" >>, "Policy_Name": "Monitor-Project-Cluster", "Policy_User_labels": < "user-label-1" : "important label", "user-label-2" : "another label" >, "Condition_name": "VM Instância - Utilização da CPU [max]", "Threshold_value": "0.9 "," observado_value ":" 0.835 "," Condição ": < "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789", "displayName": "VM Instance - CPU utilization [MAX]", "conditionThreshold": < "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"", "aggregations": [ < "alignmentPeriod": "120s", "perSeriesAligner": "ALIGN_MEAN" >], "Comparação": "comparação_gt", "limholdValue": 0.9, "Duração": "0s", "Trigger": < "count": 1 >>>, "Documentação": < "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n", "mime_type": "text/markdown" >, "Resumo": "Utilização da CPU para GGH-cluster interno-projeto-1-16-Defaul-e2df4cbd-dgp3 com rótulos métricos e etiquetas de sistema retornados ao normal com um valor de 0.835.">," versão ":" 1.2 ">
Estrutura do esquema, versão 1.2
Esta seção descreve a versão 1.2 do diagrama de carga útil. Certos campos podem não aparecer em todos os pacotes retornados ou apresentar valores vazios, dependendo da configuração da regra de alerta, do estado do incidente ou do recurso monitorado. Alguns campos usam estruturas integradas como valores. Essas estruturas são descritas por referência, porque seu conteúdo também pode variar.
Em um pacote retornado, os campos podem aparecer em qualquer ordem. Na descrição a seguir, eles são organizados em grupos relacionados.
<
“versão”: “1.2 “,
“incidente”:: < Informações de incidentes “ID de incidente” : corrente ; ID gerado para este incidente.
“Scoping_Project_id” : Canal, ID do projeto que hospeda o escopo das métricas.
“Scoping_Project_Number” : vigilância do número do projeto
“Url” : canal, URL do Google Cloud Console para este incidente.
“Começou às” : Número, tempo (em segundos da época unix) no qual o incidente foi aberto.
“Ended_at” : Número (em segundos epoch unix) durante o qual o incidente foi fechado. Apenas informado quando o estado é fechado .
“Estado” : cadeia, condição do incidente: aberto ou fechado . Se o valor estiver aberto, ended_at é zero.
“Resumo” : cadeia, resumo textual do incidente gerado.
“Apigee_url” : Cadeia, URL de Apigee deste incidente, apenas para os tipos de ambiente de Apigee e Proxy* Recursos* .
“Observado_value” : Cadeia, valor observado tendo acionado/resolvido o alerta, pode estar vazio se a condição tivesse expirado.Informações sobre o recurso monitorado para o qual o incidente foi aberto.
“Recurso”:: <
“tipo” : Cadeia, identificador do tipo de recurso monitorado sujeito a um alerta (por exemplo, gce_instance; veja a lista de recursos monitorados).
“Rótulos” : Pares de objeto/vale-chave para rótulos associados ao recurso supervisionado.
>,
“Resource_type_display_name” : cadeia, nome para exibir o tipo de recurso monitorado.
“Resource_id” : Cadeia, ID da instância do recurso monitorado, o mesmo valor que o recurso.Rótulos.instance_id .
“Resource_Display_Name” : cadeia, nome a exibir recursos supervisionados.
“Nome do recurso” : cadeia, nome gerado para este recurso supervisionado; Contém os valores de outros campos.Informações sobre o tipo de métrica de dados de séries temporais.
“Métrica”:: <
“tipo” : cadeia, identificador do tipo de métrica sujeita a um alerta (por exemplo, calcular.googleapis.com/instância/cpu/utilização; Veja a lista de métricas).
“Nome do Display” : cadeia, nome para exibir o tipo métrico.
“Rótulos” : Pares de objeto/valor para rótulos associados a métricas.
>,
“Metadados”:: <
“System_labels” : Pares de objetos/chaves para etiquetas de metadados do sistema.
“User_labels” : pares de objetos/chaves para etiquetas de metadados do usuário.
>,Informações sobre a regra de alerta e a condição que abriu/resolveu o incidente.
Os valores são extraídos do objeto alertpolicy em questão.“Nome da política” : cadeia, nome a ser exibido para a regra de alerta.
“Policy_User_labels” : pares de chave/valor para toda a redação do usuário associada à regra.
“documentação” : objeto, estrutura integrada no formato de documentação .
“doença” : objeto, estrutura integrada no formato da condição .
“Condition_name” : cadeia, nome para exibir condição, mesmo valor que condição.disputa .
“Valor limiar” : Cadeia (valor limiar dessa condição) pode estar vazio se a condição não for uma condição limite.
>,
>Autenticação básica
Além da solicitação do Webhook, o Monitoramento em Cloud envia o nome de usuário e a senha de acordo com a especificação HTTP da autenticação básica. O monitoramento em nuvem exige que seu servidor retorne uma resposta 401 com o cabeçalho WWW-Authenticate. Para obter mais informações sobre autenticação básica, consulte os seguintes recursos:
Autenticação simbólica
A autenticação por token requer um parâmetro de cadeia de solicitações no URL do ponto de terminação, bem como a chave que o servidor espera ser secreto entre si e monitoramento. Você encontrará abaixo um exemplo de URL, incluindo um token:
Se o Monitoring publicar um incidente no URL do ponto de rescisão, seu servidor poderá validar o token associado. Esse método de autenticação é mais eficaz quando usado com SSL/TLS para criptografar a solicitação HTTP para impedir que hackers de computador aprendam o token.
Para obter um exemplo de um servidor Python, consulte este exemplo de servidor.
Regras relacionadas ao abandono
O esquema de carga útil está sujeito aos regulamentos relacionados ao abandono do Google Cloud descrito na Seção 1.4 (d) Termos de uso da plataforma do Google Cloud. Observe que o diagrama não controla os formatos dos valores de campo gerados e que esses formatos podem mudar sem aviso prévio. Por exemplo, incidente.Resumo, incidente.documentação.feliz e incidente.O URL pretende incluir dados pertencentes a seus campos, mas o esquema não tem restrições para garantir uma análise precisa desses campos. Você pode usar o valor como um todo e esperar que ele respeite os regulamentos relacionados a abandonos, mas não confie na análise dos campos gerados.
Pub/sub
Esta seção explica como configurar canais de pub/sub -notificação. Para garantir a redundância, recomendamos que você crie vários canais de notificação. Recomendamos que você associe publicidade/sub a aplicação móvel do Google Cloud Console, PagerDuty, Webhooks ou Slacks, porque o Pub/SU usa um mecanismo de distribuição diferente.
Para configurar um canal de pub/sub -notificação:
- Ative o pub/sub API e crie um assunto
- Configure o canal de notificação para um assunto
- Autorizar uma conta de serviço
- Defina o canal de notificação em uma regra de alerta
Para entender o esquema de dados, veja o exemplo de um diagrama.
Para receber notificações de alerta, você também deve criar uma das seguintes assinaturas: Sweater, Push ou BigQuery.
Quando a assinatura estiver em um projeto diferente do do assunto, crie uma conta de serviço no projeto de assinante e atribua as funções/pubsub.subccreva .
Antes que você comece
Quando você adiciona o primeiro canal de notificação para um projeto do Google Cloud, o Monitoring em Cloud cria uma conta de serviço para este projeto. Ele também fornece o monitoramento do agente de serviço de serviço de identidade e gerenciamento de gerenciamento de função na conta de serviço. Esta conta de serviço permite que o monitoramento envie notificações para canais de notificação com base no pub/su deste projeto.
A conta de serviço possui o seguinte formato:
serviço-Projeto número@GCP-SA-Monitoring-Notification.Eu sou.GServiceAccount.com
O nome da conta de serviço de notificação inclui um número Projeto do Google Cloud. Você encontrará o nome, ID e número do projeto no painel do projeto no Google Cloud Console. Você também pode recuperá -lo usando o seguinte comando:
Os projetos do GCloud descrevem Project_id --Format = "Value (Project_Number)"
Você pode exibir e modificar a conta de serviço usando o Google Cloud Console ou Google Cloud.
Ative o pub/sub API e crie um assunto
- Ative a API PUB/SUP para o seu projeto do Google Cloud:
Ative o pub/sub API- Selecione o projeto do Google Cloud no qual você planeja criar o assunto do pub/sub.
- Clique em Habilitar Quando aparece. Nenhuma ação é necessária quando a mensagem API ativada parece.
Tópicos do Gcloud pubsub Crie notificação de notificação
Em seguida, configure seus canais de pub/sub -notificação.
Configurar notificações para um assunto
Para criar um canal de publicidade/sub -notificação, você pode usar o monitoramento, o Google Cloud Cl Cl ou o Google Cloud Console. Depois de criar o canal de notificação, autorize a conta de serviço de notificações para publicar cada assunto que você usa como um canal de notificação.
Para obter mais informações sobre o uso da API de monitoramento ou Cloud do Google para criar o canal de notificação, consulte Criar canais.
Para criar o canal de notificação usando o Google Cloud Console, prossiga da seguinte forma:
- No Google Cloud Console, selecione Monitoramento, Então notificaçõesAlerta, ou clique no botão a seguir: acesse a interface de alerta
- Selecione o projeto do Google Cloud, que contém o assunto do pub/sub que você criou.
- Clique em Modificar canais de notificação.
- Na seção Pub/sub, Clique em Novo. A caixa de diálogo Criado pub/sub -canal (Pub/sub -canal) exibe o nome da conta de serviço criada pelo monitoramento.
- Autorizar a conta de serviço. Sua conta de serviço pode publicar todos os assuntos ou assuntos específicos:
- Para publicar todos os assuntos, selecione Gerenciar funções e adicione o papel Editor pub/sub. Depois de terminar a configuração do canal de notificação, ignore a próxima seção, intitulada Autorizar a conta de serviço, e vá para o definir o canal de notificação em uma regra de alerta.
- Para publicar assuntos específicos, vá para a próxima etapa e autorize a conta de serviço para publicar assuntos específicos assim que o canal de notificação estiver configurado. Para obter instruções, consulte a seção Autorizar a conta de serviço.
- Digite um nome para exibir para o seu canal e o nome do assunto do pub/sub.
- (Opcional) Para verificar se o canal está configurado corretamente, clique em Envie uma notificação de teste.
- Selecione Adicione uma corrente.
Em seguida, deixe a conta de serviço.
Autorizar a conta de serviço
Percebido : Execute esta etapa ao criar o canal de notificação usando a API ou o Google Cloud CLI, e quando você ignorar a etapa de autorização quando usa o Google Cloud Console.
Autorização permite que a conta do serviço de notificação publique cada assunto pub/su que você usa como um canal de notificação. Esta seção descreve o procedimento a seguir para:
- Autorizar uma conta de serviço para um assunto específico.
- Permitir uma conta de serviço para todos os assuntos.
Autorizar uma conta de serviço para um assunto específico
Você pode permitir que uma conta de serviço publique um assunto específico usando o Google Cloud Console e o Google Cloud. Esta seção descreve ambas as abordagens.
Para autorizar sua conta de serviço para um assunto específico usando o Google Cloud Console, prossiga da seguinte maneira:
- No Google Cloud Console, selecione Pub/sub, Então Temas, Ou clique no botão a seguir: Acesse os tópicos do pub/SUP
- Selecione o assunto.
- Na guia Autorizações, Selecione Adicione uma conta principal.
- No campo Nova conta principal, Digite o nome da conta de serviço de notificações. A conta de serviço usa o seguinte contrato de denominação:
serviço-Projeto número@GCP-SA-Monitoring-Notification.Eu sou.GServiceAccount.com
Para autorizar sua conta de serviço para um assunto específico usando o Google Cloud CLI, atribua a função do IAM PUBSUB na conta de serviço.Editor para o assunto. Por exemplo, o comando a seguir configura o papel do IAM para o assunto do NotificationTópico:
Tópicos do Gcloud Pubsub add-IAM-Polyy-Binding \ Projects/Projeto número/Tópicos/notificationtopic -Role = Papunos/pubsub.Publisher \ --member = Service -Count: Serviço-Projeto número@GCP-SA-Monitoring-Notification.Eu sou.GServiceAccount.com
A resposta a uma execução bem-sucedida do comando add-IAM-Polyy-Binding apresenta-se da seguinte maneira:
Política de IAM atualizada para tópico [NotificationTopic]. Ligações: ‐ Membros: ‐ Serviço -Discover: Serviço-Projeto número@GCP-SA-Monitoring-Notification.Eu sou.GServiceAccount.Com papel: papéis/pubsub.Editor ETAG: bwwcdoiw1pc = versão: 1
Para saber mais, consulte os tópicos do pubsub add-jeam-policy-binding Reference Page .
Autorizar uma conta de serviço para todos os assuntos
Para autorizar sua conta de serviço para todos os assuntos, prossiga da seguinte maneira:
- No Google Cloud Console, selecione EU SOU ou clique no botão a seguir: Access Iam
- Selecione Inclua as atribuições de funções fornecidas pelo Google, Conforme ilustrado na imagem a seguir:
- Procure a conta de serviço no seguinte formato:
serviço-Projeto número@GCP-SA-Monitoring-Notification.Eu sou.GServiceAccount.com
Em seguida, defina o canal de notificação em uma regra de alerta.
Defina o canal de notificação em uma regra de alerta
Para usar um canal de notificação Pub/SU em uma regra de alerta, selecione o tipo de canal Pub/sub, Então o assunto.
Exemplo de diagrama
Para exibir um exemplo de pacote JSON e o diagrama, desenvolva as seguintes seções.
Exemplos JSON
Por padrão, o back -end de alerta está tentando gerar um pacote JSON no formato da versão 1.2. Para saber mais sobre esta formatação, consulte a próxima seção.
Aqui está um exemplo desse tipo de pacote:
< "incident": < "incident_id": "0.opqiw61fsv7p", "scoping_project_id": "internal-project", "scoping_project_number": 12345, "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project", "started_at": 1577840461, "ended_at": 1577877071, "state": "closed", "resource_id": "11223344", "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_type_display_name": "VM Instance", "resource": < "type": "gce_instance", "labels": < "instance_id": "11223344", "project_id": "internal-project", "zone": "us-central1-c" >>, "Métrica": < "type": "compute.googleapis.com/instance/cpu/utilization", "displayName": "CPU utilization", "labels": < "instance_name": "the name of the VM instance" >>, "Metadados": < "system_labels": < "labelkey": "labelvalue" >, "User_labels": < "labelkey": "labelvalue" >>, "Policy_Name": "Monitor-Project-Cluster", "Policy_User_labels": < "user-label-1" : "important label", "user-label-2" : "another label" >, "Condition_name": "VM Instância - Utilização da CPU [max]", "Threshold_value": "0.9 "," observado_value ":" 0.835 "," Condição ": < "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789", "displayName": "VM Instance - CPU utilization [MAX]", "conditionThreshold": < "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"", "aggregations": [ < "alignmentPeriod": "120s", "perSeriesAligner": "ALIGN_MEAN" >], "Comparação": "comparação_gt", "limholdValue": 0.9, "Duração": "0s", "Trigger": < "count": 1 >>>, "Documentação": < "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n", "mime_type": "text/markdown" >, "Resumo": "Utilização da CPU para GGH-cluster interno-projeto-1-16-Defaul-e2df4cbd-dgp3 com rótulos métricos e etiquetas de sistema retornados ao normal com um valor de 0.835.">," versão ":" 1.2 ">
Estrutura do esquema, versão 1.2
Esta seção descreve a versão 1.2 do diagrama de carga útil. Certos campos podem não aparecer em todos os pacotes retornados ou apresentar valores vazios, dependendo da configuração da regra de alerta, do estado do incidente ou do recurso monitorado. Alguns campos usam estruturas integradas como valores. Essas estruturas são descritas por referência, porque seu conteúdo também pode variar.
Em um pacote retornado, os campos podem aparecer em qualquer ordem. Na descrição a seguir, eles são organizados em grupos relacionados.
<
“versão”: “1.2 “,
“incidente”:: < Informações de incidentes “ID de incidente” : corrente ; ID gerado para este incidente.
“Scoping_Project_id” : Canal, ID do projeto que hospeda o escopo das métricas.
“Scoping_Project_Number” : vigilância do número do projeto
“Url” : canal, URL do Google Cloud Console para este incidente.
“Começou às” : Número, tempo (em segundos da época unix) no qual o incidente foi aberto.
“Ended_at” : Número (em segundos epoch unix) durante o qual o incidente foi fechado. Apenas informado quando o estado é fechado .
“Estado” : cadeia, condição do incidente: aberto ou fechado . Se o valor estiver aberto, ended_at é zero.
“Resumo” : cadeia, resumo textual do incidente gerado.
“Apigee_url” : Cadeia, URL de Apigee deste incidente, apenas para os tipos de ambiente de Apigee e Proxy* Recursos* .
“Observado_value” : Cadeia, valor observado tendo acionado/resolvido o alerta, pode estar vazio se a condição tivesse expirado.Informações sobre o recurso monitorado para o qual o incidente foi aberto.
“Recurso”:: <
“tipo” : Cadeia, identificador do tipo de recurso monitorado sujeito a um alerta (por exemplo, gce_instance; veja a lista de recursos monitorados).
“Rótulos” : Pares de objeto/vale-chave para rótulos associados ao recurso supervisionado.
>,
“Resource_type_display_name” : cadeia, nome para exibir o tipo de recurso monitorado.
“Resource_id” : Cadeia, ID da instância do recurso monitorado, o mesmo valor que o recurso.Rótulos.instance_id .
“Resource_Display_Name” : cadeia, nome a exibir recursos supervisionados.
“Nome do recurso” : cadeia, nome gerado para este recurso supervisionado; Contém os valores de outros campos.Informações sobre o tipo de métrica de dados de séries temporais.
“Métrica”:: <
“tipo” : cadeia, identificador do tipo de métrica sujeita a um alerta (por exemplo, calcular.googleapis.com/instância/cpu/utilização; Veja a lista de métricas).
“Nome do Display” : cadeia, nome para exibir o tipo métrico.
“Rótulos” : Pares de objeto/valor para rótulos associados a métricas.
>,
“Metadados”:: <
“System_labels” : Pares de objetos/chaves para etiquetas de metadados do sistema.
“User_labels” : pares de objetos/chaves para etiquetas de metadados do usuário.
>,Informações sobre a regra de alerta e a condição que abriu/resolveu o incidente.
Os valores são extraídos do objeto alertpolicy em questão.“Nome da política” : cadeia, nome a ser exibido para a regra de alerta.
“Policy_User_labels” : pares de chave/valor para toda a redação do usuário associada à regra.
“documentação” : objeto, estrutura integrada no formato de documentação .
“doença” : objeto, estrutura integrada no formato da condição .
“Condition_name” : cadeia, nome para exibir condição, mesmo valor que condição.disputa .
“Valor limiar” : Cadeia (valor limiar dessa condição) pode estar vazio se a condição não for uma condição limite.
>,
>Regras relacionadas ao abandono
O esquema de carga útil está sujeito aos regulamentos relacionados ao abandono do Google Cloud descrito na Seção 1.4 (d) Termos de uso da plataforma do Google Cloud. Observe que o diagrama não controla os formatos dos valores de campo gerados e que esses formatos podem mudar sem aviso prévio. Por exemplo, incidente.Resumo, incidente.documentação.feliz e incidente.O URL pretende incluir dados pertencentes a seus campos, mas o esquema não tem restrições para garantir uma análise precisa desses campos. Você pode usar o valor como um todo e esperar que ele respeite os regulamentos relacionados a abandonos, mas não confie na análise dos campos gerados.
Crie uma cadeia sob demanda
Quando você adiciona um canal de notificação a uma regra de alerta, você deve selecionar um canal em uma lista. Para atualizar a lista de opções ao criar uma regra de alerta, prossiga da seguinte forma:
- Na caixa de diálogo de notificação, clique em Notificação de canal Gerenciar (Gerenciar canais de notificação). Você é redirecionado para a janela Notificação do canal (Canais de notificação) de uma nova guia.
- Para adicionar um novo canal de notificação, procure seu tipo, clique em Novo, Em seguida, siga as instruções específicas para o canal que aparece na tabela anterior.
- Retorne à guia original e, na caixa de diálogo de notificação, clique em AtualizarAtualizar .
- Selecione o canal de notificação na lista atualizada.
Teste um canal de notificação
O monitoramento em nuvem não testa os canais de notificação. No entanto, você pode verificar se um canal de notificação está configurado corretamente criando uma regra de alerta e configurando a condição para que ela seja acionada.
Por exemplo, você pode verificar a configuração de seus canais de notificação aplicando o seguinte procedimento:
- Se o seu projeto do Google Cloud não incluir uma instância do mecanismo de computação, crie um.
- Crie uma regra de alerta para monitorar o uso do processador por este corpo. Se o seu projeto do Google Cloud contiver várias instâncias, adicione um filtro para selecionar uma única instância.
- Configurar os campos de acionador de condição como segue:
- Selecione Limite no campo Tipo de condição.
- Selecione Menor que o limiar para o campo Posição limiar.
- Selecione um valor maior que o uso do processador para sua instância. Por exemplo, se o gráfico indicar que o uso do processador é de aproximadamente 5%, defina o limite em 10%.
- Desenvolver Opções avançadas, Em seguida, selecione Não há novos testes para o campo Janela mais longa.
Esses parâmetros configuram a regra para que ela seja acionada quando o uso do processador de uma instância do mecanismo de computação estiver abaixo do limite especificado. Como você selecionou um limite maior que o uso do processador da sua instância, a condição é acionada.
Editar e excluir canais de notificação
Para modificar ou excluir um canal de notificação usando o Google Cloud Console, prossiga da seguinte forma:
- No Google Cloud Console, selecione Monitoramento, Então notificaçõesAlerta, ou clique no botão a seguir: acesse a interface de alerta
- Clique em Modificar canais de notificação. O painel de Canais de notificação Contém uma seção para cada tipo de canal de notificação. Cada seção lista todas as configurações para este tipo:
- Para modificar uma entrada, clique em editarPara modificar. Clique em Salvar Uma vez que as mudanças feitas.
- Para excluir uma entrada, clique em Excluir EXCLUIR. Clique em EXCLUIR Na caixa de diálogo de confirmação.
Mostre os jornais do canal de notificação
Você pode usar o explorador de jornais para exibir erros no canal de notificação:
- No Google Cloud Console, selecione Exploração madeireira, Então Explorador de jornais, Ou clique no botão a seguir: acesse o explorador de jornais
- Entre e execute seu pedido. Para solicitações específicas de erros nos canais de notificação, consulte a seção Solicitações de monitoramento em nuvem.
Comente
Salvo indicação em contrário, o conteúdo desta página é governado por uma licença Creative Commons Cesatibilidade 4.0, e amostras de código são regidas por uma licença Apache 2.0. Para mais informações, consulte as regras do site do Google Developers. Java é uma marca registrada da Oracle e/ou de suas empresas afiliadas.
Última atualização em 2023/08/26 (UTC).
Notificação do Google
Formulário de notificações por email
Envie e -mails, gerar PDF, certificados, faturas, cartas de notícias, documentos profissionais, integrá -los em Slack, Zappier, Google Chat ou outros aplicativos.
Folha de atualização: 20 de setembro de 2023
Mais informações sobre revisões de usuários
Usando "Notificações de email do formulário" (pelo formulário Notify), você pode enviar notificações de email personalizadas, gerar faturas, certificados, boletins, cartas comerciais e outros PDFs e documentos perfeitos. Você pode encontrar informações detalhadas sobre o que o módulo adicional pode fazer por você visitando nosso formulário Notificar o site HTTPS: // www.formnotify.com/produto usando isso, você (proprietário do formulário) pode - alertar qualquer pessoa enviando automaticamente um rico html e -mail - crie, configure e personalize a notificação por e -mail para entrevistados formais - envie um e -mail personalizado para Os entrevistados e outros funcionários - geram PDFs perfeitos para o pixel mais próximo, como uma fatura, um boletim informativo, um certificado, uma carta comercial ou qualquer outro documento de aspecto profissional - limite o formulário aberta e fechando de acordo com uma data específica e/ou Uma hora de tempo recorrente - retorne as respostas anteriores do formulário - configure vários processadores que podem enviar e -mails para diferentes destinatários - suspender temporariamente o envio de notificações - dor a geração do documento -Junte -se a um PDF às suas notificações E -MAIL - use expressões para personalizar o valor de acordo com as respostas do formulário - integre o código QR ao e -mail - importar e exportar seus dados configurados - avise todas as pessoas que você deseja, configurando ganchos da web e Integrando -os em aplicativos como Google Chat, Slack, Zappier, IFTTTT ou outros Serviços da Web - notifique os usuários por telefone por notificação de push - integração com qualquer aplicativo usando HTTP REST. - Importação e exportação de ganchos da web - Envie as pontuações do teste para os pais como parte da notificação - mantenha o formulário aberto durante certos períodos desenvolvidos pelo formulário de notificação (https: // formnotify.com) Para relatar problemas com este módulo adicional, visite https: // forms.GLE/TSMVVAFVWLJEXAAV7
Informações adicionais
Preços não disponíveis
Confidencialidade
Termos de uso
Formulário de notificações por email pedirei as autorizações abaixo. Saber mais
Formulário Notificações de email precisarão acessar sua conta do Google
As notificações por email do formulário podem, portanto, executar as seguintes ações:
Consulte, modifique, crie e exclua todos os seus documentos do Google Docs
Mostre, crie e exclua seus próprios dados de configuração no Google Drive
Mostre, crie e exclua seus próprios dados de configuração no Google Drive
Consulte, modifique, crie e exclua apenas os arquivos específicos do Google Drive que você usa com este aplicativo
Mostrar e gerenciar os formulários em que este aplicativo foi instalado