Workflows
Resumen
La integración de ServiceNow de Rootly utiliza flujos de trabajo para crear y actualizar automáticamente tickets de ServiceNow. Si no está familiarizado con cómo funcionan los Flujos de trabajo, visite primero nuestraWorkflowsdocumentación.
Workflows
Crear un Incidente de ServiceNow
Esta acción de flujo de trabajo crea un registro en laIncident
tabla (por ejemplo,INC0010001
) y lo vincula al registro de incidente de Rootly.
Actualizar un Incidente de ServiceNow
Esta acción de flujo de trabajo actualiza las propiedades de datos de un registro existente de laIncident
tabla (por ejemplo,INC0010001
).
Campos Personalizados Comunes
Incidente Mayor
Notas de Trabajo
Las notas de trabajo son comentarios internos que se pueden agregar a un incidente de ServiceNow. Las notas de trabajo no pueden ser vistas por los clientes.
Comentario
Los comentarios se pueden agregar a un incidente de ServiceNow y pueden ser vistos por los clientes.
Agregar Elemento de Configuración (CI) al Incidente
Agregar un elemento de configuración (CI) a un incidente es una acción complicada debido a las limitaciones técnicas de las API de ServiceNow. Para facilitar esta acción, necesitaremos utilizar la acción de flujo de trabajo del Cliente HTTP de Rootly para consolidar múltiples llamadas a la API de ServiceNow en una sola acción.
La API de ServiceNow que usaremos para agregar CIs a un incidente es laTable API.
Dado que la API de ServiceNow solo permite agregar un CI por llamada a la API, usaremos suBatch APIpara envolver múltiples llamadas a la API de Table juntas y aprovechar la acción de flujo de trabajoHTTP Clientde Rootly para llevar a cabo la llamada.
Nombre
Este campo se establece automáticamente para usted. Puede renombrar este campo a lo que mejor describa su acción. El valor en este campo no afecta cómo se comporta la acción del flujo de trabajo.
URL
Este es el punto final de la API Batch de ServiceNow. El valor debe estar en el siguiente formato:https://<instance-domain>.com/api/now/v1/batch
Método
Esta es la operación de la API. En este caso, seleccionePOST
.
Parámetros de Encabezado
Estos son los parámetros de encabezado requeridos por la API Batch. Los valores se configuran en formato JSON e incluyen el token de autenticación.
Si no quiere que su nombre de usuario:contraseña sea visible para los no administradores, puede almacenarlo como una variableSecreten Rootly.
En este caso, establezca el siguiente formato:
Parámetros de Consulta
Dado que esta es una llamada POST, no habrá parámetros de consulta. Deje este campo vacío.
Parámetros del Cuerpo
El cuerpo es donde queremos consolidar las llamadas individuales a la API de Table en un solo cuerpo.
Cada campobody
de las llamadas API individuales envueltas dentro de la API BATCH debe estar codificado en base64.
El formato sigue algo como esto:
Un caso de uso común es tener elservices
seleccionado de Rootly para un incidente automáticamente agregado al incidente de ServiceNow como unAffected CIs
.
Para admitir este caso de uso, debe tener cadasys_id
de ServiceNow CI vinculado a su equivalenteservices
de Rootly.
La siguiente sintaxis aprovecha la sintaxis Liquid para establecer dinámicamente cada campotask
yci_item
codificado en base64 en cada llamada a la API de Table:
Éxito en Estado
Establecer en200
. A diferencia de la mayoría de las solicitudes POST que devuelven201
, el punto final POST de la API Batch de ServiceNow devuelve200
código de estado para indicar éxito.
No necesita llenar el resto de los campos en la acción del flujo de trabajo. Son más para depuración y uso de notificaciones.