> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Streaming Hub no Lerian Console

> Abra o módulo Streaming Hub no Lerian Console: acompanhe a entrega de eventos no dashboard, busque no catálogo de eventos e crie e gerencie subscriptions.

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](/pt/platform/streaming-hub/managing-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](/pt/platform/console/settings-products).

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

<Steps>
  <Step title="Abra o formulário">
    Na página **Assinaturas**, clique em **Nova assinatura**.
  </Step>

  <Step title="Dê um nome à subscription">
    Digite um **Nome**. A lista mostra esse nome.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Digite o endpoint">
    Para um webhook, digite o **Endpoint**: um endereço `https` que o Streaming Hub consegue alcançar.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Crie">
    Clique em **Criar assinatura**.
  </Step>
</Steps>

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](/pt/platform/streaming-hub/consuming-events).

### 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

***

<Columns cols={2}>
  <Card title="Gerenciar subscriptions" icon="list-check" horizontal href="/pt/platform/streaming-hub/managing-subscriptions">
    Crie e gerencie subscriptions pela API.
  </Card>

  <Card title="Consumir eventos" icon="inbox" horizontal href="/pt/platform/streaming-hub/consuming-events">
    Verifique assinaturas, elimine entregas duplicadas e puxe eventos.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.