Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conectarse a una fuente ServiceNow de datos

Esta es la fuente ServiceNow de datos que se utiliza para conectarse a ServiceNow las instancias.

Características

Configuración

Seleccione los orígenes de datos en el panel izquierdo de Grafana.

Seleccione Agregar origen de datos:

Ingrese servicenow para buscar el complemento de origen de datos:

Ingresa ServiceNow la URL:

Elija Guardar y probar. Deberías ver un mensaje verde con el texto «ServiceNow Conexión correcta».

Ejemplos de paneles

Los paneles prediseñados se incluyen con el complemento y se pueden importar a través de la página de configuración del origen de datos, en la pestaña Paneles.

Uso

Hay dos formas de devolver datos en el editor de consultas.

Actualmente, los usuarios pueden elegir entre consultar tablas predefinidas, como las siguientes:

O bien, a partir de la v1.4.0, una lista de tablas y campos basada en una API con la opción Otros (tabla personalizada). Esta opción le permitirá consultar los datos de cualquier tabla disponible para el usuario que haya utilizado para configurar la fuente de ServiceNow datos.

La opción Tabla personalizada debe admitir exactamente las mismas características que las listas de tablas predefinidas.

Consultas de TableAPI

TableAPI devuelve datos adecuados para mostrarlos en un panel de tabla. Permite mostrar una selección ordenada de campos, además de opciones de filtro. El editor de consultas también proporciona un campo para limitar el número de filas que devuelve una consulta.

Ejemplo de panel de tabla que muestra resultados de la consulta anterior.

Mostrar

La fila Mostrar proporciona un selector para mostrar un campo. También se pueden especificar varios campos. Los campos se devolverán en el orden exacto especificado.

Valores de visualización

El indicador Valores de visualización hará que la consulta devuelva valores aptos para el usuario, o valores de visualización, en lugar de valores numéricos.

Por ejemplo, una gravedad de nivel 1 sin este indicador solo mostraría 1. Si el indicador está habilitado, se mostrará el valor 1 - High.

Según la documentación de la ServiceNow API, esto puede tener un impacto negativo en el rendimiento.

Filtros (generales)

La fila Filtros permite reducir las filas mostradas en función de varios criterios de campo y valor.

Todos los filtros se combinan con una operación AND u OR.

Los siguientes campos están disponibles cuando no se utiliza una tabla personalizada (esta lista se ampliará en el futuro).

Active
Asset
Group
Assigned To
Escalation
Issue Number
Description
Priority
State
Type
Change Risk
Change State
Start Date
End Date
On Hold

Al seleccionar una tabla personalizada, los campos se rellenan automáticamente desde la API de ServiceNow.

Filtros de fecha

Para obtener valores de fecha adicionales, consulte: https://developer.servicenow.com/app.do#!/ api_doc? v=NewYork&id=r_sgsys-dategenerate_s_s

Operadores (generales, basados en cadenas)

Operadores (basados en tiempo)

Valores

La selección del valor depende del tipo de filtro seleccionado.

Ordenar por

La fila Ordenar por permite reducir las filas mostradas en función de varios criterios de campo y valor.

Todos los filtros se combinan con una operación AND. Se agregará compatibilidad para operadores adicionales.

Límite

Se puede especificar un límite de filas para evitar que se devuelvan demasiados datos. El valor predeterminado es 25.

Campo de tiempo

Time Field es lo que convierte los datos consultados en una serie temporal. El hecho de que sus datos se traten como series temporales significa que no se mostrarán los valores del “campo de tiempo” seleccionado que no se encuentren dentro del intervalo de tiempo del panel.

El campo de tiempo predeterminado que se utiliza es “Abierto a las”, pero se puede cambiar por cualquier campo disponible que contenga un valor de tiempo.

Se proporciona un valor especial “Omitir tiempo” para permitir obtener resultados “hasta ahora” y también para permitir que los filtros controlen los datos que se muestran.

Consultas de AggregateAPI (estadísticas)

AggregateAPI siempre devolverá métricas con las siguientes agregaciones: avg, min, max y sum. El filtrado también está disponible para restringir las consultas.

Mostrar

La fila Mostrar proporciona un selector para mostrar una métrica. También se pueden especificar varias métricas.

Filtros (generales)

Los filtros de agregación permiten reducir las métricas mostradas en función de criterios de campo y valor, de forma similar a la opción de tabla.

Todos los filtros se combinan con una operación AND. Se agregará compatibilidad para operadores adicionales.

Las opciones de filtro de estadísticas son las mismas que las de TableAPI.

Agregación

Hay cuatro tipos de agregaciones de métricas, además de un “recuento”:

Agrupación por

Este selector permite dividir las métricas en agregaciones menores. Al agrupar por “prioridad”, se obtendrían las métricas con una “etiqueta” de prioridad y los valores únicos separados.

Plantillas

En lugar de codificar los nombres en las consultas, puede utilizar variables. Las variables se muestran como cuadros de selección desplegables en la parte superior del panel de control. Puede usar estos cuadros desplegables para cambiar los datos que se muestran en su panel.

Consulte el ejemplo de la sección Variable de consulta sobre cómo agregar una variable de consulta y hacer referencia a ella con un valor de plantilla.

Variable de consulta

Si agrega una variable de plantilla de tipo Query, puede escribir una consulta que devuelva elementos como nombres de categorías, nombres de clave o valores de clave que se muestran en un cuadro de selección desplegable.

Por ejemplo, puede tener una variable que contenga todos los valores de categories especificando una consulta como esta en la configuración de consulta de la variable de plantilla.

Al elegir la configuración de consulta, se muestra una sección de filtro que le permite elegir un tipo y un campo. Actualmente, el tipo está limitado a incidentes y cambios. Al seleccionar un tipo, se le proporciona una lista de los campos aplicables a ese tipo. Una vez seleccionados un tipo y un campo, se mostrará una vista previa de los valores en la parte inferior con las opciones disponibles para ese tipo o campo. Estos valores se mostrarán en una lista desplegable en el panel, que puede utilizar junto con las plantillas para filtrar los datos de los paneles de dicho panel.

Por ejemplo, si agrega una variable denominada categoría y, a continuación, selecciona Tipo = Incidentes y Campo = Categoría, verá una lista de opciones para el valor Categoría. Si, a continuación, agrega un filtro a un panel y selecciona Categoría igual a ${category}, los datos del panel solo mostrarán los datos de la categoría seleccionada en la lista desplegable del panel.

Importe el panel Incidentes por categoría para ver un ejemplo.

Uso de variables en consultas

Existen dos sintaxis:

Ejemplo de $<varname> con una variable de plantilla llamada hostname:

Ejemplo de [[varname]] con una variable de plantilla llamada hostname:

Alertas

Se admiten las alertas estándar de Grafana. Cualquier consulta definida en un panel de gráfico se puede utilizar para generar alertas.

A continuación se muestra un ejemplo de consulta y una alerta. Esta consulta devolverá un gráfico de todos los incidentes críticos de alta prioridad que están abiertos:

Esta alerta se iniciará cuando haya más de cinco incidentes críticos de alta prioridad abiertos:

Al probar la regla de alerta, se mostrará el resultado de esta regla y, al seleccionar el historial de estados, se mostrará la alerta pasando de “correcto” a “pendiente” y luego a “alerta”.

En la vista de gráfico se mostrará una línea vertical y el icono del corazón en la parte superior se volverá naranja mientras la alerta esté pendiente.

Una vez que se cumplen los criterios de alerta, la regla pasa a ser roja.

En la vista de gráfico, aparecerá la línea vertical roja y el icono del corazón en la parte superior se volverá rojo.

Escritura de incidentes para las alertas

Característica beta

Esto configurará un canal de notificaciones de Grafana que utilizará el usuario configurado para crear incidentes en la ServiceNow instancia de esta fuente de datos.

Esta acción requiere que el usuario de la fuente de ServiceNow datos tenga permisos para escribir incidentes.

Uso de un proxy HTTP

Cuando utilice un proxy HTTP, Amazon Managed Grafana necesitará establecer las siguientes variables de entorno en la ubicación del proxy:

Anotaciones

Las anotaciones de Grafana son una característica beta a partir de la v1.4.0 de este origen de datos. Las anotaciones le permiten superponer eventos en gráficos.

La consulta de anotaciones admite las mismas opciones que el editor de consultas estándar, con algunas pequeñas diferencias:

Preguntas frecuentes

¿Qué sucede si no tenemos el complemento de roles de ITSM?

Se requiere acceso de administrador para llevar a cabo las siguientes acciones

Opción 1: Otorgue permisos de administrador de usuarios de Grafana para permitir el acceso a todas las tablas.

Opción 2: Cree un rol y aplíquelo ACLs a todas las tablas a las que Grafana deba acceder.

Se requiere acceso de administrador para llevar a cabo las siguientes acciones.