Políticas de plantão

Uma política de plantão decide quem é acionado por um incidente ou alerta, e quem é o próximo se ninguém confirmar. Suas regras de escalonamento são seus níveis, e quem a executa são os incidentes, alertas e episódios que a usam. Esta página explica como criar uma política, o que a executa, o que suas páginas mostram e como cada execução é registrada.

Criar uma política#

Quem é acionado primeiro? é opcional, e só é perguntado a quem pode adicionar regras de escalonamento: se ficar vazio, a política não aciona ninguém até ter uma regra. Descrição e Rótulos ficam em Mais campos. Para adicionar os próximos níveis, veja Regras de escalonamento.

A lista Políticas de plantão mostra de cada política o Nome, a Descrição, os Rótulos e os Proprietários. Selecione políticas para Add Labels, Remove Labels, Add Owner, Remove Owner, Arquivar, Exportar: JSON ou excluí-las. Import JSON cria políticas a partir de uma exportação: uma exportação contém as configurações próprias de uma política, não suas regras de escalonamento nem seus proprietários.

O que executa uma política#

Uma política não aciona ninguém até que algo a execute. Cada incidente, alerta e episódio executa as políticas que tem assim que é criado:

Uma política que várias regras adicionam é executada uma única vez. Uma gravidade nunca executa uma política sozinha: quem faz isso é uma regra de plantão que corresponde a essa gravidade. Um incidente ou alerta criado já confirmado ou resolvido não executa nenhuma das suas políticas. Uma regra de plantão definida como Somente em horário comercial faz as políticas que adiciona aguardarem até esse horário começar.

As páginas de uma política#

Abra uma política a partir da lista. O menu lateral dela reúne tudo sobre ela:

Básico fica aberta; as outras seções começam recolhidas até você clicar nelas.

• Visão geral mostra os Detalhes da política de Plantão e depois Policy at a glance: quantos níveis e destinatários a política tem, quanto tempo falta até o último nível e quantas vezes ela se repete. Responder readiness diz se cada pessoa que ela pode acionar pode ser contatada agora, e Feed da política de plantão lista o que mudou: pessoas, equipes e agendamentos adicionados ou removidos, substituições e passagens de turno.
• Os Proprietários são as pessoas e as equipes responsáveis pela política. Quando um acionamento que ela envia não encontra regra para alguém, ou não pode ser entregue, eles recebem um e-mail; uma política sem proprietários escreve aos proprietários do projeto.
• Logs de notificação lista cada mensagem que a política enviou, com uma aba por canal.
• Substituições de usuário cobre pessoas só nesta política. Veja Substituições de usuário.
• Configurações tem Exportar: Política de plantão e o cartão que arquiva a política.

Repetir uma política#

Quando a espera do último nível acaba sem que ninguém confirme, uma política para, a menos que se repita. Para escolher, abra a página Regras de escalonamento da política e clique em Editar no cartão Política de Repetição abaixo das regras. Editar política de repetição pergunta Se ninguém confirmar depois do último nível:

Uma política que recomeça mais três vezes percorre seus níveis quatro vezes no total. A linha Depois do último nível do cartão diz o que a política faz, e Policy at a glance na Visão geral diz o mesmo em palavras.

Acionar de novo se não for resolvido#

Confirmar encerra os acionamentos de uma política de vez, mesmo que depois ninguém resolva o incidente ou alerta. Em vez disso, uma política pode acionar de novo: abra a página Regras de escalonamento dela, abra Mais configurações na parte de baixo e clique em Editar no cartão Tempo limite após a confirmação. Editar tempo limite após a confirmação pergunta Se for confirmado, mas não resolvido:

Os minutos contam a partir de cada confirmação, e uma política aciona de novo no máximo 5 vezes pelo mesmo incidente, alerta ou episódio. Um novo acionamento começa no nível que estava acionando quando houve a confirmação, aciona quem está de plantão agora nesse nível e segue pelos níveis como a primeira execução. O incidente ou alerta continua confirmado: o novo acionamento é uma execução própria, no seu feed e nos registros de execução da política, onde o seu Status diz "Acionado de novo (1 de 5)".

Quem é acionado de novo confirma pela mensagem, ou com Confirmar de novo na página do incidente ou alerta, e os minutos recomeçam; Escalonar passa o acionamento para o próximo nível. Resolver ou excluir o incidente ou alerta, arquivar ou excluir a política, ou escolher Não acionar de novo o encerra. A linha Depois de uma confirmação do cartão diz o que a política faz, e Mais configurações mostra os minutos enquanto está recolhido. Policy at a glance na Visão geral e Escalation summary dizem o mesmo em palavras.

Registros de execução#

Cada vez que uma política é executada, ela grava um registro de execução, e o registro passa pelos seus status conforme a execução avança:

Você encontra registros de execução em três lugares:

• nos próprios Registros de execução da política, em Registros;
• em Plantão → Avançado → Registros de execução, para todas as políticas, onde os acionamentos diretos de workflows e do chat aparecem como Acionamento direto;
• na página Execuções de plantão de um incidente ou de um alerta.

Cada linha mostra o que disparou a execução, quando, seu Status e quem a confirmou. View Timeline abre a Linha do tempo de execução dela: cada regra de escalonamento, quem ela acionou, por qual agendamento e como cada acionamento terminou. Um agendamento sem ninguém de plantão mostra No one was on call no lugar de uma pessoa. No Status200 Cloud, os registros de execução precisam do plano Growth.

Arquivar ou excluir uma política#

Arquivar tira uma política de serviço e mantém tudo: abra as Configurações da política e clique em Arquivar no cartão de arquivamento dela, ou selecione políticas na lista e escolha Arquivar.

• Uma política arquivada não aciona ninguém. Os incidentes e alertas que a usam a pulam, e uma execução que ainda esteja escalonando para no próximo passo.
• Ela sai da lista Políticas de plantão e vai para Plantão → Avançado → Políticas arquivadas, onde Desarquivar a coloca de volta em serviço.

Excluir política, em Avançado, exclui a política junto com suas regras de escalonamento e substituições de usuário. A exclusão pela lista pede confirmação antes e sugere arquivar no lugar.

Quem pode alterar uma política#

Project Owner, Project Admin, Project Member, On-Call Admin e On-Call Member podem criar, alterar e excluir políticas; Viewer e On-Call Viewer podem lê-las. Em uma função personalizada, as permissões são Create On-Call Duty Policy, Edit On-Call Duty Policy, Delete On-Call Duty Policy e Read On-Call Duty Policy, e uma função limitada a alguns rótulos só alcança as políticas que os têm. Adicionar proprietários e campos personalizados precisa do plano Growth no Status200 Cloud.

API e Terraform#

As políticas de plantão são o recurso /api/on-call-duty-policy, e o recurso status200_on_call_policy no Terraform:

repeatPolicyIfNoOneAcknowledges é false para Parar de acionar e true para Recomeçar a partir do Level 1. Com true e repeatPolicyIfNoOneAcknowledgesNoOfTimes em 0, uma política nunca se repete, e o painel a mostra como Parar de acionar.

acknowledgementTimeoutInMinutes é null para Não acionar de novo, e um número inteiro de minutos de 5 a 1440 para Acionar de novo. O Status200 recusa qualquer outro valor.

Para criar uma política com seu primeiro nível em uma única requisição, veja Criar regras com a API ou o Terraform.

Solução de problemas#

Próximos passos#