Monitorizar pedidos de consulta no Pesquisa de IA do Azure

Este artigo explica como medir o desempenho e o volume das consultas usando métricas incorporadas e registos de diagnóstico. Também explica como obter as cadeias de consulta inseridas pelos utilizadores da aplicação.

O portal Azure mostra métricas básicas sobre latência de consultas, carga de consulta (QPS) e limitação. Os dados históricos que alimentam estas métricas podem ser acedidos no portal do Azure durante 30 dias. Para uma retenção mais longa, ou para reportar dados operacionais e cadeias de consulta, deve ativar o registo de diagnóstico e escolher uma opção de armazenamento para as operações e métricas registadas persistentes. Recomendamos Log Analytics workspace como destino para operações registadas. As consultas Kusto e a exploração de dados têm como alvo um espaço de trabalho do Log Analytics.

As condições que maximizam a integridade da medição de dados incluem:

• Use um serviço faturável (um serviço criado no nível Básico ou Standard). O serviço gratuito é partilhado por vários subscritores, o que introduz uma certa volatilidade à medida que as cargas mudam.

• Use uma única réplica e partição, se possível, para criar um ambiente contido e isolado. Se usar múltiplas réplicas, as métricas de consulta são médias entre vários nós, o que pode diminuir a precisão dos resultados. De forma semelhante, múltiplas partições significam que os dados são divididos, com a possibilidade de algumas partições terem dados diferentes se a indexação também estiver em curso. Quando ajustas o desempenho das consultas, um único nó e uma partição proporcionam um ambiente mais estável para testes.

Volume de consulta (QPS)

O volume é medido como Consultas de Pesquisa por Segundo (QPS), uma métrica incorporada que pode ser reportada como uma média, contagem, valores mínimos ou máximos de consultas que são executadas numa janela de um minuto. Intervalos de um minuto (TimeGrain = "PT1M") para métricas são fixos dentro do sistema.

O Pesquisa de IA do Azure mantém dados de métricas de 30 dias por padrão. Podes ativar o registo para uma retenção mais longa. O QPS está disponível no portal Azure, no separador Monitorização do seu serviço de pesquisa.

Para saber mais sobre a métrica SearchQueriesPerSecond, veja Pesquisas por segundo.

Desempenho da consulta

A nível de serviço, o desempenho das consultas é medido como latência de pesquisa e consultas limitadas. Estas métricas também estão disponíveis no separador de Monitorização .

Latência de pesquisa

A latência de pesquisa indica quanto tempo uma consulta demora a ser concluída. Para saber mais sobre a métrica SearchLatency, consulte SearchLatency.

Considere o seguinte exemplo de métricas de Latência de Pesquisa : foram amostradas 86 consultas, com uma duração média de 23,26 milissegundos. Um mínimo de 0 indica que algumas consultas foram eliminadas. A consulta mais longa demorava 1000 milissegundos a ser concluída. O tempo total de execução foi de 2 segundos.

Consultas sujeitas a limitação

Consultas controladas referem-se a consultas que são descartadas em vez de processadas. Na maioria das vezes, a limitação é uma parte normal do funcionamento do serviço. Não é necessariamente um sinal de que algo está errado. Para saber mais sobre a métrica ThrottledSearchQueriesPercentage, consulte Percentagem de consultas de pesquisa limitadas.

Na captura de ecrã seguinte, o primeiro número é a contagem (ou número de métricas enviadas para o log). Outras agregações, que aparecem no topo ou ao passar o cursor sobre a métrica, incluem média, máximo e total. Neste exemplo, não foram retirados pedidos.

Explore métricas no portal do Azure

Para uma visão rápida dos números atuais, o separador Monitorização na página de Visão Geral do serviço mostra três métricas (Latência de Pesquisa, Consultas de Pesquisa por segundo (por unidade de pesquisa),Percentagem de Consultas de Pesquisa Limitadas) em intervalos fixos medidos em horas, dias e semanas, com a opção de alterar o tipo de agregação.

Para uma exploração mais profunda, abra o explorador de métricas no menu de Monitorização para que possa sobrepor, ampliar e visualizar dados para explorar tendências ou anomalias. Saiba mais sobre o explorador de métricas completando este tutorial sobre como criar um gráfico de métricas.

1. Na secção Monitorização, selecione Métricas para abrir o explorador de métricas com o âmbito definido para o seu serviço de pesquisa.

2. Em métrica, escolha uma métrica da lista suspensa e reveja a lista de agregações disponíveis para um tipo preferido. A agregação define como os valores recolhidos são amostrados em cada intervalo de tempo.

   

3. No canto superior direito, defina o intervalo de tempo.

4. Escolha uma visualização. O padrão é um gráfico de linhas.

5. Adicione mais agregações em camadas escolhendo Adicionar métrica e selecionando diferentes agregações.

6. Faça zoom numa área de interesse no gráfico de linhas. Coloca o ponteiro do rato no início da área, seleciona e mantém pressionado o botão esquerdo do rato, arrasta para o outro lado da área e larga o botão. O gráfico aproxima-se desse intervalo temporal.

Devolver as cadeias de consulta introduzidas pelos utilizadores

Quando ativa o registo de recursos, o sistema captura pedidos de consulta na tabela AzureDiagnostics . Como pré-requisito, deve já ter especificado um destino para operações registadas, seja um espaço de trabalho de análise de registos ou outra opção de armazenamento.

1. Na secção Monitorização, selecione Logs para abrir uma janela de consulta vazia no Log Analytics.

2. Execute a seguinte expressão para operações de pesquisa Query.Search , retornando um conjunto de resultados tabulares que consiste no nome da operação, cadeia de consulta, índice consultado e número de documentos encontrados. As duas últimas instruções excluem as sequências de consulta que consistem numa pesquisa vazia ou não especificada, sobre um índice de exemplo, o que reduz o ruído nos seus resultados.

      AzureDiagnostics
   | project OperationName, Query_s, IndexName_s, Documents_d
   | where OperationName == "Query.Search"
   | where Query_s != "?api-version=2026-04-01&search=*"
   | where IndexName_s != "hotels-sample"
   

3. Opcionalmente, defina um filtro Coluna em Query_s para pesquisar uma sintaxe ou cadeia específica. Por exemplo, podes filtrar por é igual a?api-version=2026-04-01&search=*&%24filter=HotelName.

   

Embora esta técnica funcione para investigação ad hoc, construir um relatório permite-lhe consolidar e apresentar as cadeias de consulta de forma mais propícia à análise.

Identificar consultas de longa duração

Adicione a coluna de duração para obter os números de todas as consultas, não apenas daquelas que são captadas como métrica. Ordenar estes dados mostra-lhe quais as consultas que demoram mais tempo a ser concluídas.

1. Na secção Monitorização, selecione Registos para consultar informações de registo.

2. Execute a seguinte consulta básica para devolver as consultas, ordenadas por duração em milissegundos. As consultas mais longas estão no topo.

   AzureDiagnostics
   | project OperationName, resultSignature_d, DurationMs, Query_s, Documents_d, IndexName_s
   | where OperationName == "Query.Search"
   | sort by DurationMs
   

   

Crie um alerta de métrica

Um alerta de métrica estabelece um limiar para enviar uma notificação ou acionar uma ação corretiva que define antecipadamente. Pode criar alertas relacionados com a execução de consultas, mas também pode criá-los para saúde de recursos, alterações na configuração do serviço de pesquisa, execução de competências e processamento de documentos (indexação).

Todos os limiares são definidos pelo utilizador, por isso deves ter uma ideia de que nível de atividade deve desencadear o alerta.

Para a monitorização de consultas, é comum criar um alerta de métricas para a latência de pesquisa e consultas limitadas. Se souber quando as consultas são descartadas, pode procurar soluções que reduzam a carga ou aumentem a capacidade. Por exemplo, se as consultas limitadas aumentarem durante a indexação, pode adiá-la até que a atividade das consultas diminua.

Se estiveres a ultrapassar os limites de uma configuração específica de partição réplica, configurar alertas para limites de volume de consultas (QPS) também é útil.

1. Em Monitorização, selecione Alertas e depois selecione Criar regra de alerta.

2. Em Condições, selecione Adicionar.

3. Configurar a lógica dos sinais. Para o tipo de sinal, escolha métricas e depois selecione o sinal.

4. Depois de selecionar o sinal, pode usar um gráfico para visualizar dados históricos e tomar uma decisão informada sobre como proceder com a criação das condições.

5. De seguida, desça até à lógica de Alerta. Para prova de conceito, pode especificar um valor artificialmente baixo para fins de teste.

6. De seguida, especifique ou crie um Grupo de Ação. Esta é a resposta para invocar quando o limiar é atingido. Pode ser uma notificação push ou uma resposta automática.

7. Por fim, especifique os detalhes do Alerta. Nomeie e descreva o alerta, atribua um valor de gravidade e especifique se deve criar a regra num estado ativado ou desativado.

Se especificou uma notificação por email, recebe um email de "Microsoft Azure" com o assunto "Azure: Gravidade Ativada: 3 <your rule name>".

Próximos passos

Se ainda não o fez, reveja os fundamentos da monitorização de serviços de pesquisa para conhecer toda a gama de capacidades de supervisão.