Documentação

Do primeiro evento ao primeiro dashboard.

Não precisas de um projeto de engenharia de dados para começar.Cria uma organização, define um bucket de eventos, envia alguns dados e constrói a tua primeira consulta.

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.

O formulário de registo do Event Horizon DataO separador Organização nas Definições, com o nome, email e morada da empresa

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 é:

A secção Buckets a listar os buckets de eventos de um espaço de trabalho
timestamp_keyQuando o acontecimento se deu. Obrigatória, e é o que todos os filtros de tempo leem.
dimensionAquilo 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.
metricAquilo 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.

A lista de workflows, onde se constroem os pipelines de ingestão

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.

O explorador de queries, com a caixa Ask por cima de uma query a ser construída visualmente

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.

O separador Equipa nas Definições, a listar os membros e os seus papéis

Envia o teu primeiro evento.

Cria uma conta e passa dos dados em bruto a um dashboard em minutos.