Workflow de Dynatrace con Jira o ServiceNow: abrir un ticket automáticamente ante un problema

Workflow de Dynatrace con Jira o ServiceNow: abre un ticket en cuanto aparece un problema de Davis, sin duplicados y con contexto, y verifica la ejecución.
Workflow Dynatrace Jira ou ServiceNow : ouvrir un ticket automatiquement sur problème

Se abre un problema de Davis, la guardia (on-call) lo ve, y entonces alguien copia a mano el título, la entidad afectada y el enlace en Jira o ServiceNow. Ese gesto lleva cinco minutos, se hace mal a las tres de la madrugada y se olvida una vez de cada diez. Un workflow de Dynatrace con Jira (o ServiceNow) elimina ese toil: el ticket se abre solo, con el contexto, en cuanto se confirma el problema.

La ganancia es concreta para la fiabilidad: el ticket existe antes de que el ingeniero se conecte, la marca de tiempo de apertura es exacta, y el cálculo del MTTR se apoya en datos limpios en lugar de en registros tardíos.

Objetivo de este tutorial: construir un workflow que cree un ticket de Jira o un incidente de ServiceNow al abrirse un problema, sin duplicados, y verificar que funciona. Alcance: los Workflows (AutomationEngine) existen en Dynatrace SaaS. En Dynatrace Managed, la misma necesidad se cubre con las integraciones de notificación de problemas, descritas al final del artículo.

Requisitos previos

  • Un entorno de Dynatrace SaaS con la aplicación Workflows y los derechos para crear y ejecutar un workflow.
  • En Jira: una URL de sitio, una cuenta de servicio, un token de API de Jira y un proyecto de destino. En ServiceNow: una instancia y una cuenta de integración con derecho a crear incidentes.
  • La aplicación de conexión correspondiente instalada desde el Hub (conector de Jira o de ServiceNow). Los nombres exactos de las aplicaciones y de las acciones pueden variar según las versiones: compruébalos en el Hub y en la documentación de Workflows.
  • Problemas bien acotados: si tu entorno genera demasiados, empieza por reducir el ruido de las alertas de Davis. Un ticket automático sobre una alerta ruidosa solo desplaza el ruido.

Construir el workflow de Dynatrace con Jira paso a paso

Paso 1: crear la conexión

En los ajustes de la aplicación de conexión de Jira, añade una conexión: URL del sitio (por ejemplo https://tu-empresa.atlassian.net), correo electrónico de la cuenta de servicio y token de API de Jira. Para ServiceNow, indica la URL de la instancia y las credenciales de la cuenta de integración.

Usa una cuenta de servicio dedicada, no una cuenta personal: el día que la persona deje el equipo, los tickets seguirán abriéndose. Limita sus derechos al proyecto de destino.

Paso 2: elegir el disparador

Crea un workflow y elige el disparador de evento de problema de Davis. Configúralo para que reaccione solo a los problemas activos y filtra el alcance:

  • categoría de problema: disponibilidad y errores, por ejemplo, en lugar de todas las categorías;
  • entidades afectadas: filtro por una etiqueta como team:paiement, para que cada equipo tenga su workflow y su proyecto.

Este filtrado es la decisión más importante del tutorial. Un workflow que abre un ticket por cada problema menor produce una cola que nadie lee.

Paso 3: evitar los duplicados

Un problema puede actualizarse varias veces y volver a disparar el workflow según los ajustes. Añade una tarea «Run JavaScript» que lea el evento disparador y prepare una clave de deduplicación:

import { execution } from '@dynatrace-sdk/automation-utils';

export default async function ({ execution_id }) {
  const ex = await execution(execution_id);
  const event = ex.params.event;

  return {
    displayId: event['display_id'],
    label: 'dt-' + String(event['display_id']).toLowerCase(),
    title: event['event.name'],
    category: event['event.category'],
  };
}

Línea crítica: ex.params.event contiene el evento que disparó el workflow. La clave label (por ejemplo dt-p-240123) sirve de etiqueta de Jira o de referencia de correlación de ServiceNow: se busca un ticket que la lleve antes de crear uno.

A continuación, añade una tarea de búsqueda en Jira (acción de búsqueda de tickets por JQL si tu conector la ofrece) con la consulta:

project = OPS AND labels = "{{ result("prepare_key").label }}" AND statusCategory != Done

Dale a la tarea de creación una condición que solo la lance si la búsqueda no devuelve ningún ticket. El editor de condiciones de la tarea acepta una expresión; comprueba su forma exacta en la ayuda contextual del editor.

Paso 4: crear el ticket de Jira

Añade la acción de creación de ticket de Jira, selecciona la conexión del paso 1 y rellena los campos con expresiones:

Proyecto    : OPS
Tipo        : Incident
Resumen     : [{{ result("prepare_key").displayId }}] {{ result("prepare_key").title }}
Etiquetas   : {{ result("prepare_key").label }}, dynatrace
Descripción :
  Problema de Dynatrace {{ event()["display_id"] }}
  Categoría: {{ event()["event.category"] }}
  Inicio: {{ event()["event.start"] }}
  Abierto automáticamente por un workflow. Análisis y causa raíz en Dynatrace.

Añade en la descripción el enlace al problema en tu entorno. El formato exacto de la URL depende de la aplicación Problems de tu versión; copia una desde la interfaz para construir la plantilla.

Paso 4 bis: la variante de ServiceNow

Con el conector de ServiceNow, sustituye la acción de Jira por la acción de creación de incidente. Los campos habituales de la tabla incident:

short_description : [{{ result("prepare_key").displayId }}] {{ result("prepare_key").title }}
description       : Problema de Dynatrace {{ event()["display_id"] }}, categoría {{ event()["event.category"] }}
correlation_id    : {{ result("prepare_key").label }}
urgency           : 2
impact            : 2
assignment_group  : <tu-grupo>

El campo correlation_id sustituye a la etiqueta de Jira para la deduplicación. Haz corresponder urgencia e impacto con tu matriz de prioridad ITSM, en lugar de enviarlo todo con prioridad 1.

Paso 5: reaccionar al cierre del problema

Crea un segundo workflow, disparado por los problemas cerrados, que encuentre el ticket por su etiqueta y añada un comentario «resuelto en Dynatrace». Deja el cierre del ticket a una persona: es el momento de completar la causa y decidir si hace falta un postmortem. Para estructurar esta revisión, consulta el postmortem sin culpables con DQL.

Cómo comprobar que funciona

  1. Lanza una ejecución manual del workflow desde el editor, eligiendo un problema reciente como evento de ejemplo si la opción está disponible.
  2. Abre el historial de ejecuciones: cada tarea debe estar en verde. Una tarea fallida muestra el error devuelto por Jira o ServiceNow (401 = credenciales, 400 = falta un campo obligatorio, a menudo el tipo de ticket).
  3. Comprueba en Jira que un ticket lleva la etiqueta dt-p-…. Vuelve a lanzar la ejecución: no debe aparecer un segundo ticket.
  4. En SaaS, compara con los problemas reales:
    fetch dt.davis.problems, from:now()-24h
    | filter event.status == "ACTIVE"
    | fields display_id, event.name, event.category

    Cada problema del alcance filtrado debe tener su ticket.

Buenas prácticas

  • Un workflow por equipo, filtrado por etiqueta, en lugar de un workflow global: cada ticket llega al proyecto correcto.
  • Deduplica siempre por el identificador del problema: una cola llena de duplicados pierde la confianza de los equipos.
  • Contexto, no volumen: añade una consulta DQL de los logs de error de la entidad afectada, como en el módulo Workflows de la ruta de aprendizaje de SaaS, en lugar de un texto genérico.
  • Monitoriza el propio workflow: un token de Jira caducado detiene en silencio la creación de tickets. Basta una notificación ante un fallo de ejecución.
  • Prueba en un proyecto de pruebas antes de apuntar al proyecto de producción.

Preguntas frecuentes

¿Cómo se hace lo mismo en Dynatrace Managed?

Managed no tiene Workflows. Usa las integraciones de notificación de problemas (Jira, ServiceNow o webhook personalizado), junto con un perfil de alerta que filtre el alcance. El procedimiento se detalla en perfiles de alerta e integraciones de notificación.

¿Hay que conservar la integración de notificación si tengo un workflow?

No, no para el mismo alcance: ambos crearían tickets duplicados. Migra equipo por equipo y desactiva la integración antigua cuando el workflow esté validado.

¿Puedo llamar directamente a la API de Jira con una petición HTTP?

Sí, la acción de petición HTTP lo permite, con las credenciales almacenadas de forma segura y el dominio de Jira autorizado en los ajustes del entorno. El conector es más sencillo de mantener; la petición HTTP sirve para un campo o un punto de acceso que el conector no cubre.

Conclusión

Un workflow bien filtrado y deduplicado convierte cada problema de Davis en un ticket aprovechable, sin introducción manual. La guardia gana unos minutos por incidente, el MTTR se vuelve medible y la revisión del incidente parte de datos fiables. Empieza con un equipo y un proyecto, y luego amplía.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Jira y ServiceNow son marcas de sus respectivos propietarios. Los nombres de las acciones evolucionan: compruébalos en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Requêtes DQL exemples : 15 requêtes prêtes à copier avec DQL summarize, filter et timeseries

Ejemplos de consultas DQL: 15 consultas listas para copiar con DQL summarize, filter y timeseries

Next Post
OpenTelemetry Python FastAPI : instrumenter une API vers Dynatrace sans OneAgent

OpenTelemetry Python FastAPI: instrumenta una API hacia Dynatrace sin OneAgent

Related Posts