Qué información debe incluir el registro de una ejecución

Identifica ejecución, evento y empresa

Asigna una referencia a la ejecución y conserva la del evento original cuando exista. Añade proceso, entorno, empresa y referencia de negocio de forma que dos cuentas con códigos iguales no se mezclen. Distingue un nuevo intento del evento que lo provoca. Si solo guardas el identificador del último intento, perderás la posibilidad de entender cuántas veces se trató el mismo trabajo.

Registra decisiones y versiones efectivas

Anota inicio, final, etapa alcanzada, versión de regla y revisión de configuración sin secretos. Guarda el motivo de exclusión o derivación con un código comprensible. Para una escritura incluye recurso de destino y referencia devuelta. No registres únicamente «correcto»: define si significa validado, aceptado por API o confirmado mediante consulta. El estado debe orientar la siguiente acción del operador.

Conserva errores útiles con un límite

Incluye categoría del fallo, código del proveedor y mensaje depurado. Evita credenciales, enlaces de descarga temporales, cuerpos completos de correo o datos que no ayuden a resolver el caso. Define acceso y retención según la necesidad operativa. OpenTelemetry distingue señales y contexto de trazas; puedes usar ese contexto para relacionar pasos sin convertir cada log en una copia del documento procesado.

Comprueba que el registro sirve a otra persona

Entrega una ejecución fallida a alguien que no la desarrolló. Debe poder localizar etapa, referencia y siguiente acción sin pedirte una explicación privada. Ensaya fallo antes de escribir, escritura confirmada y respuesta incierta. Comprueba también que búsquedas y exportaciones respetan el acceso por empresa. Si los registros se eliminan antes de la ventana de revisión, ajusta la conservación o el procedimiento para no perder la evidencia necesaria.

Añade un vocabulario de estados con una acción asociada a cada uno: revisar datos, esperar proveedor, confirmar escritura o cerrar. Una persona de soporte debe poder filtrar pendientes sin interpretar textos libres diferentes para el mismo problema. Mantén un campo de detalle para contexto puntual, pero evita que una frase improvisada sustituya el estado que usan los controles de operación.

Fuentes y documentación

• OpenTelemetry — Modelo de señales — El contexto de traza relaciona operaciones mediante identificadores de traza y de span.