Observabilidad
Logging recomendado
Por cada llamada a la API, registrá:
| Campo | Razón |
|---|---|
| Timestamp | Auditoría temporal |
| Método + URL | Identificación del endpoint |
| Status HTTP | Diagnóstico |
| Latencia | Performance |
Idempotency-Key (si es POST) | Trazabilidad |
clave (si viene en la respuesta) | Trazabilidad |
Prefijo de la API key (lxs_live_a1b2c3d4_) | Identificación en soporte |
⚠ Nunca loguees la API key completa. Solo el prefijo (los primeros 17 caracteres).
Métricas a monitorear
- Tasa de éxito (% de
2xx). - Latencia p50, p95, p99 del
POST /facturas. - % de webhooks recibidos vs comprobantes emitidos.
- Comprobantes rechazados por Hacienda (alerta si > 5%).
- Edad media de comprobantes en
procesando(alerta si > 10 min).