Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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,
PT1Mindica que a métrica é amostrada a cada minuto,PT30Ma cada 30 minutos,PT1Ha 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. |
Conteúdo relacionado
- Consulte Monitor Pesquisa de IA do Azure para uma descrição sobre como monitorizar o Pesquisa de IA do Azure.
- Consulte Monitorizar os recursos Azure com Azure Monitor para obter detalhes sobre a monitorização dos recursos Azure.