Fluxo de trabalho

Com o fluxo de trabalho, você controla quando e onde deseja receber notificações sobre problemas, encaminha as informações corretas para a pessoa ou equipe relevante e enriquece a notificação do seu problema com dados adicionais da New Relic.

O que é um problema?

Problemas são grupos de incidentes que descrevem o problema subjacente aos seus sintomas. Quando um novo incidente é criado, a inteligência do incidente abre um problema e avalia outros problemas abertos em busca de correlações. Para obter mais informações, consulte Usar inteligência de incidente.

Como o fluxo de trabalho é acionado?

Um fluxo de trabalho é acionado por evento de problema para problemas que correspondem ao filtro de fluxo de trabalho e aos seus gatilhos de notificação correspondentes. O fluxo de trabalho é configurado com acionadores recomendados por padrão, mas você pode controlar quando acionar uma notificação para cada destino clicando nos três pontos e escolhendo Notify when. O acionador de notificação Activated também deve estar ativado.

O evento a seguir aciona o fluxo de trabalho e envia notificação aos endpoints de destino relevantes:

Permissões necessárias

O uso do fluxo de trabalho requer permissões específicas.

• Para acessar destinos: View permissões para Applied intelligence > Destinations ou Alerts.
• Para acessar o fluxo de trabalho: View permissões para Applied intelligence > Workflows.
• Para criar fluxo de trabalho: Modify permissões para Applied intelligence > Workflows e Applied intelligence > Channels.
• Para modificar o fluxo de trabalho: Modify permissões para Applied intelligence > Workflows e todas as permissões para Applied intelligence > Channels e applied_intelligence.create.workflow.
• Para excluir fluxo de trabalho: Delete permissões para Applied intelligence > Workflows e Applied intelligence > Channels.

Adicionar um fluxo de trabalho

O recurso fluxo de trabalho está localizado no menu Alerts .

1. Vá para one.newrelic.com > All capabilities > Alerts > Enrich and Notify > Workflow > Add a workflow.

2. Dê um nome ao seu fluxo de trabalho. Este campo é obrigatório e precisa ser único.

3. Com o fluxo de trabalho, filtre seus problemas e envie-os para o destino relevante. Você pode criar uma consulta para filtrar os problemas certos.

   Dica

   Para configurar notificações separadas sobre WARNING incidente, filtre por problemas com prioridade igual a HIGH.

4. Crie uma consulta selecionando um atributo, operador e valores para restringir os problemas certos que você deseja transmitir.

   Dica

   O filtro de fluxo de trabalho é preenchido automaticamente com dados de problemas anteriores, bem como alguns valores estáticos dos metadados da condição (como o nome da condição). Se você não conseguir encontrar o valor que procura, digite-o e selecione Enter new. Às vezes, ocorre um aviso de que o filtro não corresponde a nenhum problema anterior.

5. Recomendado: filtre os problemas por tag de equipe para que todas as equipes possam ser notificadas quando sua entidade for incluída em um problema. As etapas podem ser encontradas na demonstração abaixo:

   Para obter algumas dicas sobre como usar tags, consulte esta postagem no fórum de suporte sobre padrões de fluxo de trabalho.

6. Opcional: enriqueça seus dados.

   Como enriquecer dados

   Atualmente, você só pode enviar saídas JSON ou numéricas para destinos Webhook e Jira. Além disso, você só pode enviar imagens para outros destinos como Slack, PagerDuty, ServiceNow (aplicativo) e e-mail. Para obter melhores resultados no Webhook e no Jira, use uma consulta que tenha uma saída de valor único, como count, min ou max.

   Detalhes sobre o uso de enriquecimentos:

   • Os enriquecimentos podem fornecer contexto adicional na notificação de alertas adicionando resultados de consulta NRQL a eles

   • A ferramenta de enriquecimento de fluxo de trabalho é semelhante ao criador de consulta.

   • Os resultados da consulta NRQL são incluídos na mensagem de notificação.

   • Se você criar consultas para o seu fluxo de trabalho, elas rodam em tempo real e os resultados da consulta são o valor do enriquecedor.

   • Você pode salvar qualquer consulta válida em seu fluxo de trabalho, mesmo que ela retorne um resultado vazio, mas você deve executar a consulta antes de salvar o enriquecimento. Você também pode consultar variáveis específicas do problema; por exemplo {{entitiesData.ids}}

   • Para obter exemplos de enriquecimento, consulte Exemplos de enriquecimento de dados de fluxo de trabalho.

   • Nota: O nome da consulta precisa ser exclusivo porque você usará o nome para decidir como incluir o resultado na carga da notificação que será enviada pelo fluxo de trabalho.

     Importante

     Nesta fase, as representações visuais dos enriquecimentos são enviadas para o Slack e por email. Para destinos ServiceNow e JIRA, recomendamos limitar a consulta NRDB com resultados de valor único. Por exemplo: contagem, mínimo ou máximo.

     O número máximo de enriquecimentos por fluxo de trabalho é 2.

7. Notificar: Escolha um ou mais destinos e adicione uma mensagem opcional.

   Dica

   Em qualquer canal de destino, comece a digitar e um menu variável será aberto. Você verá os nomes das variáveis, que serão substituídos pelos valores da variável em tempo de execução. Para usar os resultados dos enriquecedores, use o nome deles.

   Notificador

   • Para salvar e ativar um fluxo de trabalho, é necessário incluir um notificador.

   • A configuração de um notificador requer a configuração de um destino de notificação.

   • Você pode configurá-lo por meio do item de menu

     Destination

     ou por meio de

     Create new destination item

     no menu suspenso de seleção de destino em cada tela de canal de destino.

   • Um destino de notificação inclui as credenciais necessárias para enviar uma notificação a uma plataforma de terceiros e uma opção para personalizar a mensagem enviada pelos campos de mapeamento de nossos problemas para os campos da plataforma de destino.

   • Para saber como configurar destinos e configurar modelos de mensagens, consulte a documentação sobre notificação.

   • (Opcional) Você pode marcar qual notificação deseja receber para cada notificador. Caso contrário, a notificação será enviada a cada notificador por padrão.

8. Clique em update message depois de concluir os requisitos do notificador.

9. Opcional: teste seu fluxo de trabalho. Usaremos os dados existentes da sua conta para enviar um exemplo de notificação com sua nova configuração. O teste só funciona se existirem problemas que correspondam ao filtro. Se não houver dados, você verá esta mensagem: We don't see any issues matching your filter. That doesn't mean it won't work.

10. Clique em Update workflow para concluir o fluxo de trabalho.

Log de notificação de problemas

O log de notificação de problemas fornece ao usuário um registro detalhado para acompanhar todas as notificações geradas pelo fluxo de trabalho. Essas informações solucionam problemas, monitoram o desempenho do fluxo de trabalho e garantem que as notificações sejam enviadas aos destinos corretos. Como resultado, o usuário pode identificar rapidamente quaisquer problemas que possam surgir e tomar medidas corretivas conforme necessário.

Para acessar o log de notificação de problemas, vá para one.newrelic.com > Alerts > Workflows e clique em Issue notification log.

Navegando no log de notificação de problemas

O log de notificação de problemas exibe as seguintes colunas:

1. Time:

   Esta coluna exibe a hora em que a notificação do fluxo de trabalho foi enviada.

2. Status:

   Esta coluna exibe o status da notificação.

   • Enviado: A notificação foi enviada com sucesso pela New Relic.
   • Falha: a notificação não foi enviada com sucesso do New Relic.
   • Devolvido: O servidor de e-mail de recebimento não pode ou não entregará o e-mail. Isso geralmente acontece porque o endereço de e-mail é inválido ou a caixa de entrada do e-mail está cheia. Endereços de e-mail devolvidos serão descartados em correspondências futuras.
   • Dropped: O cliente de e-mail não tentou enviar o e-mail porque o endereço de e-mail já foi devolvido, porque o endereço cancelou a inscrição em nossos e-mails ou porque o endereço marcou nossos e-mails como spam.
   • Adiado: o e-mail não foi enviado na primeira tentativa devido a problemas temporários como conectividade. Haverá outra tentativa, portanto, uma notificação adiada poderá ser bem-sucedida ou devolvida posteriormente.

3. Destination:

   Esta coluna exibe o tipo de destino que recebe a notificação de fluxo de trabalho (por exemplo, Slack ou email).

4. Operation:

   O tipo de notificação que foi enviada (por exemplo, Notificar, Fechar, Comentário, Confirmação, Teste).

5. Issue Name:

   Esta coluna exibe o nome do problema que acionou a notificação do fluxo de trabalho.

6. Trigger Event:

   Esta coluna exibe o evento de problema que acionou a notificação do fluxo de trabalho. Clicar no evento fornecerá mais informações sobre como os fluxos de trabalho são acionados.

7. Workflow:

   Esta coluna exibe o fluxo de trabalho que acionou a notificação.

8. Error Details:

   Esta coluna exibe detalhes adicionais se a notificação falhar.

9. Notification Result:

   Esta coluna exibe um link para evidências de terceiros (por exemplo, um thread do Slack ou um ticket do JIRA) se a notificação foi enviada com sucesso.

10. Payload:

    Está disponível para notificações enviadas para destinos de webhook e exibe a carga JSON da notificação enviada.

Notificação NrAi

Você pode consultar todas as informações da notificação do problema através do evento NrAiNotification .

Utilize esta consulta para ver todas as notificações enviadas do fluxo de trabalho facetadas por tipos de destino:

FROM NrAiNotification
SELECT count(*)
FACET destinationType

Ver detalhes adicionais

O usuário pode visualizar detalhes adicionais clicando em qualquer linha do log de notificação de problemas. Isso exibirá os detalhes do erro (se aplicável) e um link para a notificação no terceiro.