Referência de dados de Pesquisa de IA do Azure para monitorização

Note

O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.

Este artigo contém toda a informação de referência de monitorização para este serviço.

Consulte Monitor Pesquisa de IA do Azure para detalhes sobre os dados que pode recolher para Pesquisa de IA do Azure e como os utilizar.

Métricas

Esta secção lista todas as métricas de plataforma recolhidas automaticamente para este serviço. Estas métricas também fazem parte da lista global de todas as métricas da plataforma suportadas no Azure Monitor.

Para informações sobre retenção de métricas, consulte Azure Monitor Visão geral das métricas.

Métricas suportadas para Microsoft.Search/searchServices

A tabela seguinte lista as métricas disponíveis para o recurso do tipo Microsoft.Search/searchServices.

  • Todas as colunas podem não estar presentes em todas as tabelas.
  • Algumas colunas podem estar para além da área de visualização da página. Selecione Expandir tabela para ver todas as colunas disponíveis.

Cabeçalhos das tabelas

  • Categoria - O grupo de métricas ou classificação.
  • Metric - O nome de visualização métrico tal como aparece no portal Azure.
  • Nome na API REST - O nome da métrica referido na API REST.
  • Unidade - Unidade de medida.
  • Agregação - O tipo padrão de agregação . Valores válidos: Média (Média), Mínimo (Mínimo), Máximo (Máximo), Total (Soma), Contagem.
  • Dimensões - Dimensões disponíveis para a métrica.
  • Grãos Temporais - Intervalos Os intervalos em que a métrica é amostrada. Por exemplo, PT1M indica que a métrica é amostrada a cada minuto, PT30M a cada 30 minutos, PT1H a cada hora, e assim sucessivamente.
  • DS Export- Se a métrica é exportável para Azure Monitor Logs através das definições de diagnóstico. Para informações sobre exportação de métricas, consulte Criar definições de diagnóstico em Azure Monitor.
Métrica Nome na API REST Métricas avançadas de plataforma Unidade Agregação Dimensões Grãos do Tempo DS Exportação
Ficheiros processados pelo indexador (bytes)

Total de bytes de dados de origem processados pelos indexadores a partir de fontes de dados baseadas em ficheiros (por exemplo, Blob, ADLS Gen2, File, SharePoint, OneLake)
DocumentsProcessedBytes Não Bytes Total (soma), média DataSourceName, IndexerName, IndexName PT1M Sim
Contagem de documentos processados

Número de documentos processados
DocumentsProcessedCount Não Contagem Total (Soma), Contagem DataSourceName, Failed, IndexerName, IndexName, SkillsetName PT1M Sim
Utilização de armazenamento

Utilização de armazenamento (texto + vetor) para o serviço de pesquisa por índice
IndexStorageUsage Não Bytes Média, Máximo, Mínimo IndexName PT1M Sim
Utilização do Armazenamento Vetorial

Utilização de armazenamento vetorial para o serviço de pesquisa por índice
IndexVectorUsage Não Bytes Média, Máximo, Mínimo IndexName PT1M Sim
Unidades de cálculo utilizadas

Unidades de cálculo consumidas pelas operações do serviço de pesquisa e pelas janelas de aquecimento do índice, em micro-CU-horas (divida o total por 1.000.000 para obter CU-horas). O filtro de estado está obsoleto.
PerRequestComputeConsumption Não Contagem Total (soma), média Status, IndexName, ResourceKind, EventType PT1M Sim
Latência de Pesquisa

Latência média de pesquisa para o serviço de pesquisa
SearchLatency Não Segundos Média <nenhum> PT1M Sim
Consultas de pesquisa por segundo

Consultas de pesquisa por segundo realizadas pelo serviço de pesquisa
SearchQueriesPerSecond Não ContagemPorSegundo Média <nenhum> PT1M Sim
Contagem de invocações de ativação de competências

Número de execuções de competências
SkillExecutionCount Não Contagem Total (Soma), Contagem DataSourceName, Failed, IndexerName, SkillName, SkillsetName, SkillType PT1M Sim
Percentagem de consultas de pesquisa limitadas

Percentagem de consultas de pesquisa que foram limitadas para o serviço de pesquisa
ThrottledSearchQueriesPercentage Não Percentagem Média <nenhum> PT1M Sim

Consultas de pesquisa por segundo

Esta métrica mostra a média das consultas de pesquisa por segundo (QPS) para o serviço de pesquisa. É comum que as consultas sejam executadas em milissegundos, por isso só aparecem consultas que medem como segundos numa métrica como o QPS. O mínimo é o valor mais baixo para consultas de pesquisa por segundo registado nesse minuto. O máximo é o valor mais alto. A média é a soma ao longo de todo o minuto.

Tipo de agregação Descrição
Média O número médio de segundos dentro de um minuto durante o qual ocorreu a execução da consulta.
Contagem O número de métricas emitidas para o logaritmo dentro do intervalo de um minuto.
Máximo O maior número de consultas de pesquisa por segundo registado durante um minuto.
Mínimo O menor número de consultas de pesquisa por segundo registado durante um minuto.
Soma A soma de todas as consultas executadas dentro do minuto.

Por exemplo, dentro de um minuto, pode ter um padrão assim: um segundo de carga elevada que é o máximo para o SearchQueriesPerSecond, seguido de 58 segundos de carga média, e finalmente um segundo com apenas uma consulta, que é o mínimo.

Outro exemplo: se um nó emite 100 métricas, onde o valor de cada métrica é 40, então "Contagem" é 100, "Soma" é 4000, "Média" é 40 e "Máximo" é 40.

Latência de pesquisa

A latência de pesquisa indica quanto tempo uma consulta demora a ser concluída.

Tipo de agregação Latência
Média Duração média da consulta em milissegundos.
Contagem O número de métricas emitidas para o logaritmo dentro do intervalo de um minuto.
Máximo A consulta mais longa da amostra.
Mínimo A consulta SQL mais curta em execução na amostra.
Total Tempo total de execução de todas as consultas na amostra, executadas dentro do intervalo (um minuto).

Percentagem de consultas de pesquisa limitadas

Esta métrica refere-se a consultas que são eliminadas em vez de processadas. A limitação ocorre quando o número de pedidos em execução excede a capacidade. Pode observar um aumento nos pedidos limitados quando uma réplica é removida da rotação ou durante a indexação. Tanto os pedidos de consulta como os de indexação são tratados pelo mesmo conjunto de recursos.

O serviço decide se abandona os pedidos com base no consumo de recursos. A percentagem de recursos consumidos em memória, CPU e IO do disco é mediada ao longo de um período de tempo. Se esta percentagem ultrapassar um limiar, todos os pedidos ao índice são limitados até que o volume de pedidos seja reduzido.

Dependendo do seu cliente, um pedido com limitação de velocidade é indicado destas formas:

  • Um serviço devolve um erro "You are sending too many requests. Please try again later."
  • Um serviço devolve um código de erro 503 indicando que o serviço está atualmente indisponível.
  • Se estiveres a usar o portal Azure (por exemplo, o Explorador de Pesquisa), a consulta é descartada silenciosamente e tens de selecionar novamente Pesquisa.

Para confirmar consultas controladas, use a métrica Consultas de Pesquisa Controladas. Pode explorar métricas no portal do Azure ou criar uma métrica de alerta conforme descrito neste artigo. Para consultas que foram eliminadas dentro do intervalo de amostragem, use o Total para obter a percentagem de consultas que não foram executadas.

Tipo de agregação Limitação de velocidade
Média Percentagem de consultas descartadas no intervalo.
Contagem O número de métricas emitidas para o logaritmo dentro do intervalo de um minuto.
Máximo Percentagem de consultas descartadas no intervalo.
Mínimo Percentagem de consultas descartadas no intervalo.
Total Percentagem de consultas descartadas no intervalo.

Para Percentagem de Consultas de Pesquisa Limitadas, mínimo, máximo, média e total, todos têm o mesmo valor: a percentagem de consultas de pesquisa que foram limitadas, do número total de consultas de pesquisa durante um minuto.

Utilização das unidades de cálculo

Esta métrica mede os recursos de computação, memória e I/O consumidos pelo seu serviço Pesquisa de IA do Azure, expressos em milli Compute Units (mCUs). Serve como indicador do custo de processamento de diferentes tipos de operação. O uso pode variar ao longo do tempo dependendo das operações em execução.

Pode visualizar esta métrica em dois níveis:

  • Nível de serviço de pesquisa: Consumo agregado de computação em todo o serviço.
  • Nível de índice: Consumo ajustado a um índice específico, útil para identificar quais os índices que estão a impulsionar o maior consumo de recursos.
Tipo de agregação Descrição
Sum Total de mCUs consumidas durante o intervalo de tempo selecionado. Útil para compreender o custo total de computação ao longo do tempo.
Média Média de mCUs consumidas durante o intervalo de tempo selecionado.

Esta métrica suporta os seguintes filtros:

  • Nome do índice: Filtra a métrica para um índice específico. Se não for aplicado filtro, a métrica reflete o consumo total em todos os índices do serviço.

  • Nome da operação: Filtra a métrica pela operação que contribui para o consumo de cálculo. Se não for aplicado filtro, a métrica reflete o consumo combinado em todos os tipos de operações. Para valores suportados, consulte Referência de Dados de Monitorização.

Dimensões métricas

Para informações sobre o que são dimensões métricas, veja Métricas multidimensionais.

O Pesquisa de IA do Azure tem dimensões associadas às seguintes métricas que capturam a contagem de documentos ou competências executadas.

Nome métrico Descrição Dimensões Exemplos de casos de uso
Contagem de documentos processados Mostra o número de documentos processados pelo indexador. Nome da fonte de dados, erro, nome do índice, nome do indexador, nome do conjunto de competências Pode ser usado como uma medida aproximada do débito (número de documentos processados pelo indexador ao longo do tempo)
- Configurar alertas para documentos com falha
Contagem de invocações de ativação de competências Mostra o número de ativações de capacidades. Nome da fonte de dados, falha, nome do índice, nome do indexador, nome da habilidade, tipo de habilidade, nome do conjunto de habilidades Referência para garantir que as competências são invocadas conforme esperado, comparando os números relativos de invocação entre competências e o número total de invocações com o número de documentos.
- Configurar para alertar em invocações de habilidades falhadas
Utilização das Unidades de Cálculo Mostra as mCUs consumidas pelas operações efetuadas no serviço de pesquisa Nome do índice, Operação Avaliar qual a operação que consumiu mais cálculo.
- Configurar alertas quando o consumo de lodo ultrapassar os limiares esperados para um dado tipo de operação
Nome da dimensão Descrição
DataSourceName Uma ligação de fonte de dados nomeada usada durante a execução do indexador. Os valores válidos são um dos tipos de fonte de dados suportados.
Falhou Indica se a instância falhou.
IndexerName Nome de um indexador.
IndexName Nome de um índice.
Nome do Conjunto de Competências Nome de um conjunto de competências usado durante a execução do indexador.
Nome da Competência Nome de uma competência dentro de um conjunto de competências.
Tipo de Habilidade A @odata.type da competência.

Registos de recursos

Esta secção lista os tipos de registos de recursos que pode recolher para este serviço. A secção baseia-se na lista de todos os tipos de categorias de registos de recursos suportados pelo Azure Monitor.

Registos de recursos suportados para Microsoft.Search/searchServices

Categoria Custos de exportação Tabela de Logaritmos Suporta plano de logs básico Suporta a transformação do tempo de ingestão Exemplos de consultas
Registos de Operação Não AzureDiagnostics

Registos de múltiplos recursos do Azure.

Não Não

Tabelas de Logs do Azure Monitor

Esta secção lista as tabelas Azure Monitor Logs relevantes para este serviço, que estão disponíveis para consulta pela Log Analytics usando consultas Kusto. As tabelas contêm dados de registo de recursos e possivelmente mais, dependendo do que é recolhido e encaminhado para elas.

Serviços de Pesquisa

Microsoft.Search/searchServices

Tabela Descrição
AzureActivity Entradas do registo de atividades do Azure fornecem informações sobre as operações do plano de controlo. As tarefas invocadas no plano de controlo, como adicionar ou remover réplicas e partições, são representadas através de uma atividade chamada "Obter Chave de Administrador".
AzureDiagnostics Consultas registadas e operações de indexação. Consultas contra a tabela AzureDiagnostics em Log Analytics podem incluir as propriedades comuns, as propriedades específicas search e as operações específicas search listadas na secção de referência de esquemas.
AzureMetrics Dados métricos emitidos pelo Pesquisa de IA do Azure que medem a saúde e o desempenho.

Tabelas de registos de recursos

A tabela seguinte lista as propriedades dos registos de recursos no Pesquisa de IA do Azure. Os registos de recursos são recolhidos no Azure Monitor Logs ou no Armazenamento do Azure. Em Azure Monitor, os registos são recolhidos na tabela AzureDiagnostics sob o nome do fornecedor de recursos Microsoft.Search.

Campo ou propriedade do Armazenamento do Azure Propriedade dos Registos do Azure Monitor Descrição
Tempo MARCA TEMPORAL A data e hora (UTC) em que a operação ocorreu.
resourceId Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) O recurso Pesquisa de IA do Azure para o qual os registos estão ativados.
categoria "OperationLogs" As categorias de registos incluem Audit, Operational, Execution, e Request.
operationName Nome Nome da operação. O nome da operação pode ser Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Indexers.ListQuery.Search, Query.Suggest, Query.Lookup, Query.Autocomplete, CORS.Preflight, . Indexes.UpdateIndexes.PrototypeServiceStatsDataSources.ListIndexers.Warmup
duração em milissegundos DuraçãoMilissegundos A duração da operação, em milissegundos.
Versão da Operação ApiVersion A versão da API usada no pedido.
tipoDeResultado (Falhou) ? "Falhado" : "Sucesso" O tipo de resposta.
assinaturaResultado Estado O estado da resposta HTTP da operação.
Propriedades Propriedades Quaisquer propriedades estendidas relacionadas com esta categoria de eventos.

Registo de atividade

A tabela ligada lista as operações que podem ser registadas no registo de atividades deste serviço. Estas operações são um subconjunto de todas as possíveis operações de fornecedores de recursos no registo de atividade.

Para mais informações sobre o esquema das entradas do registo de atividade, consulte Esquema do Registo de Atividades.

A tabela seguinte lista operações comuns relacionadas com o Pesquisa de IA do Azure que podem ser registadas no registo de atividades. Para uma lista completa de todas as operações da Microsoft.Search, consulte as operações do provedor de recursos Microsoft.Search.

Funcionamento Descrição
Obter Chave de Administração Qualquer operação que exija direitos administrativos é registada como uma operação "Obter Chave de Administrador".
Obter Chave de Consulta Qualquer operação de apenas leitura sobre a coleção de documentos de um índice.
Regenerar Chave de Administrador Um pedido para regenerar a chave API de administrador primária ou secundária.

Entradas comuns incluem referências a chaves API – notificações informativas genéricas como Obter Chave de Administração e Obter Chaves de Consulta. Estas atividades indicam pedidos feitos usando a chave de administração (criar ou eliminar objetos) ou a chave de consulta, mas não mostram o pedido em si. Para obter informações sobre este tipo de grão, deve configurar o registo de recursos.

Alternativamente, pode obter algum conhecimento através da história das mudanças. No portal Azure, selecione a atividade para abrir a página de detalhes e depois selecione "Alterar histórico" para obter informações sobre a operação subjacente.

Outros esquemas

Os seguintes esquemas são utilizados para este serviço.

Se estiver a construir consultas ou relatórios personalizados, as estruturas de dados que contêm os registos de recursos do Pesquisa de IA do Azure cumprem os seguintes esquemas.

Para registos de recursos enviados para armazenamento de blobs, cada blob tem um objeto raiz chamado registos contendo um array de objetos de log. Cada blob contém registos de todas as operações que ocorreram durante a mesma hora.

Esquema do registo de recursos

Todos os registos de recursos disponíveis através de Azure Monitor partilham um esquema comum de topo de nível. Pesquisa de IA do Azure complementa com mais propriedades e operações que são exclusivas de um serviço de pesquisa.

O exemplo seguinte ilustra um registo de recursos que inclui propriedades comuns (TimeGenerated, Resource, Category, etc.) e propriedades específicas de pesquisa (OperationName e OperationVersion).

Nome Tipo Descrição e exemplo
TimeGenerated Data e hora Carimbo temporal da operação. Por exemplo: 2021-12-07T00:00:43.6872559Z
Recurso Corda ID de recurso. Por exemplo: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Categoria Corda "OperationLogs". Este valor é uma constante. OperationLogs é a única categoria usada para registos de recursos.
NomeDaOperação Corda O nome da operação (ver a lista completa de operações). Um exemplo é Query.Search
Versão de Operação Corda A versão da API usada no pedido. Por exemplo: 2026-04-01
TipoDeResultado Corda "Sucesso". Outros valores possíveis: Sucesso ou Fracasso
AssinaturaResultado Int Um código de resultado HTTP. Por exemplo: 200
DuraçãoMS Int Duração da operação em milissegundos.
Propriedades Objetivo Objeto contendo dados específicos da operação. Veja a seguinte tabela de esquemas de propriedades.

Esquema de propriedades

As seguintes propriedades são específicas do Pesquisa de IA do Azure.

Nome Tipo Descrição e exemplo
Descrição Corda O ponto final da operação. Por exemplo: GET /indexes('content')/docs
Documents_d Int Número de documentos processados.
IndexName_s Corda Nome do índice associado à operação.
Query_s Corda Os parâmetros de consulta usados no pedido. Por exemplo: ?search=beach access&$count=true&api-version=2026-04-01

Os valores de OperationName (operações registadas)

As seguintes operações podem aparecer num registo de recursos.

NomeDaOperação Descrição
DataSources.* Aplica-se a fontes de dados do indexador. Pode ser Criar, Eliminar, Obter, Listar.
DebugSessions.* Aplica-se a uma sessão de depuração. Pode ser Criar, Eliminar, Obter, Listar, Iniciar e Estado.
DebugSessions.DocumentStructure Um documento enriquecido é carregado numa sessão de depuração.
DebugSessions.RetrieveIndexerExecutionHistoricalData Solicitação de detalhes da execução do indexador.
DebugSessions.ObterDadosHistóricosDeExecuçãoDoIndexadorProjetado Histórico de execução dos enriquecimentos projetados para um repositório de conhecimento.
Indexadores.* Aplica-se a um indexador. Pode ser Criar, Eliminar, Obter, Listar e Status.
Índices.* Aplica-se a um índice de pesquisa. Pode ser Criar, Eliminar, Obter, Listar.
índices. Protótipo Os metadados do índice são definidos pelo assistente de importação de dados com base nas entradas de dados.
Indexação.Índice Esta operação é uma chamada para Indexar Documentos.
Metadata.GetMetadata Um pedido de dados do sistema de serviço de busca.
Query.Autocomplete Uma consulta de autopreenchimento sobre um índice. Ver Tipos de consulta e composição.
Query.Lookup Uma consulta num índice. Ver Tipos de consulta e composição.
Query.Search Pedido de pesquisa por texto completo sobre um índice. Ver Tipos de consulta e composição.
Pergunta. Sugestão Digite uma consulta antecipada contra um índice. Ver Tipos de consulta e composição.
ServiceStats Esta operação é uma chamada rotineira para obter Estatísticas de Serviço, chamada diretamente ou implicitamente para preencher uma página de visão geral do portal quando esta é carregada ou atualizada.
Competências.* Aplica-se a um conjunto de competências. Pode ser Criar, Eliminar, Obter, Listar.