Relatórios de Performance: Entenda as Diferenças de Métricas
Ao acompanhar o desempenho da sua integração na Intranet, você encontrará três opções principais de relatórios. É comum que os números entre eles apresentem variações, e este artigo explica o papel de cada indicador e o motivo dessas divergências.
Os 3 Tipos de Relatórios Disponíveis
1. Quantidade de Pesquisa (Requisição)
Este é o indicador de tráfego bruto. Ele reflete o volume total de tentativas que chegam aos nossos servidores.
Abrangência: Registra todas as intenções de acesso, independentemente do resultado.
Inclusões: Contabiliza "Bad Requests" (requisições mal estruturadas), erros de sintaxe e falhas de envio.
Resultado: Mesmo que a requisição não retorne dados por erro do cliente, ela é somada aqui.
2. Quantidade de Pesquisa por Cidade x Agência
Funciona sob a mesma lógica do relatório anterior, mas com um nível de detalhamento geográfico e comercial.
Foco: Tráfego bruto segmentado por destino (cidade) e por cliente (agência).
Utilidade: Ideal para entender quais mercados ou agências específicas estão gerando mais volume de tentativas de busca, permitindo uma análise de demanda mais granular.
3. Uso da API (API Usage)
Este é o relatório de consumo efetivo. Ele filtra o ruído do tráfego e mostra apenas o que foi processado com sucesso técnico e de segurança.
Condição: Apenas requisições devidamente autenticadas são exibidas.
Validação: Requer que o usuário e a senha estejam corretos.
Sucesso Técnico: Indica que a requisição estava bem estruturada e o acesso foi formalmente autorizado pelo sistema.
Por que os números não batem?
É natural que o Uso da API apresente números menores que a Quantidade de Pesquisa.
O que uma grande diferença indica?
Se o volume de requisições for drasticamente superior ao uso real, sua integração pode estar enfrentando problemas como:
Tentativas de conexão com credenciais (usuário/senha) inválidas ou expiradas.
Envio de XML/JSON com erros de estrutura que impedem a leitura pelo servidor.
Tentativas de acesso a serviços não contratados.
Comparativo Rápido
| Relatório | Tipo de Dado | Considera Erros/Falhas? |
| Qtd. de Pesquisa | Volume Total (Bruto) | Sim |
| Qtd. por Cidade x Agência | Volume Segmentado | Sim |
| Uso da API | Consumo Real (Líquido) | Não (Apenas sucessos) |
Ainda tem dúvidas?
Se precisar de auxílio para interpretar seus números ou identificar erros de integração, entre em contato com nosso time de suporte:
? support@cangooroo.net
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo