Nesta página, descrevemos como configurar alertas para execuções de jobs com falha de uma tarefa do Dataplex.
É possível configurar alertas usando uma das seguintes opções:
- Análise de registros no console do Google Cloud
- API Monitoring
Terminologia
- Duração do fechamento automático de incidentes: o período após o qual um incidente é fechado quando não há entradas de registro correspondentes.
- Tempo entre as notificações: tempo mínimo entre o recebimento de notificações para registros que correspondem a um filtro. Qualquer registro correspondente dentro do tempo mínimo é ignorado. O tempo mínimo que você pode definir é de 5 minutos.
Configurar notificações usando a Análise de registros
- Abra o Console do Google Cloud no navegador.
- Clique em Menu de navegação > Logging > Análise de registros.
Clique no botão de alternância Mostrar consulta.
Para configurar um alerta de falha na execução de qualquer tarefa do Dataplex em um projeto, digite a seguinte consulta:
severity=ERROR resource.type = "dataplex.googleapis.com/Task" logName = "projects/PROJECT_NAME/logs/dataplex.googleapis.com%2Fprocess" jsonPayload.state = "FAILED"
Para configurar um alerta de falha na execução de um job para uma tarefa específica do Dataplex em um projeto, faça o seguinte: digite a seguinte consulta:
severity=ERROR resource.type = "dataplex.googleapis.com/Task" resource.labels.task_id = TASK_ID logName = "projects/PROJECT_NAME/logs/dataplex.googleapis.com%2Fprocess" jsonPayload.state = "FAILED"
Clique em Criar alerta.
No campo Nome da política de alertas, digite um nome para o novo alerta.
No campo Documentação, insira a descrição que você quer incluir na notificação. Para mais informações sobre o conteúdo que pode ser incluído no campo de documentação de uma política de alertas, consulte Como usar o Markdown e variáveis em modelos de documentação.
Clique em Próxima.
Escolha os registros que você quer incluir no alerta e clique em Próxima.
Defina o Tempo entre as notificações e a Duração do fechamento automático de incidentes e clique em Próxima.
Opcional: selecione um canal de notificação. Para mais informações sobre como configurar canais de notificação usando o console do Google Cloud, consulte Gerenciar canais de notificação.
Clique em Salvar.
Configurar notificações usando a API Monitoring
- Ative a API Monitoring e autorize os usuários a acessá-la. Para mais informações, consulte Como ativar a API Monitoring.
- Defina as funções ou permissões necessárias para criar uma política de alertas. Para mais informações, consulte Autorização necessária para criar políticas de alertas.
- Crie um canal de notificação usando o console do Google Cloud ou a CLI do Google Cloud.
Consiga o
channel_id
usando o seguinte comando:gcloud beta monitoring channels list
Crie um arquivo
policy.json
com o seguinte conteúdo para log-based-alerting-policy:Para configurar um alerta para uma execução de job com falha de qualquer tarefa do Dataplex em um projeto, use o seguinte código:
{ "displayName": "Alert Using Monitoring API", "documentation": { "content": "Log-based alert in project PROJECT.", "mimeType": "text/markdown" }, "conditions": [ { "displayName": "Log match condition: Failed Job Execution", "conditionMatchedLog": { "filter": "severity=\"ERROR\" resource.type = \"dataplex.googleapis.com/Task\" logName = \"projects/PROJECT_ID/logs/dataplex.googleapis.com%2Fprocess\" jsonPayload.state = \"FAILED\"", }, } ], "combiner": "OR", "alertStrategy": { "notificationRateLimit": { "period": "300s" }, "autoClose": "604800s", }, "notificationChannels": [ "projects/PROJECT_ID/notificationChannels/CHANNEL_ID" ] }
Para configurar um alerta de falha na execução de um job para uma tarefa específica do Dataplex em um projeto, faça o seguinte: use este código:
{ "displayName": "Alert Using Monitoring API", "documentation": { "content": "Log-based alert in project PROJECT.", "mimeType": "text/markdown" }, "conditions": [ { "displayName": "Log match condition: Failed Job Execution", "conditionMatchedLog": { "filter": "severity=\"ERROR\" resource.type = \"dataplex.googleapis.com/Task\" logName = \"projects/PROJECT_ID/logs/dataplex.googleapis.com%2Fprocess\" jsonPayload.state = \"FAILED\" resource.labels.task_id = \"TASK_ID\"", }, } ], "combiner": "OR", "alertStrategy": { "notificationRateLimit": { "period": "300s" }, "autoClose": "604800s", }, "notificationChannels": [ "projects/PROJECT_ID/notificationChannels/CHANNEL_ID" ] }
Transmita o arquivo
policy.json
para a CLIgcloud
usando o seguinte comando:gcloud alpha monitoring policies create --policy-from-file="policy.json"
Se for bem-sucedido, o comando retornará o nome do recurso da nova política. Exemplo:
Created alert policy [projects/PROJECT_ID/alertPolicies/*POLICY_ID*].
A seguir
- Saiba mais sobre o Cloud Logging.
- Saiba mais sobre o monitoramento do Dataplex.