Logs de consulta

A tabela de logs de consultas contém a lista de consultas executadas em um banco de dados KQL do Eventhouse, que faz parte da Inteligência em Tempo Real. Para cada consulta, um registro de evento de log é armazenado na tabela EventhouseQueryLogs.

tabela de logs de consulta

Use os logs de consulta para:

  • Analisar o desempenho e as tendências da consulta.
  • Solução de problemas de lentidão de consultas.
  • Identifique as consultas pesadas que consomem grande quantidade de recursos do sistema.
  • Identifique os usuários/aplicativos que executam o maior número de consultas.

A tabela a seguir descreve as colunas armazenadas na tabela EventhouseQueryLogs:

Nome da coluna Tipo Descrição
CacheColdHitsBytes longo A quantidade de dados de armazenamento frio que estavam disponíveis para a consulta em cache frio devido à pré-busca de dados.
CacheColdMissesBytes longo A quantidade de dados de armazenamento frio que não estava disponível para a consulta no cache frio.
CacheHotHitsBytes longo A quantidade de dados que estava disponível para a consulta no cache frequente. A quantidade de dados armazenados no cache frequente é definida pela política de cache de banco de dados ou tabela.
CacheHotMissesBytes longo A quantidade de dados que não estava disponível para o comando no cache frequente.
CapacityId cadeia O identificador de capacidade do Fabric.
ComponentFault cadeia No caso de um erro de consulta, o componente onde a falha ocorreu. Valores válidos: Server e Client. Se o conjunto de resultados da consulta for muito grande, o valor será Client. Se ocorrer um erro interno, o valor será Server.
CorrelationId cadeia O identificador de correlação da consulta. O valor pode incluir componentes de outros itens que participam da consulta, como o modelo semântico do relatório que executa a consulta.
CpuTimeMs longo O tempo total da CPU (ms) usado pela consulta.
CustomerTenantId cadeia O identificador de locatário do cliente.
DatabaseId cadeia O identificador exclusivo do banco de dados.
DatabaseName cadeia O nome do banco de dados.
DurationMs longo A duração da consulta (ms).
ExtentsMaxScannedTime datetime O tempo máximo de exame dos dados.
ExtentsMinScannedTime datetime O tempo mínimo do exame de dados.
FailureReason cadeia O motivo pelo qual a consulta falhou.
Identidade dinâmico A identidade do usuário ou aplicativo que executou a consulta.
ItemId cadeia O identificador do item do Fabric Eventhouse.
ItemKind cadeia O tipo do item do Fabric. Valores válidos: Eventhouse.
ItemName cadeia O nome do item do Fabric Eventhouse.
Nível cadeia Não aplicável.
MemoryPeakBytes longo O consumo de memória de pico da consulta.
OperationEndTime datetime A hora (UTC) em que a operação foi concluída.
OperationId cadeia O identificador de log de consulta exclusivo.
OperationStartTime datetime A hora (UTC) em que a operação foi iniciada.
QueryText cadeia O texto da consulta.
Region cadeia A região em que o banco de dados KQL do Fabric está localizado.
ResultTableCount int O número de tabelas usadas pela consulta.
ResultTableStatistics cadeia As estatísticas detalhadas das tabelas usadas pela consulta.
ScannedExtentsCount longo O número de extensões verificadas pela consulta. Um número alto pode indicar a causa de um problema de latência de consulta.
ScannedRowsCount longo O número de linhas verificadas pela consulta. Um número alto pode indicar a causa de um problema de latência de consulta.
SourceApplication cadeia O nome do aplicativo de origem que executou a consulta.
Status cadeia O status de conclusão da consulta.
Timestamp datetime A hora (UTC) em que o evento foi gerado.
TotalExtentsCount longo O número total de extensões no conjunto de resultados.
TotalRowsCount longo O número total de linhas no conjunto de resultados.
espaços de trabalhoId cadeia O identificador do workspace.
WorkspaceMonitoringTableName cadeia O nome da tabela de monitoramento do workspace. Valores válidos: EventhouseQueryLogs.
WorkspaceName cadeia O nome do workspace.

Consultas de exemplo

Encontre consultas de amostra no repositório GitHub de exemplos de malha.

Modelos

Você pode explorar e visualizar os logs usando Real-Time templates integrados de dashboards seguindo o guia de monitoramento Visualize workspace .