01
Criar a conta
Cria uma conta e a tua organização.
O primeiro membro da organização torna-se administrador e pode convidar o resto da equipa.
Definições → Organização guarda o nome da empresa, o email de faturação e a morada. Definições → Marca é onde defines o logótipo e as cores que os teus clientes veem nos dashboards partilhados e embebidos.

02
Define os teus dados
Cria um bucket de eventos a partir de um evento de exemplo ou define tu os campos.
Indica timestamps, dimensões e métricas.
O Event Horizon usa essa estrutura para tornar os dados consultáveis.
Um bucket de eventos define ao mesmo tempo o que envias e como o analisas. Cola um evento de exemplo e as colunas são propostas por nós, com tipo, classificação e a razão de cada uma; tu confirmas ou corriges. Nada é criado até o fazeres. Também podes declará-las à mão, escolhendo o que cada uma é:
| timestamp_key | Quando o acontecimento se deu. Obrigatória, e é o que todos os filtros de tempo leem. |
| dimension | Aquilo por que agrupas e filtras: país, campanha, plano de subscrição. Fica gravado como estava no momento do evento, portanto o que uma empresa se chamava em 2020 continua a ler 2020. |
| metric | Aquilo que somas ou de que tiras médias: receita, duração, quantidade. |
Declara o fuso horário de onde vêm os dados. Guarda-se tudo em UTC, e um fuso não declarado é assumido como UTC. Uma hora mal interpretada não se corrige depois.
Os instantes podem vir como texto ISO-8601, ou como um número epoch em segundos ou milissegundos. Deduzimos a unidade pela grandeza, portanto `1787232000` e `1787232000000` são o mesmo instante. Um número que chegue como string é lido da mesma maneira.
03
Liga uma fonte
Envia dados por um webhook, um fluxo de alterações de uma base de dados, um workflow de API ou outro método de ingestão suportado.
Inicia o workflow. O Event Horizon trata do caminho de ingestão.
O caminho mais curto é um webhook, e um workflow novo já abre com um ligado a um Loader. Se os teus dados vêm de outro sítio, a barra por cima da tela troca-o por outra forma comum: uma base de dados que seguimos à medida que muda, ou uma API que chamamos com uma periodicidade. Grava, e o endereço é gerado por nós e não é editável, porque deriva da tua organização e desse nó, por isso nunca colide nem pode ser forjado.
No inspetor do nó, escolhe Gerir segredo → Gerar. A chave é mostrada uma única vez e guardada apenas como hash, e nem nós a conseguimos recuperar. Se a perderes, geras outra. Depois envia para o endereço que aparece no campo URL do nó:
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}' Repara no anfitrião ingest. A ingestão tem entrada própria, separada da aplicação, e um pedido enviado para o domínio da aplicação é recusado.
Inicia o workflow. Um nó de webhook só aceita tráfego enquanto o workflow dele estiver a correr.
Envia um `event_id` no corpo, ou um cabeçalho `Idempotency-Key`, e uma repetição do mesmo identificador dentro de cinco minutos é descartada em vez de guardada duas vezes. Sem nenhum dos dois, cada pedido é aceite como novo, porque preferimos não adivinhar o que torna dois dos teus eventos o mesmo evento.
Um 401 quer dizer uma de duas coisas: falta o cabeçalho Authorization, ou a chave não corresponde. Um nó cuja chave nunca foi gerada recusa tudo, por desenho.
04
Ver os dados
Abre a secção Explorar e escolhe:
- O que aconteceu?
- Métrica.
- A quem ou onde?
- Dimensão.
- Quando?
- Intervalo de tempo.
Depois constrói a consulta visualmente. Sem SQL.
O explorador de queries não precisa de SQL: escolha um bucket de eventos, uma métrica, algo por que agrupar e um período. Também pode escrever a pergunta por palavras e carregar em Ask: o rascunho volta preenchido, com uma nota a dizer o que cobriu e o que deixou de fora. Nada corre antes de o ter visto. Os dashboards constroem-se da mesma maneira e podem ser partilhados por link ou embebidos no seu próprio produto com a sua marca.
05
Constrói o dashboard
Transforma as perguntas que te interessam em widgets de dashboard. Filtra e aprofunda os resultados.
Partilha o dashboard ou incorpora-o no teu próprio produto.
06
Controla o acesso
Convida a tua equipa. Atribui papéis. Usa âmbitos de linha quando alguém só deve ver uma parte dos dados.
Definições → Equipa para convidar pessoas, Papéis para desenhar o que cada uma pode fazer, e âmbitos de linha para limitar alguém a uma parte dos dados, como um cliente teu que só deve ver a região dele.