Zonas horarias.
Cómo Vericto almacena los timestamps en UTC, los convierte a tu zona horaria en el dashboard y qué implica esto en el selector de tiempo, el audit trail y las exportaciones.
Resumen
Todos los eventos que Vericto registra — queries interceptadas, bloqueos, reglas disparadas — se almacenan con timestamps en UTC. El dashboard los convierte a tu zona horaria preferida para visualización, pero la fuente de verdad es siempre UTC.
Esto garantiza que los datos son consistentes independientemente de dónde estés tú o tu equipo, y evita ambigüedades durante cambios de horario de verano.
Regla general: todo se guarda en UTC, todo se muestra en tu zona horaria. Las exportaciones CSV/JSON incluyen timestamps en ISO 8601 con el offset UTC (2026-07-01T14:30:00.000Z) para que cualquier herramienta los interprete correctamente.
Cómo funciona
1. Almacenamiento: siempre UTC
El proxy TCP registra el timestamp de cada query en el momento de la evaluación, usando el reloj del servidor en UTC. Este valor nunca se modifica al almacenarlo en la base de datos de Vericto.
# Ejemplo de timestamp almacenado
event.created_at = "2026-07-01T19:30:00.000Z" # UTC siempre2. Presentación: tu zona horaria preferida
Cuando abres el dashboard, Vericto detecta automáticamente tu zona horaria del navegador (Intl.DateTimeFormat().resolvedOptions().timeZone). Puedes fijar una zona horaria diferente en Ajustes → Cuenta → Zona horaria, y esa preferencia se sincroniza a tu cuenta para que sea consistente en todos tus dispositivos.
El selector de tiempo muestra la zona activa en su footer: por ejemplo GMT-5 (UTC-5). El rango que ves en el campo de timeframe — como 07/01/2026, 14:30 AM → 07/01/2026, 02:30 PM — está expresado en tu zona local, aunque internamente las queries usan UTC.
El selector de tiempo
El selector de tiempo del Overview aparece en la barra superior del dashboard. Funciona de la siguiente manera:
| Elemento | Descripción |
|---|---|
| Campo de timeframe | Muestra el rango activo en formato legible, expresado en tu zona horaria local. Es de solo lectura para los presets; editable al elegir rango personalizado. |
| Icono de calendario | Abre dos campos datetime-local para elegir un rango exacto (inicio y fin). Los valores se interpretan en tu zona horaria local y se convierten a UTC internamente. |
| Botón Apply | Confirma el rango personalizado y lanza una nueva consulta al backend con los parámetros from_date y to_date en UTC. |
| Presets | Atajos relativos al momento actual (-1h → Now, -24h → Now, etc.). El backend los resuelve siempre desde el instante de la petición en UTC. |
| Recently used | Los últimos 3 presets o rangos personalizados que usaste, para acceso rápido. |
| Footer de zona horaria | Muestra tu zona activa (ej. GMT-5 (UTC-5)). Haz clic en «Learn more» para llegar a esta página. Para cambiarla, ve a Ajustes → Cuenta. |
Rango personalizado y zonas horarias
Cuando introduces un rango personalizado con el calendario, los valores que escribes en los inputs se interpretan como si fueran tu hora local. Por ejemplo, si tu zona es America/Bogota (UTC-5) y escribes 2026-07-01T09:00, Vericto lo convierte a 2026-07-01T14:00:00Z (UTC+0) antes de enviarlo al backend.
# Lo que ves en el input (hora local America/Bogota, UTC-5)
From: 2026-07-01T09:00
To: 2026-07-01T17:00
# Lo que Vericto envía al backend (UTC)
from_date: 2026-07-01T14:00:00.000Z
to_date: 2026-07-01T22:00:00.000ZCambiar tu zona horaria
Hay dos formas de ajustar la zona horaria con la que Vericto muestra los datos:
Automática (recomendada)
Deja la configuración en Automática en Ajustes → Cuenta → Zona horaria. Vericto usa la zona del navegador (Intl.DateTimeFormat().resolvedOptions().timeZone) en cada sesión. Si viajas o cambias de dispositivo, la visualización se adapta sola.
Fija (ideal para equipos distribuidos)
Si tu equipo trabaja desde múltiples países y quieres que todos vean los mismos horarios en los reportes, fija una zona horaria explícita en tu cuenta:
- Ve a Dashboard → Ajustes → Cuenta.
- En la sección Preferencias de visualización, selecciona la zona en el selector de zona horaria.
- Guarda. La preferencia se sincroniza a tu cuenta y aplica en todos los dispositivos donde inicies sesión.
Cambiar la zona no reinterpreta los datos históricos. Solo cambia cómo se muestran los timestamps ya almacenados en UTC. Un evento registrado a las 14:00 UTC aparecerá como 09:00 en UTC-5 o como 16:00 en UTC+2 — el mismo instante, distinta representación.
Audit trail y exportaciones
La página de Audit Trail filtra eventos por ventana de tiempo usando la misma lógica que el Overview: los inputs de fecha que introduces se interpretan en tu zona local y se convierten a UTC para la consulta.
Exports CSV/JSON
Los archivos exportados contienen los timestamps en ISO 8601 con offset UTC (Z). Esto garantiza que cualquier herramienta de análisis — Excel, Python, dbt, BigQuery — los interprete sin ambigüedad:
# Columna timestamp en un export CSV
event_id,timestamp,status,rule_code,latency_ms
b4f2...,2026-07-01T14:30:00.000Z,BLOCKED,VERICTO-001,1.8
c9a1...,2026-07-01T14:30:01.123Z,ALLOWED,,0.9Si necesitas los timestamps en tu zona local para análisis, convierte en tu herramienta de destino. Ejemplo en Python:
import pandas as pd
df = pd.read_csv('audit_export.csv')
df['timestamp'] = pd.to_datetime(df['timestamp'], utc=True)
# Convertir a tu zona local
df['timestamp_local'] = df['timestamp'].dt.tz_convert('America/Bogota')Cambios de horario de verano (DST)
Al almacenar todo en UTC, Vericto es inmune a los cambios de horario de verano. Un evento ocurrido justo en el momento del cambio de reloj tiene un timestamp UTC único y sin ambigüedad.
La conversión a hora local aplica el offset correcto para cada instante histórico usando las reglas IANA. Por ejemplo, en America/New_York:
| Timestamp UTC | Hora local (NYC) | Offset |
|---|---|---|
2026-03-08T06:59:00Z | 01:59 AM EST | UTC-5 |
2026-03-08T07:00:00Z | 03:00 AM EDT | UTC-4 |
2026-11-01T05:59:00Z | 01:59 AM EDT | UTC-4 |
2026-11-01T06:00:00Z | 01:00 AM EST | UTC-5 |
El dashboard aplica automáticamente el offset correcto para cada instante. No es necesaria ninguna configuración adicional.
Preguntas frecuentes
¿Por qué el selector muestra una hora diferente a la del log en mi servidor?
Probablemente tu servidor usa hora local y Vericto usa UTC. Compara los timestamps añadiendo o restando tu offset UTC. Por ejemplo, si estás en UTC-5 y Vericto muestra 14:30 UTC, tu servidor local mostraría 09:30.
¿Puedo filtrar el audit trail por hora local?
Sí. Los inputs de fecha en el audit trail y en el selector de tiempo del Overview aceptan fechas en tu zona horaria local. Introduce la hora que ves en tu reloj y Vericto convierte la búsqueda a UTC internamente.
¿La zona horaria afecta a las notificaciones de Slack/webhook?
Los mensajes de notificación incluyen el timestamp del evento. Por defecto, Vericto los formatea en UTC. En una versión futura se añadirá la opción de personalizar el formato de fecha/hora en las notificaciones.
¿Qué pasa si cambio de zona horaria mientras tengo una sesión abierta?
El cambio aplica en el siguiente clic de navegación o refresco de datos. No es necesario cerrar sesión.