El director de producto pregunta cuántos pedidos fallaron durante el incidente de anoche. Las trazas muestran errores 500 y los logs, excepciones, pero nadie sabe traducir eso en carritos perdidos. Los eventos de negocio Dynatrace (business events) llenan ese hueco: capturan un hecho de negocio (un pedido, un pago, un registro) con sus atributos, en el momento en que ocurre. Esta guía crea un primer evento de negocio Dynatrace y lo explota de principio a fin.
Para un SRE, es un SLI de primer orden. La tasa de pedidos completados dice más a todo el mundo que la latencia del p95, y mide directamente lo que protege el presupuesto de error. Mejor aún: con OneAgent se pueden capturar estos eventos sin modificar una sola línea del código de la aplicación.
Objetivo: crear una regla de captura de OneAgent que transforme una petición HTTP en un evento de negocio, consultarlo en DQL y obtener de él un KPI y una alerta. El contenido se dirige a Dynatrace SaaS (almacenamiento en Grail). Para Dynatrace Managed, comprueba la disponibilidad de Business Analytics en tu versión antes de empezar.
Qué son los eventos de negocio Dynatrace
Un business event es un registro almacenado en la tabla bizevents de Grail. Lleva como mínimo un proveedor (event.provider), un tipo (event.type) y una marca de tiempo, y después los atributos que elijas: importe, moneda, identificador de cliente, medio de pago.
Tres fuentes principales:
- OneAgent: una regla de captura lee la petición o la respuesta HTTP de un servicio monitorizado. Sin código.
- RUM: eventos enviados desde el navegador o la aplicación móvil.
- API: un POST en formato CloudEvents a
/api/v2/bizevents/ingest, útil para un sistema externo (ERP, batch).
No lo confundas con los logs: un business event está estructurado desde la captura, con un esquema que controlas tú. Sin parsing y sin regex frágiles.
Requisitos previos
- Un entorno SaaS con OneAgent en modo Full-Stack en el servicio que recibe las peticiones de negocio (Java, .NET, Node.js, Go, PHP u otra tecnología compatible con la captura).
- Permiso para modificar los ajustes de Business Observability.
- Para la API: un token con el scope
bizevents.ingest, o un token de plataforma conopenpipeline:bizevents:ingest. - Conocer la forma de la petición que se va a capturar: ruta, método, campos del cuerpo JSON.
Paso 1: elegir el KPI y la petición que lo transporta
Parte de una pregunta precisa: «¿cuántos pedidos validados por minuto y por qué importe?». Identifica la llamada que lo materializa, por ejemplo:
POST /api/checkout
Content-Type: application/json
{ "orderId": "A-1029", "amount": 84.90, "currency": "EUR", "paymentMethod": "card" }
Anota también qué señala el fallo: un código de estado HTTP distinto de 200, o un campo status en la respuesta.
Paso 2: crear la regla de captura de OneAgent
- Abre Settings > Business Observability > OneAgent business event sources (la etiqueta puede variar; busca «business event» en los ajustes).
- Añade una regla y ponle nombre, por ejemplo
checkout-order. - Triggers:
request.pathigual a/api/checkoutyrequest.methodigual aPOST. Los disparadores se combinan con Y: todos deben cumplirse. - Event provider: una constante, por ejemplo
shop.checkout. - Event type: una constante, por ejemplo
com.shop.order.submitted. - Data fields: añade
amount(origenrequest.body, rutaamount),currency,paymentMethodystatus(origenresponse.statusCode). - Guarda. En la mayoría de los casos la regla se aplica sin reiniciar; consulta la documentación para tu tecnología.
Punto crítico: no captures nunca datos personales innecesarios (nombre, dirección, número de tarjeta). Si un campo sensible tiene que circular, enmascáralo en el pipeline: consulta el enmascaramiento de datos sensibles con OpenPipeline.
Paso 3 (opcional): enviar un evento por la API
Para una fuente que OneAgent no monitoriza, basta la API:
curl -s -X POST "$DT_ENV/api/v2/bizevents/ingest" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/cloudevent+json" \
-d '{
"specversion": "1.0",
"id": "erp-55102",
"source": "erp.invoicing",
"type": "com.shop.invoice.created",
"data": { "orderId": "A-1029", "amount": 84.90, "currency": "EUR" }
}'
Los campos specversion, id, source y type son obligatorios. source pasa a ser el proveedor del evento y type su tipo.
Paso 4: consultar cada business event en DQL
Comprueba primero que los eventos llegan:
fetch bizevents, from:now()-1h
| filter event.provider == "shop.checkout"
| filter event.type == "com.shop.order.submitted"
| sort timestamp desc
| limit 20
Después construye el KPI: volumen, facturación y tasa de éxito por intervalos de cinco minutos.
fetch bizevents, from:now()-24h
| filter event.type == "com.shop.order.submitted"
| fieldsAdd ok = if(toLong(status) == 200, 1, else: 0)
| makeTimeseries orders = count(),
revenue = sum(toDouble(amount)),
succeeded = sum(ok),
interval:5m
La tasa de éxito (succeeded / orders) es un SLI de negocio listo para usar. Encontrarás otros modelos de consulta en las consultas DQL de operaciones.
Paso 5: alertar sobre el KPI
Dos enfoques:
- SLO: define un objetivo sobre la tasa de éxito de los pedidos y alerta sobre el consumo del presupuesto de error, como se explica en las alertas de burn rate.
- Detector de anomalías: sobre la serie
orders, un umbral bajo o una detección adaptativa captura la caída brusca de volumen, síntoma típico de un pago caído sin error visible.
Para abrir un ticket automáticamente, reutiliza el workflow hacia Jira y ServiceNow.
Cómo comprobar que funciona
- Haz un pedido de prueba en el entorno de preproducción.
- Lanza la primera consulta DQL del paso 4: el evento debe aparecer con
amount,currencyystatusinformados. - Si el evento existe pero un campo está vacío, la ruta del data field es incorrecta (mayúsculas, anidamiento). Corrígela en la regla.
- Si no llega nada: el servicio no está en Full-Stack, la petición no coincide con los disparadores (ruta con prefijo, método) o la tecnología no permite leer el cuerpo.
Buenas prácticas
- Nombrar los tipos como una API:
com.empresa.dominio.accion, estable en el tiempo. - Pocos campos, bien elegidos: cada atributo tiene un coste de almacenamiento y un riesgo de confidencialidad.
- Un KPI por recorrido crítico: carrito, pago, registro. No más al principio.
- Conectar con lo técnico: los eventos capturados por OneAgent conservan el contexto de la traza, lo que permite pasar de un pedido fallido a la petición lenta que lo explica.
- Referencia: documentación de Business Observability.
Preguntas frecuentes
¿Los business events de Dynatrace sustituyen a una herramienta de analítica web?
No. Sirven para relacionar hechos de negocio con la salud técnica, no para analizar embudos de marketing. Las dos herramientas responden a preguntas distintas.
¿Cuánto cuestan los business events?
Se facturan por ingesta, retención y consulta según tu contrato. Estima el volumen (eventos por día multiplicados por el tamaño) antes de activar una regla en una ruta muy solicitada.
¿Se puede capturar la respuesta en lugar de la petición?
Sí: las fuentes de datos incluyen response.body, response.headers y response.statusCode. A menudo ahí está el resultado real de la operación.
Conclusión
Una regla de captura, dos consultas DQL y un SLO: en una hora, la tasa de pedidos completados se convierte en un indicador compartido entre producto y operaciones. En el próximo incidente, la pregunta «¿a cuántos clientes ha afectado?» tendrá una respuesta con cifras.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Los nombres de pantallas y opciones evolucionan: comprueba siempre los valores en la documentación oficial correspondiente a tu versión.