Para configurar notificaciones de seguimiento heredadas usando @servicenow-<INSTANCE_NAME>:

1. En Datadog, vaya a la página de configuración de la integración de ServiceNow.

2. Vaya a la pestaña Configurar, luego a la pestaña ITOM/ITSM y después a la pestaña Monitores.

3. En Administrar notificaciones de seguimiento heredadas, seleccione la instancia para la que desea configurar las notificaciones y, a continuación, seleccione la tabla en la que se escribirán las notificaciones de seguimiento heredadas.

4. Para validar que la integración esté configurada correctamente, agregue @servicenow-<INSTANCE_NAME> en una notificación de seguimiento o evento. Puede definir los valores Impact y Urgency para que ServiceNow pueda usarlos para calcular la prioridad del incidente. Los datos sin procesar completan las filas en la tabla provisional y se reenvían a la tabla de ServiceNow especificada por la integración.

5. Use mapas de transformación en ServiceNow para personalizar la transformación de los datos enviados a las tablas provisionales.

6. Personalice la carga útil de la notificación con variables de Datadog disponibles o cadenas personalizadas.

Nota: Impact y Urgency en las descripciones de los monitores solo funcionan para configuraciones de monitores heredadas. Para monitores con plantilla, configure el mapeo de prioridad de instancia. El campo priority en los incidentes de ServiceNow es de solo lectura y solo se puede actualizar mediante reglas de búsqueda de prioridad.

action

Tipo: Cadena
La acción que se está realizando en el monitor: create, update, acknowledge o resolve

additional_information

Tipo: Cadena
Transformación de ITOM: additional_info
Cadena con formato que contiene todos los detalles del evento

aggreg_key

Tipo: Cadena
Clave de agregación que representa un hash del ID del monitor que alerta

alert_cycle_key

Tipo: Cadena
Clave que representa un hash del ciclo de alerta de un solo monitor (rastrea Alerta → Advertencia → Resolver)

alert_id

Tipo: Cadena
ID del monitor que alerta

alert_metric

Tipo: Cadena
Transformación de ITOM: metric_name
Métrica que activó la alerta

alert_query

Tipo: Cadena
Consulta que activó la alerta

alert_scope

Tipo: Cadena
Alcance que activó la alerta

alert_status

Tipo: Cadena
Estado actual de la alerta

alert_title

Tipo: Cadena
Nombre de la alerta

alert_transition

Tipo: Cadena
Transformación ITSM: (script) -> estado
Estado de transición de la alerta: Triggered, Warn, o Recovered

assignment_group_sys_id

Tipo: Referencia
Transformación ITSM: assignment_group
Tabla de referencia: Grupo
sys_id de ServiceNow para el grupo de asignación del identificador con plantilla

business_service_sys_id

Tipo: Referencia
Transformación ITSM: business_service
Reference Table: Servicio
sys_id de ServiceNow para el servicio empresarial del templated handle

custom_fields

Tipo: Cadena
Campos de clave-valor configurados por el usuario formateados como una cadena convertible a JSON

datadog_tags

Tipo: Cadena
Etiquetas de Datadog del seguimiento que genera la alerta

description

Tipo: Cadena
Transformación ITSM: description
Transformación ITOM: description
Descripción resumida de la alerta del seguimiento

event_details

Tipo: Cadena
Transformación ITSM: work_notes
Detalles del evento con enlaces formateados y en los que se puede hacer clic hacia Datadog

event_id

Tipo: Cadena
ID de Datadog del evento

event_link

Tipo: Cadena
Enlace al evento creado a partir de la alerta del seguimiento

event_msg

Tipo: Cadena
Mensaje del evento

event_title

Tipo: Cadena
Transformación ITSM: short_description
Título del evento

event_type

Tipo: Cadena
Transformación ITOM: type
Tipo de evento

hostname

Tipo: Cadena
Transformación ITSM: cmdb_ci
Transformación ITOM: node
Servidor del seguimiento afectado

impact

Tipo: Entero
Transformación ITSM: impact
Valor de impacto basado en el mapeo definido por el usuario de la prioridad del seguimiento

logs_sample

Tipo: Cadena
Muestra de registros relevantes

monitor_priority

Tipo: Entero
Transformación ITOM: severity
Prioridad del seguimiento que genera la alerta como un entero

org_name

Tipo: Cadena
Nombre de la organización del seguimiento que genera la alerta

sys_created_by

Tipo: Cadena
Transformación de ITSM: caller_id
Creador del registro (generalmente la cuenta de servicio de ServiceNow API configurada)

ticket_state

Tipo: Cadena
Transformación de ITSM: state, (script) -> close_code, (script) -> close_notes
Transformación de ITOM: (script) -> resolution_notes
Estado del registro de ServiceNow: new o resolved

u_correlation_id

Tipo: Cadena
Transformación de ITSM: correlation_id
Transformación de ITOM: message_key
Combinación de alert_cycle_key y aggreg_key utilizada para fusionar registros en el mismo incidente de destino

urgency

Tipo: Entero
Transformación de ITSM: urgency
Urgencia establecida a partir del mapeo definido por el usuario en el mosaico de integración según la prioridad definida por el seguimiento

user_sys_id

Tipo: Referencia
Transformación de ITSM: assigned_to
Reference Table: Usuario
sys_id del templated handle proporcionado para el usuario

Para evitar que la tabla de conjunto de importación x_datad_datadog_import_host acumule demasiadas filas, se ha agregado una regla de vaciado automático a la herramienta Limpiador de tablas para conservar solo las últimas 24 horas de datos. Esta configuración se puede cambiar según sea necesario navegando a sys_auto_flush_list.do en el navegador de filtros y entrando en la regla para la tabla x_datad_datadog_import_host. El campo Age in seconds se puede actualizar en consecuencia.

Para crear una asignación de campo personalizada en ServiceNow:

1. Haga clic en una de las tablas (por ejemplo, Tablas ITSM de monitores de Datadog) y desplácese hasta la parte inferior del registro para ver el enlace del mapa de transformación asociado.

2. Haga clic en el nombre del mapa de transformación para ver el registro:

   En la parte superior hay dos campos importantes en el registro de transformación: Source table y Target table:

3. Haga clic en Nuevo:

4. Seleccione los campos de origen y destino para las asignaciones uno a uno:

   O marque la casilla Usar script de origen y defina las transformaciones:

Para asignar campos personalizados en el mosaico de integración, puede usar el siguiente script para los mapas de transformación Datadog Monitors ITOM y Datadog Monitors ITSM. En este ejemplo, el campo my_field se define como un campo personalizado en el mosaico de integración:

answer = (function transformEntry(source)
{
    var additional_info = JSON.parse(source.additional_info);
    return additional_info.my_field;
})(source);

Notas:

• La fuente es la tabla de importación que seleccionó (en este ejemplo, Datadog Monitors ITSM Tables) y el destino es su tabla de incidentes (o tabla de eventos) real donde se almacenan los eventos.

• Las asignaciones de campos se encuentran en la parte inferior del registro. Se incluyen algunas asignaciones básicas. Aquí es donde selecciona los campos a incluir, define el formato y selecciona los campos de destino en su instancia de ServiceNow.

Para usar información de alertas correlacionadas para completar valores en ServiceNow, agregue un nuevo script de transformación onBefore bajo el mapa de transformación de la tabla Datadog Cases ITSM/ITOM.

Para completar datos en el incidente de ServiceNow, debe modificar su script para analizar los datos que se han enviado desde Datadog y almacenado en la columna EM Correlated Alert, y especificar a qué campos en el incidente desea enviar los datos analizados. A continuación se muestra un script de ejemplo que puede personalizar según sus necesidades:

(function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    // We do not need to process non-correlated-alert events
    if (!source.em_correlated_alert_id) {
        return;
    }

    // Create a GlideRecord for the table
    var gr = new GlideRecord('x_datad_datadog_case_incident_table');
    gr.addQuery('case_id', source.case_id);
    gr.addNotNullQuery('em_correlated_alert_id');
    gr.orderByDesc('sys_created_on');
    gr.query();

    // Ensure we process each alert_id only once
    var seenAlert = {};

    // Add relevant correlated alert fields here
    var alertNames = [];


    // Loop through list of correlated_alerts associated with the same case_id
    while (gr.next()) {
        var emAlertId = gr.getValue('em_correlated_alert_id');

        if (!seenAlert.hasOwnProperty(emAlertId)) {
            seenAlert[emAlertId] = true;
            var changeType = gr.getValue('em_change_type');
            if (changeType == "added") {
                var correlatedAlert = gr.getValue("em_correlated_alert");
                var jsonAlert = JSON.parse(correlatedAlert);

                // Get relevant fields from the JSON event
                var alertName = jsonAlert['alert_message'];
                alertNames.push(alertName);
            }
        }
    }

    // Set the corresponding value on the incident table
    // target.impact = 1;

})(source, map, log, target);

Si recibe un mensaje de error en su mosaico de integración de Datadog, o una notificación Error while trying to post to your ServiceNow instance:

• Verifique que solo se haya utilizado el subdominio al ingresar el nombre de su instancia.

• Verifique que el usuario que creó tenga los permisos requeridos.

• Verifique que el nombre de usuario y la contraseña sean correctos.

Si la integración está configurada y se activó una alerta, pero no se crea ningún ticket:

• Confirme que la tabla provisional esté poblada. Si es así, el problema está en las asignaciones y transformaciones. Puede depurar sus asignaciones y scripts aún más navegando a Errores de transformación en ServiceNow.
• Confirme que está trabajando con la tabla provisional que especificó en el mosaico.

El usuario de ServiceNow necesita los roles rest_service y x_datad_datadog.user para que pueda acceder a las tablas de importación. Si está utilizando la forma heredada de enviar notificaciones directamente a la tabla de Incidentes o a la tabla de Eventos, necesita los permisos itil y evt_mgmt_integration.

Si ve actualizaciones de Datadog Work Management a ServiceNow, pero no ve actualizaciones de ServiceNow a Datadog, este es el comportamiento esperado para ServiceNow ITOM. La sincronización bidireccional con Work Management solo es compatible con ServiceNow ITSM.

Si un monitor vuelve a abrir el mismo incidente en lugar de crear uno nuevo para cada advertencia, asegúrese de que no esté configurado como una alerta simple. Convierta el monitor en una alerta múltiple agrupándolo mediante una etiqueta en la métrica. De esta manera, cada alerta activará un incidente independiente.