Situações operacionais

A situação operacional indica como uma integração está funcionando agora. Ela aparece ao lado do nome da integração, no Dashboard e na tela da integração, sempre por escrito: Operacional, Atenção, Falha ou Pausada.

Situações

Situação	O que significa	O que fazer
Operacional	Nenhuma condição de Falha ou de Atenção se aplica.	Nada. Continue acompanhando pelo Dashboard.
Atenção	A integração funciona, mas há algo para conferir, como pendências abertas.	Abra a integração e confira a última execução e as pendências.
Falha	A integração não está entregando os registros como deveria.	Abra a última execução, descubra a causa e corrija antes da próxima execução.
Pausada	Alguém pausou a integração. Nenhuma execução é agendada até ela ser retomada.	Confirme o motivo da pausa antes de retomar.

stateDiagram-v2
  direction LR
  Operacional --> Atenção: pendência aberta ou taxa abaixo de 99%
  Atenção --> Falha: última execução falhou ou taxa abaixo de 95%
  Operacional --> Falha: última execução falhou
  Atenção --> Operacional: as condições deixam de se aplicar
  Falha --> Operacional: as condições deixam de se aplicar
  Operacional --> Pausada: Pausar
  Atenção --> Pausada: Pausar
  Falha --> Pausada: Pausar
  Pausada --> [*]: Retomar (a situação é calculada de novo)

A situação é calculada de novo cada vez que o Dashboard ou a tela da integração é carregada. Ao retomar uma integração, a situação é calculada pelas condições abaixo e pode ser Operacional, Atenção ou Falha.

Ordem das condições

A Encaixe confere as condições nesta ordem e para na primeira que se aplica:

1. Se a integração está pausada, a situação é Pausada;
2. Se alguma condição de Falha se aplica, a situação é Falha;
3. Se alguma condição de Atenção se aplica, a situação é Atenção;
4. Nos outros casos, a situação é Operacional.

Por isso, uma integração que se enquadra ao mesmo tempo em uma condição de Falha e em uma de Atenção aparece em Falha.

Condições de Falha

Uma integração fica em Falha quando pelo menos uma destas situações acontece:

• a última execução terminada ficou com a situação Falhou;
• o número Sucesso 24h da integração está abaixo de 95%;
• a integração tem frequência definida, já terminou alguma execução e está há mais de 24 horas sem uma execução Concluída ou Concluída com pendências;
• registros enviados em uma execução anterior continuam sem confirmação do sistema de destino mesmo depois da conferência feita pela execução seguinte;
• a Encaixe interrompeu a integração porque um sistema recusou as credenciais de acesso.

Condições de Atenção

Uma integração fica em Atenção quando nenhuma condição de Falha se aplica e pelo menos uma destas situações acontece:

• o número Sucesso 24h da integração está entre 95% e 99%, sem chegar a 99%;
• a integração tem pelo menos uma pendência com a situação Aberta;
• a última execução terminou há mais que o dobro do intervalo da frequência. Por exemplo, em uma integração executada A cada 15 minutos, quando a última execução terminou há mais de 30 minutos;
• a última execução terminou com a situação Aguardando confirmação e ainda há registros sem confirmação do sistema de destino.

Importante

Os limites de 95%, 99%, 24 horas e o dobro do intervalo são os valores padrão. A equipe Encaixe pode ajustar esses limites para uma integração. Por isso, use a situação mostrada pela Encaixe em vez de calcular a situação a partir de um único número.

Casos especiais

• Integração sem execuções: uma integração que ainda não terminou nenhuma execução não entra nas condições que dependem da última execução. No Dashboard, ela mostra Aguardando a primeira sincronização no lugar dos números.
• Nenhum registro enviado nas últimas 24 horas: o número Sucesso 24h mostra — e as condições de taxa não se aplicam. Uma integração sem movimento não é tratada como uma integração com 0% de sucesso.
• Registros aguardando confirmação: um registro enviado que o sistema de destino ainda não confirmou conta como tentativa e ainda não como entrega. Enquanto isso, o número Sucesso 24h pode cair.
• Integração pausada: fica fora da faixa de situação do Dashboard e da Taxa de sucesso (24h) da empresa.

Faixa de situação do Dashboard

A faixa no alto do Dashboard mostra a pior situação entre as integrações que não estão pausadas:

Pior situação	Texto
Falha	Com falha: e os nomes das integrações em Falha
Atenção	Precisa de atenção: e os nomes das integrações em Atenção
Operacional	Todos os sistemas operacionais
Todas as integrações pausadas	Todas as integrações estão pausadas — nada está sendo sincronizado

Quando todas as integrações estão pausadas, a faixa informa isso. Ela não mostra Todos os sistemas operacionais.

Saiba mais em Dashboard.

Onde investigar

• Em Falha ou Atenção, comece pela última execução. Saiba mais em Investigar uma execução.
• Com pendências abertas, abra a Central de problemas. Saiba mais em Resolver uma pendência.
• Com a integração pausada, veja Pausar e retomar uma integração.