ID de correlación para eventos estructurados
Un ID de correlación conecta registros creados por el mismo flujo de trabajo. Puede vincular una solicitud entrante a un trabajo en cola, un webhook a una sincronización de facturación o un evento de resultado estructurado a un seguimiento existente.
Elija una identificación con un significado
Asigne un nombre al identificador de lo que representa: request_id, trace_id, job_id, webhook_delivery_id o workflow_run_id. Un correlation_id genérico es más difícil de usar cuando diferentes servicios le atribuyen significados diferentes.
Genere el valor en el límite confiable más temprano y páselo explícitamente a través del trabajo posterior. Conserve un ID de seguimiento ascendente cuando ya esté disponible. Para trabajos asincrónicos, almacene tanto la solicitud de origen o el ID del flujo de trabajo como el propio ID del sistema de trabajo cuando cada uno responda una pregunta diferente.
No utilice direcciones de correo electrónico, tokens de acceso ni cargas útiles de proveedores sin procesar como valores de correlación. Un identificador interno opaco es más fácil de rotar y más seguro de exponer en el resultado de una consulta.
Consultar un flujo de trabajo
Una vez que las tablas relacionadas comparten un identificador, SQL puede reconstruir la secuencia:
SELECT
timestamp_utc,
event_name,
status,
duration_ms,
error_type
FROM workflow_events
WHERE workflow_run_id = 'run_example'
ORDER BY timestamp_utc;
Para paneles agregados, agrupe por categorías estables en lugar de por el ID en sí. Mantenga los ID de correlación en una tabla de fallas recientes o en una consulta detallada para que los ingenieros puedan pasar de una tasa a ejemplos concretos.
Evita los descansos habituales
No genere un nuevo ID de solicitud en cada servicio. No sobrecargue un campo con un ID de solicitud en algunas filas y un ID de cuenta en otras. Los reintentos de confirmación conservan el ID del flujo de trabajo mientras reciben un intento distinto o un ID de entrega. Si el valor cruza un límite de confianza, valide su formato y longitud antes de registrarlo.
La correlación crea navegabilidad, no causalidad en sí misma. Documente cómo se propaga el valor y qué evento posee el resultado final.
Empareje esta guía con registros, métricas, seguimientos y eventos y campos de alta cardinalidad.