Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Qual é o meu plano?
Suite, todas as versões Team, Growth, Professional, Enterprise ou Enterprise Plus
Support Team, Professional ou Enterprise

Resumo: ◀▼

É possível conectar fluxos de ação ao New Relic usando uma chave da API para automatizar fluxos de trabalho que envolvem consultas de dados, buscas por entidades, pesquisas de entidades e criação de condições de alerta. Use uma conta de serviço dedicada para uma integração segura. Essa conexão permite executar consultas NRQL, recuperar detalhes de entidades, pesquisar entidades por critérios e criar condições de alerta para monitorar e gerenciar seus sistemas diretamente em seus fluxos de trabalho.

Ao conectar o criador de ações a sistemas externos, como o New Relic, administradores podem integrar o Zendesk a sistemas externos em fluxos de trabalho automatizados, melhorando a colaboração e mantendo uma experiência contínua em várias plataformas.
Observação: as etapas associadas aos sistemas externos em fluxos de ação são chamadas coletivamente de ações externas.
Este artigo contém os seguintes tópicos:
  • Conexão do New Relic ao criador de ações
  • Uso de ações do New Relic em fluxos de ação

Conexão do New Relic ao criador de ações

Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Ao se conectar a sistemas externos para uso em fluxos de ação, as seguintes práticas recomendadas devem ser observadas:
  • Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
  • Todas as integrações solicitam acesso aos escopos necessários. No entanto, é importante que você avalie e valide os escopos antes de autorizar a conexão com o sistema externo.
  • Ao gerenciar credenciais para ferramentas baseadas em chave de API, como a OpenAI, recomendamos armazenar as chaves em um cofre seguro ou em um gerenciador de credenciais.

Como criar uma chave da API de usuário no New Relic

A conexão com o New Relic usa autenticação por chave da API. É preciso fornecer uma chave da API de usuário da sua conta New Relic. Essa chave é usada para consultar dados e gerenciar configurações. A chave da API deve ter permissões apropriadas para acessar as APIs do New Relic para as ações que você planeja usar.

Consulte a documentação do New Relic para obter mais informações sobre as chaves da API do New Relic.

Importante: mantenha sua chave da API segura. Não compartilhe nem inclua a chave no controle de versão. Use uma chave da API de conta de serviço dedicada para fluxos de trabalho de produção.
  1. Acesse o menu do usuário do New Relic.
  2. Selecione API Keys.
  3. Crie uma nova chave da API.
  4. Salve a chave da API ou mantenha a janela aberta para poder copiá-la e colá-la no Zendesk.

    Você vai precisar dela ao conectar o New Relic ao criador de ações.

Como conectar o criador de ações ao New Relic
  1. Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação.
  2. Crie ou edite um fluxo de ação.
  3. Abra a barra lateral da etapa.
  4. Em Ações externas, clique em New Relic.
  5. Clique em Conectar.
  6. Siga as instruções do New Relic para inserir a chave da API do New Relic e concluir a conexão.
    Importante: Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.

Depois de se conectar ao sistema, você verá um indicador de conexão e detalhes sobre a instância à qual está conectado, bem como as ações disponíveis para o New Relic.

Uso de ações do New Relic em fluxos de ação

As seguintes ações do New Relic estão disponíveis:
  • Consultar dados
  • Pesquisar entidade
  • Pesquisar entidades
  • Criar condição de alerta

Consultar dados

Use a ação Consultar dados para executar consultas NRQL em seus dados de telemetria do New Relic.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Account ID, NRQL query

O campo de ID da conta fornece uma lista suspensa de contas que podem ser acessadas com sua chave da API.

A consulta NRQL usa uma sintaxe semelhante à do SQL. Exemplo: SELECT count(*) FROM Transaction WHERE appName='WebApp' SINCE 1 hour ago.

Opcional: Timeout

O campo Tempo limite aceita valores de 1 a 120 segundos e o valor padrão é 10 segundos.

Saída Resultados da consulta, incluindo uma matriz de objetos de resultado com campos determinados pela cláusula SELECT do NRQL, contagem de linhas e o valor total do resultado para consultas de agregação.

Pesquisar entidade

Use a ação Pesquisar entidade para recuperar informações detalhadas sobre uma entidade monitorada específica.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Account ID, Entity

O campo Entidade é uma lista suspensa pesquisável. Digite pelo menos 2 caracteres do nome da entidade para pesquisar. Os resultados da pesquisa mostram o nome e o tipo da entidade, com um link para a entidade no New Relic. Selecione a entidade que deseja consultar para obter todos os detalhes, incluindo o status de alerta atual e as tags associadas.
Saída Detalhes da entidade, incluindo GUID, nome, tipo, URL, status do relatório, gravidade do alerta e tags com metadados.

Pesquisar entidades

Use a ação Pesquisar entidades para encontrar entidades monitoradas que correspondam aos critérios de pesquisa.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatória: Account ID

Opcionais: Search query, Entity type, Alert severity, Tag filter, Max results

Ao usar a ação Pesquisar entidades, considere o seguinte:

  • Todos os filtros de pesquisa são opcionais e podem ser combinados.
  • O campo de consulta de pesquisa usa a sintaxe de pesquisa de entidade do New Relic (por exemplo, name LIKE 'Web%').
  • O tipo de entidade fornece uma lista suspensa com os tipos de entidade disponíveis. As opções de gravidade do alerta incluem NOT_ALERTING, WARNING e CRITICAL.
  • O filtro de tags usa o formato chave:valor (por exemplo, ambiente:produção).
  • O resultado máximo aceita valores de 1 a 200, sendo o valor padrão 50.
Saída Matriz de objetos de entidade contendo o GUID da entidade, nome, tipo, URL, domínio, status de relatório, gravidade do alerta e tags, juntamente com a contagem total e um indicador caso haja mais resultados disponíveis.

Criar condição de alerta

Use a ação Criar condição de alerta para criar uma nova condição de alerta NRQL no New Relic.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Account ID, Alert policy, Condition name, NRQL query, Critical threshold

Opcionais: Warning threshold, Threshold duration, Threshold operator, Enabled

Ao usar a ação Criar condição de alerta, considere o seguinte:
  • O campo Política de alerta é uma lista suspensa pesquisável que exibe as políticas da conta selecionada.
  • A consulta NRQL deve retornar um único valor numérico para comparação de limite (por exemplo, SELECT count(*) FROM ZendeskTicketCreated SINCE 1 hour ago).
  • O limite crítico é o valor numérico que aciona um alerta crítico.
  • O limite de aviso é opcional e aciona um alerta de nível de advertência.
  • A duração do limite especifica por quanto tempo o limite deve ser excedido antes de um alerta ser emitido, em segundos (intervalo: de 60 a 3.600, padrão de 300).
  • As opções do operador de limite são ACIMA, ABAIXO ou IGUAL (o padrão é ACIMA).
  • Ativado determina se a condição entra em vigor imediatamente (o padrão é verdadeiro).
Saída Detalhes da condição de alerta, incluindo ID da condição, nome da condição, ID da política e status de ativação.
Powered by Zendesk