Se abre un problema a las 2 de la madrugada. La guardia (on-call) repite siempre los mismos gestos: comprobar si el problema persiste, lanzar la misma consulta, copiar el resultado en el canal de incidentes. Ese toil es justo lo que automatizan los Workflows. Este artículo reúne ejemplos de Workflows de Dynatrace concretos, de lo más simple a lo más completo, y después detalla lo que dice la documentación sobre condiciones, JavaScript, costes y límites.
El objetivo no es rehacer la introducción a los Workflows, tratada en el módulo 7 del curso de SaaS, ni la integración con ITSM ya descrita en nuestro artículo sobre Jira y ServiceNow. Aquí nos centramos en los mecanismos que mantienen fiable un workflow en producción: condiciones, opciones de tarea, JavaScript y presupuesto.
Alcance: Workflows es una aplicación de la plataforma Dynatrace SaaS (latest Dynatrace). Dynatrace Managed no la incluye; allí se usan los Alerting profiles y las integraciones de notificación.
Ejemplos de Workflows de Dynatrace paso a paso
Recordatorio: cada workflow tiene un solo trigger, tareas que ejecutan acciones, y funciona bajo la identidad de un actor cuyos permisos nunca supera. Un simple workflow tiene una sola tarea y no admite JavaScript; un workflow estándar permite ramas, bucles y JavaScript.
Ejemplo 1: notificar un problema, sin coste de workflow
La necesidad más habitual: avisar a un canal de Slack o a una dirección de correo cuando se abre un problema. Basta un simple workflow: disparador Problem trigger y una tarea de envío. La documentación precisa que no consume workflow hours; solo se facturan las llamadas de función (Standard Function Calls) asociadas al envío.
Ejemplo 2: esperar a que el problema dure y luego enriquecer
Para no despertar a la guardia por un problema que se cierra solo en dos minutos, configura el Problem trigger:
- Problem state:
active; - Minimum duration (opciones avanzadas): 5, 10, 15 o 30 minutos, hasta una semana;
- Wait for root cause analysis activado, recomendado por la documentación para evitar datos incompletos.
Añade después una tarea Execute DQL Query llamada dql_task. Trampa clásica: el problema que dispara el workflow no tiene por qué estar ya escrito en Grail cuando se ejecuta la tarea. En lugar de un fetch, inyecta el evento en la consulta:
data json: """{{ event()|to_json }}"""
| fields timestamp, event.name, event.id
La otra opción documentada es un Wait before de 30 a 45 segundos en la tarea. Este tipo de retraso también reduce el ruido, como explica nuestro artículo sobre la reducción del ruido de las alertas de Davis.
Ejemplo 3: transformar un resultado con JavaScript
Una tarea Run JavaScript colocada después de dql_task puede resumir los registros antes de la notificación. El script exporta una función asíncrona por defecto; su valor de retorno pasa a ser el resultado de la tarea.
import { result } from '@dynatrace-sdk/automation-utils';
export default async function () {
const res = await result('dql_task'); // résultat de la tâche précédente
const records = res.records ?? []; // tableau renvoyé par la requête DQL
if (records.length === 0) {
return { count: 0, summary: 'aucun enregistrement' };
}
return {
count: records.length,
summary: records.slice(0, 5).map(r => r['event.name']).join(', ')
};
}
La tarea siguiente lee esos valores con {{ result("run_javascript_1")["summary"] }}. Una tarea solo puede leer los resultados de sus predecesoras directas; de lo contrario, la expresión falla con «Undefined variables».

Ejemplo 4: informe programado
Un disparador de tipo schedule, una consulta DQL sobre la semana (fetch …, from: -7d) y una tarea de correo. Atención: sin from, la acción DQL consulta las dos últimas horas, en UTC, y devuelve como máximo 1000 registros por defecto. Para escribir la consulta, nuestra guía de comandos DQL ofrece 30 ejemplos.
Condiciones: controlar qué tarea se ejecuta
Cada tarea tiene una sección Conditions que se lee como una frase: «Run this task if» seguido del estado esperado de cada predecesora.
| Condición de estado | La tarea se ejecuta si la predecesora… |
|---|---|
success or skipped (por defecto) |
ha tenido éxito o se ha omitido |
success |
ha tenido éxito |
error or cancelled |
ha fallado o se ha cancelado |
error |
ha fallado |
any |
ha terminado, sea cual sea el resultado |
A esto se suma una condición personalizada, una expresión Jinja que devuelve un booleano, por ejemplo {{ result("task_1").foo == "bar" }}. La sección Else elige qué ocurre si nada coincide: Skip (se omite la tarea y se continúa) o Stop (no se ejecuta nada más en esa rama).
Un estado success en una tarea DQL solo significa que la consulta se ejecutó, no que encontrara algo. Hay dos soluciones documentadas: activar Fail on empty result y enlazar con error, o comprobar la longitud antes de acceder a un registro:
{{ result("dql_task")["records"] | length > 0 and result("dql_task")["records"][0]["event.name"] != "" }}
La primera tarea tras el disparador no puede tener condición de estado, por falta de predecesora, pero sí una condición personalizada sobre el contexto del evento.
Opciones de tarea que conviene ajustar
- Wait before: 0 segundos por defecto, 86 400 como máximo, o una expresión Jinja.
- Loop task: itera sobre una lista; la concurrencia es 1 por defecto. La tarea queda en error si falla una iteración.
- Retry on error: 2 reintentos espaciados 30 segundos por defecto.
- Timeout: 60 minutos por defecto, hasta siete días para la tarea; cada acción sigue limitada por el runtime (120 segundos por defecto).
JavaScript: lo que hay que saber
- Límites del runtime: 120 segundos y 256 MB de memoria; resultado de tarea limitado a 6 MB.
- Sin expresiones Jinja en la entrada del script (protección contra la inyección): usa el SDK
@dynatrace-sdk/automation-utils(result,execution,executionId…). - APIs de Dynatrace:
fetch("/api/v2/...")con URL relativa, autenticación añadida automáticamente. No añadas una cabeceraAuthorization: se sobrescribe y provoca un 403. - Servicios externos: URL absoluta, y dominio autorizado en Settings > General > External requests. Las bibliotecas de terceros se importan por URL desde esos dominios, 6 MB en total.
- Secretos:
credentialVaultClient, con el ámbito AppEngine, «Allow access without app context» y acceso del actor al secreto. No devuelvas nunca el secreto en el resultado: lo puede leer cualquiera que lea el workflow. - No disponible en los simple workflows.
Costes: workflow hours y llamadas de función
Con la licencia DPS, la capacidad Automation Workflow se mide en workflow hours: el número de horas durante las que existe un workflow estándar desde su creación, esté o no en marcha. Un workflow estándar presente 14 días consume 24 × 14 = 336 workflow hours. Los simple workflows y los workflows que solo están en borrador no consumen directamente.
Además, cada ejecución desencadena Standard Function Calls, y una consulta DQL dentro de un workflow consume consulta de Grail. Para seguir el consumo, la documentación propone:
fetch dt.system.events, scanLimitGBytes: -1
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Automation Workflow"
| summarize takeAny(event.id), by: {timestamp = bin(timestamp, 1d), event.id}
| summarize WorkflowHours = count(), by: {timestamp}
| sort timestamp asc
Consecuencia práctica: un workflow estándar abandonado sigue contando; retíralo del live (vuelve a ser borrador) o elimínalo. El detalle del modelo está en nuestro artículo sobre la licencia DPS.
Límites que hay que conocer
| Límite | Valor documentado |
|---|---|
| Ejecuciones disparadas por evento | 1000 por hora y por workflow; por encima, HTTP 429 durante hasta una hora; desactivación del trigger tras tres superaciones en siete días |
| Expresión de filtro del trigger | 1000 caracteres, sumando todos los campos |
| Resultado de una acción | 6 MB menos el tamaño del log |
| Entrada por defecto y resultado del workflow | 10 MB |
| Conservación de las ejecuciones | 30 días (por tanto, timeout de ejecución de 30 días) |
| Acción DQL | 1000 registros y 2 horas por defecto, en UTC |
La documentación lo recuerda: el motor de automatización orquesta procesos, no es un pipeline de datos. Para volúmenes grandes, escribe el dato directamente en su destino desde una tarea JavaScript.
En cuanto a permisos, los permisos IAM automation:workflows:read, automation:workflows:write, automation:workflows:run y automation:workflows:admin controlan el acceso; el Problem trigger exige storage:events:read al actor.
Cómo comprobar que funciona
Lanza el borrador con Run: el Problem trigger te deja ajustar el contexto del evento. El execution monitor muestra el grafo, el estado y la duración de cada tarea, su log, y sus entradas y resultados.
Revisa en especial las tareas en estado Skipped o Discarded: delatan una condición mal escrita. Después despliega en live; solo los workflows live se disparan automáticamente.
Buenas prácticas
- Empieza con un simple workflow; pasa a estándar cuando necesites varios pasos o JavaScript.
- Modifica a través del borrador, no directamente en live: los cambios en live se aplican de inmediato.
- Elige el actor de forma deliberada (por defecto, es el último editor) y limita sus permisos a lo necesario.
- Añade una tarea Request Approval antes de cualquier acción de remediación automática.
- Da nombres explícitos a las tareas: su nombre es la clave de
result().
Preguntas frecuentes
¿Por qué mi tarea DQL tiene éxito aunque no encuentre nada?
El éxito indica que la consulta se ejecutó. Activa Fail on empty result, o comprueba | length > 0 en la condición de la tarea siguiente.
¿Un workflow retirado del live sigue costando workflow hours?
Un workflow retirado del live (undeploy) vuelve a ser un borrador, y la documentación indica que los workflows que solo están en borrador no consumen workflow hours directamente. Comprueba el resultado en Account Management, capacidad Automation Workflow.
¿Se pueden usar los Workflows con Dynatrace Managed?
No, Workflows forma parte de la plataforma SaaS. En Managed, usa los Alerting profiles, las integraciones de notificación y la API.
Conclusión
Un workflow fiable se resume en pocas reglas: un trigger que filtre bien, condiciones explícitas, JavaScript corto que no devuelva ningún secreto, y un ojo puesto en las workflow hours. Parte de estos ejemplos de Workflows de Dynatrace, pruébalos en borrador y consulta la documentación de Workflows para ver las acciones disponibles.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión. Los ejemplos se ofrecen a título indicativo: compruébalos en tu entorno antes de usarlos en producción.