Como usuário New Relic, você pode executar a mesma consulta NRQL repetidamente para monitorar padrões críticos, verificar condições específicas ou gerar relatórios periódicos. Por exemplo, você precisa verificar diariamente se há transações com falha, monitorar semanalmente a taxa de erros ou acompanhar as métricas de desempenho por hora em todo o seu aplicativo. Esse processo manual consome muito tempo e facilita a perda insights importantes quando você não está monitorando ativamente.
As pesquisas NRQL agendadas resolvem esse problema automatizando suas consultas repetitivas. Você pode agendar consultas para serem executadas automaticamente e receber os resultados por e-mail, mantendo-se informado sobre padrões críticos sem a necessidade de monitoramento manual constante.
O que você pode fazer
As pesquisas NRQL agendadas permitem que você:
- Automatize consultas repetitivas: converta consultas manuais em fluxos de trabalho automatizados que são executados de acordo com sua programação.
- Comece de qualquer lugar: crie uma pesquisa agendada a partir de Administração ou diretamente da interface de Logs.
- Mantenha-se informado proativamente: Receba notificações por e-mail com os resultados da consulta diretamente na sua caixa de entrada.
- Defina condições de notificação: escolha receber notificações a cada execução ou apenas quando seus resultados atenderem a uma condição que você definir com base no número de resultados na sua consulta.
- Agende com flexibilidade: use agendamentos personalizados de expressões cron para definir quando as consultas são executadas.
- Escolha o formato de saída: exporte os resultados como arquivos CSV ou JSON anexados a notificações por e-mail.
- Colabore com sua equipe: envie resultados de pesquisas agendadas para vários destinatários de e-mail.
- Gerencie tudo centralmente: visualize, edite e gerencie todas as suas pesquisas agendadas de um único local na interface de Administração, independentemente de onde você as criou.
Preços
As pesquisas NRQL agendadas não têm precificação separada. Você paga apenas o custo padrão de consulta para executar a consulta NRQL subjacente, com base no modelo de precificação da sua conta.
Pré-requisitos
Para usar pesquisas NRQL agendadas, você precisa de:
- Acesso à conta: Acesso à conta onde você deseja agendar pesquisas.
- Acesso aos dados: Permissões adequadas para consultar os dados que você deseja agendar. Por exemplo, se você for agendar uma consulta em dados de log, precisará ter acesso a esses dados de log.
Permissões
Por padrão, as funções padrão All product admin e Standard user já incluem acesso de Read e Modify a pesquisas agendadas, e apenas All product admin inclui acesso de Delete. Essas funções também já incluem duas capacidades das quais as pesquisas agendadas dependem:
- User API Keys (for self) > Modify (
account.create.own_api_keys): o New Relic precisa disso para executar a pesquisa com sucesso. - Workflow Schedules > Read (
workflow_automation.read.schedules): necessário para visualizar a lista de pesquisas agendadas.
Se desejar criar uma função personalizada e atribuir recursos específicos de Scheduled Search a ela, use um dos seguintes métodos:
- NerdGraph: crie uma função personalizada com escopo de conta via NerdGraph e adicione os IDs de permissão da tabela a seguir à matriz
permissionIds. - Interface: crie uma nova função personalizada, ou edite uma existente, para adicionar a capacidade Scheduled Search da seção Scheduled Search and Reports.
Importante
Algumas capacidades concedem acesso mais amplo do que outras. Por exemplo, Delete também concede acesso de leitura e modificação. Se desejar conceder apenas uma capacidade mais restrita, selecione essa capacidade específica em vez de Delete.
A tabela a seguir lista cada capacidade, seus IDs de permissão e o que ela concede:
Capacidade | ID da permissão | Descrição |
|---|---|---|
Scheduled Search > Read |
| Visualizar pesquisas agendadas |
Scheduled Search > Modify |
| Visualize, crie e edite pesquisas agendadas |
Scheduled Search > Delete |
| Visualizar, criar, editar e excluir pesquisas programadas |
User API Keys (for self) > Modify |
| Necessário para executar uma pesquisa agendada. O New Relic usa isso para criar uma chave de API de usuário em seu nome, para manter seu contexto de usuário. Sem isso, a execução falha. |
Workflow Schedules > Read |
| Necessário para visualizar a lista de pesquisas agendadas. |
Agendar uma nova pesquisa
O New Relic orienta você por esse fluxo diretamente no produto. Cada etapa abaixo aborda o que precisa acontecer lá e qualquer detalhe que não seja óbvio na tela.
Acesse o fluxo de criação de pesquisa programada:
Escolha o ponto de entrada que se adequa ao seu fluxo de trabalho. Ambos levam ao mesmo fluxo de configuração.
Vá para one.newrelic.com > Administration > Scheduled Searches e clique em Schedule a search.
Na interface de Logs, use uma destas opções:
No canto superior direito, clique no menu e selecione Schedule a search.
Abaixo do gráfico de tendência de consulta, clique no ícone de relógio.
Se você já criou e executou uma consulta, ela é transferida para o fluxo de configuração. Caso contrário, você pode elaborar sua consulta na próxima etapa.
Dica
Você pode criar uma pesquisa agendada em Administração ou na interface de Logs, mas só pode visualizar, editar ou excluir pesquisas agendadas existentes em Administration > Scheduled Searches.
Configure sua consulta:
Elabore e teste sua consulta NRQL e, em seguida, continue.
Configurar notificação:
Configure o seguinte:
Nomeie a pesquisa e, em seguida, defina um destino para os resultados. Os resultados só podem ser enviados para destinos de e-mail.
- Se o destino existir, selecione-o na lista.
- Se não existir, adicione um ou mais destinatários de e-mail e nomeie o destino.
Escolha um assunto, uma mensagem e um formato de saída para o e-mail.
Defina a condição de notificação em Send notification. O padrão é Always. Para enviar apenas quando seus resultados atingirem uma contagem que você definir, personalize aqui.
Cuidado
Os resultados das pesquisas agendadas são anexados ao e-mail como arquivos CSV ou JSON e podem conter dados sensíveis. Revise os destinos de e-mail para confirmar que apenas os destinatários pretendidos estão incluídos.
Defina um cronograma:
Escolha o seguinte:
Escolha uma frequência: horária, diária, semanal ou uma expressão cron personalizada.
Selecione um fuso horário para a programação.
Se você usar uma expressão cron, a seguir estão alguns padrões comuns para referência:
0 * * * *- A cada hora, sempre no início de cada hora.0 9 * * *- Todos os dias às 9h da manhã0 9 * * 1- Todas as segundas-feiras às 9h da manhã0 0 1 * *- Primeiro dia de cada mês à meia-noite*/15 * * * *- A cada 15 minutos0 9 * * 1-5- Todos os dias da semana às 9h00Dica
O menor intervalo suportado é a cada 10 minutos.
Se você definir uma condição de notificação em vez de enviar a cada execução, o New Relic verifica a condição no tempo de execução programado exato. Ele não rastreia flutuações entre execuções, portanto, se os seus resultados caírem abaixo do limite da condição antes da próxima execução, você não receberá uma notificação para essa execução.
Revise, confirme e agende a pesquisa:
Revise sua configuração e, em seguida, agende a pesquisa. Isso aparece na página Scheduled searches.
Gerenciar pesquisas agendadas
A página Scheduled searches na interface de Administração lista todas as suas pesquisas automatizadas, incluindo as que você criou a partir da interface de Logs. No menu , você pode visualizar, editar ou excluir uma pesquisa com base em suas permissões.
Tópicos relacionados
Para informações relacionadas, consulte:
- Saiba mais sobre NRQL Consulta para criar pesquisas automatizadas mais sofisticadas.
- Configure os destinos de e-mail de alerta para ampliar suas opções de notificação.
- Explore a automação de fluxos de trabalho para possibilidades de automação mais avançadas.