Semáforo das integrações, mensagens paradas e envelhecimento

O semáforo de cada integração

A aba Agora (e a lista de empresas da equipe Lefia) mostra cada integração em um estado, sempre pelas últimas 24 horas:

Estado	Quando
Parada	chegou mensagem e nada foi entregue: tudo o que teve desfecho deu erro
Degradada	entrega, mas o erro ficou igual ou acima do limiar da política de SLA da empresa (padrão 5%)
Silenciosa	teve mensagem nos últimos 7 dias e nada nas últimas 24 horas
Entregando	tem mensagem e o erro está abaixo do limiar
Sem tráfego	nada nos últimos 7 dias — não é alarme

A lista vem pior primeiro. Tocar numa integração abre as mensagens dela das últimas 24 horas. O estado da empresa é o pior entre as integrações dela.

O limiar é configurável em Configurações → Política de SLA.

O que precisa de você agora

Mensagens com erro, sem nova tentativa agendada e no mesmo estado há mais de 1 hora — ninguém vai tentar de novo sozinho. A lista mostra quem espera há mais tempo primeiro, com Reprocessar ali mesmo. O número do cartão é o total, de qualquer dia; o link abre a lista completa em Mensagens.

Hora a hora

As últimas 24 horas em barras, uma por hora; a parte vermelha é o erro daquela hora. Hora sem barra é hora sem mensagem — muitas vezes é o primeiro sinal de uma integração silenciosa.

Envelhecimento (aba Técnico)

Só entra o que está parado de fato: erro, nova tentativa agendada ou confirmação pendente. As faixas dizem o que fazer:

Faixa	Leitura
Até 2 h	o turno ainda resolve
2 a 6 h	já passou do turno
6 h a 3 dias	alguém precisa olhar
Mais de 3 dias	ninguém está olhando

Cada faixa separa erro, retry e aguardando confirmação, e a tabela abaixo mostra as faixas por integração.

Categorias de erro

Os erros são classificados em categorias (autenticação, negócio, esquema, mapeamento, transporte, tempo esgotado, desconhecida). "Erros por categoria" fica na aba Técnico e cada fatia abre os erros daquela categoria.

Semáforo indisponível agora

Na Visão geral do Monitor, cada empresa tem o semáforo lido à parte. Se a leitura de uma empresa não responder a tempo, a linha dela mostra Semáforo indisponível agora e as demais seguem normais; os totais de mensagens e erros das 24 h continuam aparecendo. Recarregue a página em alguns instantes. Se continuar, a equipe Lefia já recebeu o aviso.

Com muito volume (por exemplo, uma rodada de centenas de milhares de mensagens), os contadores do semáforo saem dos números consolidados por hora: na hora em curso eles podem ficar um pouco abaixo do real até a hora fechar.

Números com "~"

Com muito volume, os contadores das últimas 24 h de uma integração (mensagens e erros) podem aparecer com ~ na frente: são aproximados. Passe o mouse sobre o número para ver o motivo. Se a empresa usa a consolidação por hora, as horas mais recentes ainda estão sendo consolidadas e o número pode ficar um pouco abaixo do real até a hora fechar. Se não usa, a contagem soma o consolidado e até 20 mil mensagens mais novas. Integração sem mensagem nas últimas 24 h mostra 0, sem ~. A data da última mensagem só ganha ~ quando ela veio do consolidado, depois que a busca parou no limite de leitura.