Skip to main content
O módulo Streaming Hub no Lerian Console mostra como o Hub entrega os seus eventos. Use-o para acompanhar a entrega, ler o catálogo de eventos e gerenciar subscriptions. Gerenciar subscriptions cobre as mesmas tarefas de subscription pela API.

Acessando o Streaming Hub


O módulo funciona apenas quando o Streaming Hub está ligado para a sua organização. Um administrador o liga em Configurações > Produtos. Veja Produtos. Abra o seletor de produtos no Lerian Console e selecione Streaming Hub. A barra lateral tem três entradas: Dashboard, Catálogo de Eventos e Assinaturas. Quando o Streaming Hub está desligado, as páginas do módulo mostram um aviso que aponta para essa configuração.

Dashboard


O módulo abre no Dashboard. Ele mostra a entrega de eventos, como o Hub mediu. Selecione o período no topo: 1h, 6h, 24h ou 48h. O padrão é 24 horas. Para outra janela, escolha Personalizado e defina um Início e uma Duração. O início deve estar no passado. O dashboard mostra:
  • Estado atual: as subscriptions no momento do retrato, contadas por ativação, por estado de verificação, por tipo de destino e por canal.
  • Eventos recebidos: os eventos que o Hub recebeu no período, com um gráfico por hora ou por dia UTC. Não é uma contagem de entregas.
  • Entrega push: os jobs de entrega criados e as tentativas de entrega por resultado, como Entregue ou Falhou.
  • Backlog de push: os jobs de entrega aguardando e há quanto tempo o mais antigo aguarda.
  • Elegibilidade pull: os eventos que os consumidores pull tinham direito de ler e as correspondências de subscription elegíveis. O Hub não informa o que um consumidor leu.
Abaixo deles, Requer atenção lista as subscriptions que precisam da atenção de um operador no período. Cada linha mostra o destino, a verificação, o estado, o último sucesso e a última falha, e as contagens de tentativas. A coluna Razões diz por que a linha está ali, por exemplo Desativada automaticamente ou Destino não verificado.

Catálogo de eventos


Catálogo de Eventos lista os eventos que os produtores anunciam e quão atual é cada um. A página agrupa os eventos por tópico. Cada evento mostra a chave do evento, a versão do schema, uma descrição, o recurso e a origem. A chave do evento é o valor que uma subscription recebe como tipo de evento. Cada tópico mostra um badge de atualização para cada produtor, como Atualizado ou Desatualizado. Use Buscar no catálogo para filtrar por chave do evento, descrição, tópico ou produtor. Produtores que não anunciam eventos lista os produtores que o Hub varre, mas dos quais não tem nenhum evento.

Subscriptions


Assinaturas lista para onde o Hub entrega os seus eventos. A tabela mostra Nome, Destino, Tipo, Estado, Verificação e Criado. Filtre a lista por Tipo de destino, Entrega e Verificação. O Console mostra cada destino sem o caminho, sem a query e sem qualquer identificador de conta. O Streaming Hub guarda o endereço completo. Para abrir uma subscription, clique no nome dela.

Crie uma subscription

1

Abra o formulário

Na página Assinaturas, clique em Nova assinatura.
2

Dê um nome à subscription

Digite um Nome. A lista mostra esse nome.
3

Escolha o tipo de destino

Escolha Webhook se o Hub envia para o seu endpoint, ou Pull se o seu serviço lê do Hub.
4

Digite o endpoint

Para um webhook, digite o Endpoint: um endereço https que o Streaming Hub consegue alcançar.
5

Escolha os tipos de evento

Escolha todos os tipos de evento, inclusive os publicados depois. Ou escolha apenas os tipos de evento que você seleciona no catálogo.
6

Defina os campos opcionais

Deixe Aplicação produtora em branco para receber de todos os produtores. Deixe Versão maior do schema em branco para seguir a versão que o Hub publica.
7

Crie

Clique em Criar assinatura.
Para um webhook, o diálogo Assinatura criada mostra o signing secret. O Streaming Hub o devolve exatamente uma vez. Copie-o e selecione Copiei o segredo de assinatura e guardei em local seguro. Depois clique em Verificar agora para enviar uma requisição assinada ao seu endpoint, ou em Verificar depois. O Streaming Hub não entrega nada ao destino até que uma requisição assinada chegue até ele e tenha sucesso. Para uma subscription pull, o diálogo Assinatura pull criada mostra o ID da subscription. Uma subscription pull não tem signing secret: o seu consumidor se autentica com o próprio token. Veja Consumir eventos.

A página da subscription

A página da subscription tem estes cartões:
  • Destino: o endereço, o tipo de destino, o estado da entrega e o estado de verificação.
  • Entrega: a ativação, os tipos de evento, o produtor, a versão do schema, o esquema de assinatura, o plano, a data de criação e a data da última alteração.
  • Credencial: o tipo de credencial, como Função entre contas ou Credencial de fila armazenada, e a última vez que o signing secret mudou. O Hub nunca devolve material secreto em uma leitura, então o cartão não pode mostrá-lo.
  • Como consumir esta assinatura: para uma subscription pull, como o seu serviço a lê.
  • Saúde da entrega: a taxa de sucesso por tentativa, o último sucesso e a última falha, as tentativas em dead letter, os eventos em quarentena, o atraso do consumidor e os resultados das tentativas.
  • Ações: as ações para esta subscription.
Uma subscription que aguarda verificação mostra Aguardando verificação no topo.

Verifique, rotacione ou exclua uma subscription

  • Verificar agora envia uma requisição real e assinada ao seu endpoint. O Console não a oferece quando a subscription está ativa e a chave dela está ligada. É a única ação que reverte um desligamento automático.
  • Rotacionar segredo de assinatura vale para um webhook que tem um signing secret. O diálogo Rotacionar o segredo de assinatura emite um novo segredo e o mostra uma vez. O Hub assina cada entrega com os dois segredos até o prazo que o diálogo mostra. Clique em Rotacionar o segredo para confirmar.
  • Excluir assinatura para a entrega. Digite o nome da subscription para confirmar e clique em Excluir. Se você criar uma subscription webhook de novo, ela recebe um novo signing secret. Uma subscription pull perde a posição até a qual o seu consumidor leu.

Próximos passos


Gerenciar subscriptions

Crie e gerencie subscriptions pela API.

Consumir eventos

Verifique assinaturas, elimine entregas duplicadas e puxe eventos.