Como usuario New Relic, puede ejecutar la misma consulta NRQL una y otra vez para monitorear patrones críticos, verificar condiciones específicas o generar reportes periódicos. Por ejemplo, puede que necesite comprobar diariamente si hay transacciones fallidas, controlar semanalmente la tasa de errores o realizar un seguimiento de las métricas de rendimiento por hora en toda su aplicación. Este proceso manual consume mucho tiempo y facilita que se pase por alto información importante cuando no se está realizando un monitoreo activo.
Las búsquedas NRQL programadas solucionan este problema automatizando las consultas repetitivas. Puedes programar las consultas para que se ejecuten automáticamente y recibir los resultados por email, de modo que te mantengas informado sobre patrones críticos sin necesidad de un seguimiento manual constante.
Lo que puedes hacer
Las búsquedas NRQL programadas te permiten:
- Automatice las consultas repetitivas: convierta las consultas manuales en un flujo de trabajo automatizado que se ejecute según su cronograma.
- Comience desde cualquier lugar: cree una búsqueda programada desde Administración o directamente desde la UI de Logs.
- Mantener informado de forma proactiva: Reciba notificaciones por email con los resultados de la consulta directamente en su bandeja de entrada.
- Establezca las condiciones de notificación: elija recibir notificaciones en cada ejecución, o solo cuando los resultados cumplan una condición que defina en función del número de resultados de la consulta.
- Programe de forma flexible: use programaciones de expresiones cron personalizadas para definir cuándo se ejecutan las consultas.
- Elija el formato de salida: exporte los resultados como archivos CSV o JSON adjuntos a las notificaciones por correo electrónico.
- Colabore con su equipo: envíe los resultados de la búsqueda programada a varios destinatarios de correo electrónico.
- Gestione todo de forma centralizada: vea, edite y administre todas las búsquedas programadas desde una única ubicación en la UI de administración, independientemente de dónde las haya creado.
Precios
Las búsquedas programadas de NRQL no tienen un precio independiente. Solo paga el costo de consulta estándar por ejecutar la consulta de NRQL subyacente, según el modelo de precios de la cuenta.
Requisitos previos
Para emplear búsquedas NRQL programadas, necesita:
- Acceso a la cuenta: Acceso a la cuenta donde desea programar búsquedas.
- Acceso a los datos: Licencias adecuadas para consultar los datos que desea programar. Por ejemplo, si se programa una consulta sobre datos de log, se necesita acceso a esos datos de log.
Permisos
By default, the All product admin and Standard user standard roles already include Read and Modify access to scheduled searches, and only All product admin includes Delete access. These roles also already include two capabilities that scheduled searches depend on:
- User API Keys (for self) > Modify (
account.create.own_api_keys): New Relic needs this to run the search successfully. - Workflow Schedules > Read (
workflow_automation.read.schedules): Required to view the list of scheduled searches.
Si desea crear un rol personalizado y asignarle capacidades específicas de Scheduled Search, utilice cualquiera de los siguientes métodos:
- NerdGraph: cree un rol personalizado con alcance de cuenta a través de NerdGraph y agregue los ID de permiso de la siguiente tabla a la matriz
permissionIds. - UI: cree un nuevo rol personalizado o edite uno existente para agregar la capacidad Scheduled Search de la sección Scheduled Search and Reports.
Importante
Algunas capacidades otorgan un acceso más amplio que otras. Por ejemplo, Delete también otorga acceso de lectura y modificación. Si solo desea otorgar una capacidad más restringida, seleccione esa capacidad específica en lugar de Delete.
La siguiente tabla enumera cada capacidad, sus ID de permiso y lo que otorga:
Capacidad | ID de permiso | Descripción |
|---|---|---|
Scheduled Search > Read |
| Ver búsquedas programadas |
Scheduled Search > Modify |
| Ver, crear y editar búsquedas programadas |
Scheduled Search > Delete |
| Ver, crear, editar y eliminar búsquedas programadas |
User API Keys (for self) > Modify |
| Requerido para ejecutar una búsqueda programada. New Relic lo utiliza para crear una clave de API de usuario en su nombre, para mantener el contexto de usuario. Sin esto, la ejecución falla. |
Workflow Schedules > Read |
| Required to view the list of scheduled searches. |
Programa una nueva búsqueda
New Relic lo guía a través de este flujo directamente en el producto. Cada paso a continuación cubre lo que debe suceder allí y cualquier cosa que no sea obvia en la pantalla.
Acceda al flujo de creación de búsquedas programadas:
Elija el punto de entrada que se adapte a su flujo de trabajo. Ambos conducen al mismo flujo de configuración.
Vaya a one.newrelic.com > Administration > Scheduled Searches y haga clic en Schedule a search.
Desde la UI de Logs, utilice cualquiera de estas opciones:
En la esquina superior derecha, haga clic en el menú y seleccione Schedule a search.
Debajo del gráfico de tendencias de la consulta, haga clic en el ícono del reloj.
Si ya redactó y ejecutó una consulta, esta se transfiere al flujo de configuración. De lo contrario, puede redactar la consulta en el siguiente paso.
Sugerencia
Puede crear una búsqueda programada desde Administración o la UI de Logs, pero solo puede ver, editar o eliminar las búsquedas programadas existentes desde Administration > Scheduled Searches.
Configura tu consulta:
Redacte y pruebe la consulta NRQL, luego continúe.
Configurar notificación:
Configure lo siguiente:
Asigne un nombre a la búsqueda, luego establezca un destino para los resultados. Solo puede enviar los resultados a destinos de correo electrónico.
- Si el destino existe, selecciónelo de la lista.
- Si no existe, agregue uno o más destinatarios de correo electrónico y asigne un nombre al destino.
Elija un asunto, un mensaje y un formato de salida para el correo electrónico.
Establezca la condición de notificación en Send notification. Por defecto es Always. Para enviar solo cuando los resultados cumplan con un recuento que defina, personalícelo aquí.
Advertencia
Los resultados de la búsqueda programada se adjuntan al correo electrónico como archivos CSV o JSON y pueden contener datos confidenciales. Revise los destinos de correo electrónico para confirmar que solo se incluyan los destinatarios previstos.
Establece un horario:
Elija lo siguiente:
Elija una frecuencia: por hora, diaria, semanal o una expresión cron personalizada.
Seleccione una zona horaria para la programación.
Si usa una expresión cron, los siguientes son algunos patrones comunes de referencia:
0 * * * *- Cada hora en punto0 9 * * *- Todos los días a las 9:00 AM0 9 * * 1- Todos los lunes a las 9:00 AM0 0 1 * *- El primer día de cada mes a medianoche*/15 * * * *- Cada 15 minutos0 9 * * 1-5- Todos los días laborables a las 9:00 AMSugerencia
El intervalo admitido más corto es cada 10 minutos.
Si establece una condición de notificación en lugar de enviar una en cada ejecución, New Relic comprueba la condición en el tiempo de ejecución programado exacto. No hace un seguimiento de las fluctuaciones entre ejecuciones, por lo que si sus resultados caen por debajo del umbral de la condición antes de la siguiente ejecución, no recibirá una notificación para esa ejecución.
Revise, confirme y programe la búsqueda:
Revise su configuración, luego programe la búsqueda. Aparece en la página Scheduled searches.
Gestionar búsquedas programadas
La página Scheduled searches en la UI de administración enumera todas las búsquedas automatizadas, incluidas las que haya creado desde la UI de Logs. Desde el menú , puede ver, editar o eliminar una búsqueda en función de los permisos.
Temas relacionados
Para obtener información relacionada, consulte:
- Obtenga más información sobre NRQL Consulta para crear búsquedas automatizadas más sofisticadas.
- Configure los destinos de email de alerta para ampliar sus opciones de notificación.
- Explore la automatización de flujos de trabajo para posibilidades de automatización más avanzadas.