Queries são a camada flexível por baixo de dashboards, auditorias e investigações. Use SQL ad-hoc para testar uma ideia e, quando ela se tornar parte de um fluxo recorrente, salve a query.
Criar e executar uma query
- Acesse Analyze → Queries e selecione new query.
- Abra o navegador de schema e escolha campos dos dados de evento, sessão ou avaliação.
- Escreva o SQL, adicione parâmetros quando necessário e execute a query.
- Salve com um nome e descrição claros e use add to dashboard quando o resultado precisar ser monitorado.
O editor de queries combina o schema de eventos, SQL, parâmetros e uma prévia dos resultados para que você possa validar a questão antes de salvá-la.
As queries salvas aparecem na biblioteca compartilhada, onde os membros da equipe podem reexecutá-las ou adicionar seus resultados a dashboards.
Use um nome e descrição claros para que o resultado continue compreensível sem precisar reabrir o SQL.Use fp query list para encontrar IDs e fp query delete <query-id> para remover uma query salva. Usos comuns
- Encontrar sessões com chamadas repetidas à mesma ferramenta.
- Comparar pontuações de avaliação entre modelos ou ambientes.
- Medir o tempo entre uma espera humana e a retomada.
- Identificar negações de política seguidas de uma alternativa bem-sucedida.
- Construir uma coorte para auditoria.
Abra Queries → Schema antes de escrever consultas contra campos desconhecidos. Prefira filtros explícitos de tempo e ambiente, e mantenha limites de resultados durante a exploração.
Uma query pode identificar um padrão suspeito, mas não estabelece o modo de falha por si só. Abra traces representativos ou execute uma auditoria antes de transformar o resultado em uma política.
