Documentación

Del primer evento al primer panel.

No necesitas un proyecto de ingeniería de datos para empezar.Crea una organización, define un bucket de eventos, envía algunos datos y crea tu primera consulta.

01

Crea tu cuenta

Crea una cuenta y tu organización.

El primer miembro de la organización pasa a ser administrador y puede invitar al resto del equipo.

Ajustes → Organización guarda el nombre de la empresa, el correo de facturación y la dirección. Ajustes → Marca es donde defines el logotipo y los colores que tus clientes ven en los paneles compartidos e incrustados.

El formulario de registro de Event Horizon DataLa pestaña Organización en Ajustes, con el nombre, correo y dirección de la empresa

02

Define tus datos

Crea un bucket de eventos a partir de un evento de ejemplo o define tú sus campos.

Indica marcas de tiempo, dimensiones y métricas.

Event Horizon usa esa estructura para que los datos se puedan consultar.

Un bucket de eventos define a la vez lo que envías y cómo lo analizas. Pega un evento de ejemplo y las columnas se te proponen, con tipo, clasificación y el motivo de cada una; tú confirmas o corriges. No se crea nada hasta que lo hagas. También puedes declararlas a mano, eligiendo lo que es cada una:

La sección Buckets mostrando los buckets de eventos de un espacio de trabajo
timestamp_keyCuándo ocurrió el evento. Obligatoria, y es lo que leen todos los filtros de tiempo.
dimensionAquello por lo que agrupas y filtras: país, campaña, plan de suscripción. Se guarda tal como estaba en el momento del evento, así que lo que una empresa se llamaba en 2020 sigue leyéndose 2020.
metricAquello que sumas o promedias: ingresos, duración, cantidad.

Declara la zona horaria de origen de tus datos. Todo se guarda en UTC, y una zona no declarada se asume como UTC: una hora mal interpretada no se corrige después.

Las marcas de tiempo pueden ser texto ISO-8601 o un número epoch en segundos o milisegundos: deducimos la unidad por la magnitud, así que `1787232000` y `1787232000000` son el mismo instante. Un número que llega como cadena se lee igual.

03

Conecta una fuente

Envía datos mediante un webhook, un flujo de cambios de una base de datos, un workflow de API u otro método de ingesta compatible.

Inicia el workflow. Event Horizon se encarga del camino de ingesta.

El camino más corto es un webhook, y un workflow nuevo ya se abre con uno conectado a un Loader. Si tus datos vienen de otro sitio, la barra sobre el lienzo lo cambia por otra forma común: una base de datos que seguimos según cambia, o una API que llamamos con una periodicidad. Guarda, y la dirección se genera por nosotros y no es editable, porque deriva de tu organización y de ese nodo, así que nunca colisiona ni puede falsificarse.

La lista de flujos, donde se construyen las canalizaciones de ingesta

En el inspector del nodo, elige Gestionar secreto → Generar. La clave se muestra una sola vez y se guarda solo como hash: ni nosotros podemos recuperarla. Si la pierdes, generas otra. Después envía a la dirección que aparece en el campo URL del nodo:

curl -X POST "https://ingest.eventhorizondata.com/webhooks/<org>/<node>" \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"evt-1","value":42}'

Fíjate en el host ingest. La ingesta tiene su propia entrada, separada de la aplicación, y una petición enviada al dominio de la aplicación será rechazada.

Inicia el flujo. Un nodo de webhook solo acepta tráfico mientras su flujo esté en marcha.

Envía un `event_id` en el cuerpo, o una cabecera `Idempotency-Key`, y una repetición del mismo identificador dentro de cinco minutos se descarta en lugar de guardarse dos veces. Sin ninguno de los dos, cada petición se acepta como nueva: preferimos no adivinar qué hace que dos de tus eventos sean el mismo.

Un 401 significa una de dos cosas: falta la cabecera Authorization, o la clave no coincide. Un nodo cuya clave nunca se generó lo rechaza todo, por diseño.

04

Mira tus datos

Abre Explorar y elige:

¿Qué pasó?
Métrica.
¿A quién o dónde?
Dimensión.
¿Cuándo?
Rango de tiempo.

Después crea la consulta visualmente. Sin SQL.

El explorador de consultas no necesita SQL: elige un bucket de eventos, una métrica, algo por lo que agrupar y un periodo. También puedes escribir la pregunta con palabras y pulsar Ask: el borrador vuelve relleno, con una nota que dice qué cubrió y qué dejó fuera. Nada se ejecuta hasta que lo has mirado. Los paneles se construyen igual y se pueden compartir por enlace o incrustar en tu propio producto con tu marca.

El explorador de consultas, con la caja Ask sobre una consulta que se construye visualmente

05

Crea el panel

Convierte las preguntas que te importan en widgets del panel. Filtra y profundiza en los resultados.

Comparte el panel o intégralo en tu propio producto.

06

Controla el acceso

Invita a tu equipo. Asigna roles. Usa ámbitos de fila cuando alguien solo deba ver una parte de los datos.

Ajustes → Equipo para invitar personas, Roles para diseñar lo que cada una puede hacer, y ámbitos de fila para limitar a alguien a una parte de los datos: un cliente tuyo que solo deba ver su región.

La pestaña Equipo en Ajustes, con los miembros y sus roles

Envía tu primer evento.

Crea una cuenta y pasa de los datos en bruto a un panel en minutos.