Operação
Solução de problemas.
Comece pelo estado seguro do resource. Não publique sua credencial, arquivos de configuração ou conteúdo da fila ao pedir ajuda.Consulte o status
traki:status| Campo | Interpretação |
|---|---|
connected | O último heartbeat foi concluído. |
queue | Eventos pendentes e capacidade máxima. |
dropped | Eventos descartados por pressão ou falha permanente. |
rejected | Eventos recusados pela API por contrato. |
recovered | Eventos restaurados da fila em disco neste início. |
persistedAt | Última gravação segura da fila. |
error | Código seguro do último problema observado. |
connected=false
- Confirme `traki_api_url` e use HTTPS fora de localhost.
- Confirme que o token pertence à instalação e não foi desativado.
- Teste a saída do FXServer para a API e verifique firewall ou DNS.
- Evite reinícios repetidos; a fila tenta novamente com espera progressiva.
Credencial inválida
Erros `401`, `403` ou INVALID_CREDENTIAL pausam o envio. Rotacione a credencial no painel, altere somente `traki_integration_token` e reinicie o resource.
Fila crescendo
Investigue primeiro a disponibilidade da API. Não aumente `traki_queue_limit` como solução automática. Quando a fila enche, eventos menos severos são removidos antes dos mais críticos.
Falha de persistência
QUEUE_PERSIST_FAILED indica que o FXServer não conseguiu gravar na pasta do próprio resource. Verifique as permissões do diretório e as regras do sandbox. Não conceda acesso desnecessário a outras pastas.
Consumer parou após restart
Ao reiniciar `traki`, o FXServer também pode parar resources que declaram dependência dele. Inicie-os novamente na ordem correta:
ensure traki
ensure seu_resource_consumidorAntes de pedir suporte
- Informe a versão do resource e do FXServer.
- Copie somente a saída de `traki:status`.
- Informe horário, ambiente e código seguro do erro.
- Remova credenciais, IPs, identificadores e dados pessoais.