Uso de acciones de New Relic en los flujos de acciones

Suite, todas las versiones

Team, Growth, Professional, Enterprise o Enterprise Plus

Support

Team, Professional o Enterprise

Resumen: ◀▼

Los flujos de acciones se pueden conectar con New Relic a través de una clave de API para automatizar los flujos de trabajo que tienen que ver con consultas de datos, búsquedas de entidades (entity lookups y entity searches) y creación de condiciones de alerta. Utilice una cuenta de servicio exclusiva para garantizar la seguridad de la integración. Esta conexión permite realizar consultas NRQL, recuperar detalles de las entidades, buscar las entidades por criterios y crear condiciones de alerta para monitorear y administrar sus sistemas directamente dentro de sus flujos de trabajo.

Si el generador de acciones se conecta con sistemas externos, como New Relic, los administradores pueden integrar Zendesk con sistemas externos en los flujos de trabajo automatizados, lo que mejora la colaboración y mantiene una experiencia fluida en las distintas plataformas.

Nota: Los pasos asociados a los sistemas externos en los flujos de acciones se denominan colectivamente acciones externas.

Los temas tratados en el artículo son estos:

Conectar New Relic con el generador de acciones
Usar las acciones de New Relic en los flujos de acciones

Conectar New Relic con el generador de acciones

Para poder incluir acciones externas en los flujos de acciones, primero se debe conectar el generador de acciones con el sistema externo.

Las siguientes prácticas son las más recomendadas a la hora de conectarse a sistemas externos para usarlos en flujos de acciones:

Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, conviene usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.
Todas las integraciones solicitan acceso a los ámbitos necesarios. Sin embargo, es importante que revise y valide los ámbitos antes de autorizar la conexión al sistema externo.
Cuando necesite administrar credenciales para herramientas que funcionan con claves de API (como OpenAI), lo mejor es guardar las claves en una bóveda o con un administrador de credenciales.

Para crear una clave de API de usuario en New Relic

La conexión de New Relic utiliza la autenticación con clave de API. Tendrá que proporcionar una clave de API de usuario de su cuenta de New Relic. Esta clave se usa para consultar datos y administrar configuraciones. La clave de API debe contar con los permisos apropiados para acceder a las API de New Relic para las acciones que tiene pensado utilizar.

Consulte la documentación de New Relic si desea más información sobre las claves de API de New Relic.

Importante: Mantenga segura su clave de API. No la comparta ni la someta (commit) al control de versiones. Use una clave de API de cuenta de servicio exclusiva para los flujos de trabajo de producción.

Vaya al menú de usuario de New Relic.
Seleccione API Keys.
Cree una nueva clave de API.
Guarde la clave de API o mantenga abierta la ventana para poder copiarla y pegarla en Zendesk.
La necesitará al conectar New Relic con el generador de acciones.

Para conectar el generador de acciones con New Relic

En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones > Flujos de acciones.
Cree o edite un flujo de acciones.
Abra la barra lateral de pasos.
En Acciones externas, haga clic en New Relic.
Haga clic en Conectar.
Siga las indicaciones de New Relic para ingresar su clave de API de New Relic y completar la conexión.
Importante: Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, conviene usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.

Después de conectarse al sistema, verá un indicador de conexión y detalles sobre la instancia a la que está conectado, así como las acciones disponibles para New Relic.

Uso de acciones de New Relic en los flujos de acciones

Están disponibles las siguientes acciones de New Relic:

Consultar datos
Buscar entidad
Buscar entidades
Crear condición de alerta

Consultar datos

Utilice la acción Consultar datos para realizar consultas NRQL en sus datos de telemetría de New Relic.

Esta acción tiene las siguientes entradas y salidas:

Variables

Entrada

	Variables
Entrada	Requerido: `Account ID`, `NRQL query` El campo ID de cuenta proporciona un menú desplegable de cuentas que es accesible con su clave de API. La consulta NRQL utiliza una sintaxis similar a SQL. Ejemplo: `SELECT count(*) FROM Transaction WHERE appName='WebApp' SINCE 1 hour ago`. Opcional: `Timeout` El campo Tiempo de espera acepta valores entre 1 y 120 segundos y su valor predeterminado es de 10 segundos.
Salida	Los resultados de la consulta que incluyen una matriz de objetos de resultados con campos que son determinados por la cláusula SELECT de NRQL, el recuento de las filas y el valor total de los resultados para las consultas de agregación.

Requerido: Account ID,

NRQL
                                            query

El campo ID de cuenta proporciona un menú desplegable de cuentas que es accesible con su clave de API.

La consulta NRQL utiliza una sintaxis similar a SQL. Ejemplo: SELECT count(*) FROM Transaction WHERE appName='WebApp' SINCE 1 hour ago.

Opcional: Timeout

El campo Tiempo de espera acepta valores entre 1 y 120 segundos y su valor predeterminado es de 10 segundos.

Salida Los resultados de la consulta que incluyen una matriz de objetos de resultados con campos que son determinados por la cláusula SELECT de NRQL, el recuento de las filas y el valor total de los resultados para las consultas de agregación.

Buscar una entidad

Utilice la acción Buscar entidad para obtener información detallada sobre una entidad monitoreada específica.

Esta acción tiene las siguientes entradas y salidas:

Variables

Entrada

	Variables
Entrada	Requerido: `Account ID`, `Entity` El campo Entidad es un menú desplegable que admite búsquedas. Escriba al menos 2 caracteres del nombre de la entidad para buscar. Los resultados de la búsqueda muestran el nombre y el tipo de la entidad, con un vínculo a la entidad en New Relic. Seleccione la entidad que desea buscar para obtener sus detalles completos incluidos el estado de alerta actual y sus etiquetas asociadas.
Salida	Los detalles de la entidad como GUID de la entidad, nombre, tipo, URL, estado del informe, severidad de la alerta y etiquetas con metadatos.

Requerido: Account ID, Entity

El campo Entidad es un menú desplegable que admite búsquedas. Escriba al menos 2 caracteres del nombre de la entidad para buscar. Los resultados de la búsqueda muestran el nombre y el tipo de la entidad, con un vínculo a la entidad en New Relic. Seleccione la entidad que desea buscar para obtener sus detalles completos incluidos el estado de alerta actual y sus etiquetas asociadas.

Salida Los detalles de la entidad como GUID de la entidad, nombre, tipo, URL, estado del informe, severidad de la alerta y etiquetas con metadatos.

Buscar entidades

Utilice la acción Buscar entidades para ubicar las entidades monitoreadas que satisfagan los criterios de búsqueda.

Esta acción tiene las siguientes entradas y salidas:

Variables

Entrada

	Variables
Entrada	Requerido: `Account ID` Opcional: `Search query`, `Entity type`, `Alert severity`, `Tag filter`, `Max results` Considere lo siguiente al usar la acción Buscar entidades: Todos los filtros de búsqueda son opcionales y se pueden combinar. El campo Consulta de búsqueda utiliza la sintaxis de búsqueda de entidades (entity search) de New Relic (por ejemplo, `name LIKE 'Web%'`). Tipo de entidad proporciona un menú desplegable con los tipos de entidades disponibles. Las opciones de severidad de la alerta son NOT_ALERTING, WARNING y CRITICAL. El filtro de la etiqueta sigue el formato clave:valor (por ejemplo, entorno:producción). Los resultados máximos aceptan valores entre 1 y 200 con un valor predeterminado de 50.
Salida	Una matriz de objetos de entidad que contienen el GUID de la entidad, el nombre, tipo, URL, dominio, estado del informe, severidad de la alerta y etiquetas, junto con el recuento total y un indicador si hay más resultados disponibles.

Requerido: Account ID

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

Considere lo siguiente al usar la acción Buscar entidades:

Todos los filtros de búsqueda son opcionales y se pueden combinar.
El campo Consulta de búsqueda utiliza la sintaxis de búsqueda de entidades (entity search) de New Relic (por ejemplo, name LIKE 'Web%').
Tipo de entidad proporciona un menú desplegable con los tipos de entidades disponibles. Las opciones de severidad de la alerta son NOT_ALERTING, WARNING y CRITICAL.
El filtro de la etiqueta sigue el formato clave:valor (por ejemplo, entorno:producción).
Los resultados máximos aceptan valores entre 1 y 200 con un valor predeterminado de 50.

Salida Una matriz de objetos de entidad que contienen el GUID de la entidad, el nombre, tipo, URL, dominio, estado del informe, severidad de la alerta y etiquetas, junto con el recuento total y un indicador si hay más resultados disponibles.

Crear una condición de alerta

Utilice la acción Crear condición de alerta para crear una nueva condición de alerta NRQL en New Relic.

Esta acción tiene las siguientes entradas y salidas:

Variables

Entrada

	Variables
Entrada	Requerido: `Account ID`, `Alert policy`, `Condition name`, `NRQL query`, `Critical threshold` Opcional: `Warning threshold`, `Threshold duration`, `Threshold operator`, `Enabled` Considere lo siguiente al usar la acción Crear condición de alerta: El campo de política de alerta es un menú que admite búsquedas y que presenta las políticas de la cuenta seleccionada. La consulta NRQL debe devolver un solo valor numérico para la comparación de umbrales (por ejemplo, `SELECT count(*) FROM ZendeskTicketCreated SINCE 1 hour ago`). Umbral crítico es el valor numérico que gatilla una alerta crítica. Umbral de advertencia es opcional y gatilla una alerta a nivel de advertencia. Duración del umbral especifica por cuánto tiempo deberá excederse el umbral antes de alertar, en segundos (intervalo: 60-3600, el valor predeterminado es 300). Las opciones para operadores de umbrales son ABOVE, BELOW o EQUALS (el valor predeterminado es ABOVE). Activado determina si la condición se activa de inmediato (el valor predeterminado es verdadero).
Salida	Los detalles de la condición de alerta incluyen la ID de condición, el nombre de la condición, la ID de la política y el estado activado.

Requerido: Account ID,

Alert
                                            policy

, Condition name, NRQL query,

Critical
                                            threshold

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

Considere lo siguiente al usar la acción Crear condición de alerta:

El campo de política de alerta es un menú que admite búsquedas y que presenta las políticas de la cuenta seleccionada.
La consulta NRQL debe devolver un solo valor numérico para la comparación de umbrales (por ejemplo, SELECT count(*) FROM ZendeskTicketCreated SINCE 1 hour ago).
Umbral crítico es el valor numérico que gatilla una alerta crítica.
Umbral de advertencia es opcional y gatilla una alerta a nivel de advertencia.
Duración del umbral especifica por cuánto tiempo deberá excederse el umbral antes de alertar, en segundos (intervalo: 60-3600, el valor predeterminado es 300).
Las opciones para operadores de umbrales son ABOVE, BELOW o EQUALS (el valor predeterminado es ABOVE).
Activado determina si la condición se activa de inmediato (el valor predeterminado es verdadero).

Salida Los detalles de la condición de alerta incluyen la ID de condición, el nombre de la condición, la ID de la política y el estado activado.