Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Note
Pesquisa de IA do Azure está disponível por meio do portal Azure, APIs REST e SDKs do Azure. Ele também sustenta o IQ do Foundry, a camada de conhecimento gerenciado que transforma o conteúdo da empresa em bases de conhecimento reutilizáveis e com reconhecimento de permissão para agentes no portal do Microsoft Foundry.
Este artigo contém todas as informações de referência de monitoramento para este serviço.
Consulte Monitor Pesquisa de IA do Azure para obter detalhes sobre os dados que você pode coletar para Pesquisa de IA do Azure e como usá-los.
Métricas
Esta seção lista todas as métricas coletadas automaticamente pela plataforma para esse serviço. Essas métricas também fazem parte da lista global de todas as métricas de plataformas suportadas no Azure Monitor.
Para informações sobre retenção de métricas, veja Azure Monitor Visão geral das métricas.
Métricas suportadas para Microsoft Search/searchServices
A tabela a seguir lista as métricas disponíveis para o recurso Microsoft.Search/searchServices.
- Nem todas as colunas podem estar presentes em todas as tabelas.
- Algumas colunas podem estar além da área de visualização da página. Selecione Expandir tabela para ver todas as colunas disponíveis.
Títulos de tabela
- Categoria - O grupo ou classificação de métricas.
- Metric - O nome de exibição da métrica conforme aparece no portal do Azure.
- Nome na API REST - O nome da métrica referido na API REST.
- Unidade - Unidade de medida.
- Agregação - O tipo de agregação padrã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.
-
Granularidade de Tempo - Intervalos nos quais a métrica é amostrada. Por exemplo,
PT1Mindica que a métrica é amostrada a cada minuto,PT30Ma cada 30 minutos,PT1Ha cada hora, e assim por diante. - DS Export- Se a métrica pode ser exportada para Azure Monitor Logs via configurações de diagnóstico. Para informações sobre exportação de métricas, veja Criar configurações de diagnóstico em Azure Monitor.
| Métrica | Nome na API REST | Métricas avançadas da plataforma | Unidade | Agregação | Dimensões | Intervalos de tempo | Exportação de DS |
|---|---|---|---|---|---|---|---|
|
Arquivos processados do indexador (bytes) Total de bytes de dados de origem processados por indexadores da fonte de dados baseada em arquivo (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, , IndexNameSkillsetName |
PT1M | Sim |
|
Uso do armazenamento Uso de armazenamento (texto + vetor) para o serviço de pesquisa por índice |
IndexStorageUsage |
Não | Bytes | Médio, Máximo, Mínimo | IndexName |
PT1M | Sim |
|
Uso do Armazenamento vetor Uso de armazenamento vetor para o serviço de pesquisa por índice |
IndexVectorUsage |
Não | Bytes | Médio, Máximo, Mínimo | IndexName |
PT1M | Sim |
|
Unidades de computação usadas Unidades de computação consumidas pelas operações do serviço de busca e janelas ativas do índice, em micro-horas de UC (divida o total por 1.000.000 para obter as horas de UC). O filtro de status foi preterido. |
PerRequestComputeConsumption |
Não | Contagem | Total (Soma), Média |
Status, IndexName, , ResourceKindEventType |
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 busca por segundo Consultas de pesquisa por segundo para o serviço de busca |
SearchQueriesPerSecond |
Não | ContagemPorSegundo | Média | <nenhum> | PT1M | Sim |
|
Contagem de invocação de execução de habilidades Número de realizações de habilidades |
SkillExecutionCount |
Não | Contagem | Total (Soma), Contagem |
DataSourceName, Failed, IndexerName, SkillName, , SkillsetNameSkillType |
PT1M | Sim |
|
Percentual de consultas de pesquisa limitadas Percentual de consultas de pesquisa que eram limitadas para o serviço de pesquisa |
ThrottledSearchQueriesPercentage |
Não | Por cento | Média | <nenhum> | PT1M | Sim |
Pesquisar consultas por segundo
Essa métrica mostra a média das consultas de pesquisa por segundo (QPS) para o serviço de pesquisa. É comum que consultas sejam executadas em milissegundos, portanto, somente consultas que medem como segundos aparecem em uma métrica como QPS. O mínimo é o valor mais baixo para consultas de pesquisa por segundo que foi registrado durante esse minuto. Máximo é o valor mais alto. A média é a agregação de todo o minuto.
| Tipo de agregação | Descrição |
|---|---|
| Média | O número médio de segundos em um minuto durante o qual ocorreu a execução da consulta. |
| Contagem | O número de métricas emitidas para o log dentro do intervalo de um minuto. |
| Máximo | O número mais alto de consultas de pesquisa por segundo registradas durante um minuto. |
| Mínimo | O menor número de consultas de pesquisa por segundo registradas durante um minuto. |
| Soma | A soma de todas as consultas executadas dentro do minuto. |
Por exemplo, em um minuto, você pode ter um padrão como este: um segundo de carga alta que é o máximo para SearchQueriesPerSecond, seguido por 58 segundos de carga média e, por fim, um segundo com apenas uma consulta, que é o mínimo.
Outro exemplo: se um nó emitir 100 métricas, em que o valor de cada métrica é 40, "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 leva para 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 log dentro do intervalo de um minuto. |
| Máximo | Consulta de execução mais longa no exemplo. |
| Mínimo | Consulta de execução mais curta no exemplo. |
| Total | Tempo total de execução de todas as consultas na amostra, durante o intervalo (um minuto). |
Porcentagem das consultas de pesquisa limitadas
Essa métrica refere-se a consultas que são descartadas em vez de processadas. A limitação ocorre quando o número de solicitações em execução excede a capacidade. Você pode ver um aumento nas solicitações limitadas quando uma réplica é retirada da rotação ou durante a indexação. As solicitações de consulta e indexação são tratadas pelo mesmo conjunto de recursos.
O serviço determina se as solicitações devem ser suspensas com base no consumo de recursos. A porcentagem de recursos consumidos em memória, CPU e E/S de disco são calculadas por meio de um período de tempo. Se esse percentual exceder um limite, todas as solicitações para o índice serão limitadas até que o volume de solicitações seja reduzido.
Dependendo do seu cliente, uma solicitação limitada é indicada das seguintes maneiras:
- Um serviço retorna um erro
"You are sending too many requests. Please try again later." - Um serviço retorna um código de erro 503 indicando que o serviço está indisponível no momento.
- Se você estiver usando o portal Azure (por exemplo, Gerenciador de Pesquisa), a consulta será removida silenciosamente e você precisará selecionar Search novamente.
Para confirmar consultas limitadas, utilize a métrica de consultas de pesquisa restringidas. Você pode explorar as métricas no portal Azure ou criar uma métrica de alerta, conforme descrito neste artigo. Para consultas que foram descartadas dentro do intervalo de amostragem, use Total para obter o percentual de consultas que não foram executadas.
| Tipo de agregação | Limitação |
|---|---|
| Média | Percentual de consultas descartadas dentro do intervalo. |
| Contagem | O número de métricas emitidas para o log dentro do intervalo de um minuto. |
| Máximo | Percentual de consultas descartadas dentro do intervalo. |
| Mínimo | Percentual de consultas descartadas dentro do intervalo. |
| Total | Percentual de consultas descartadas dentro do intervalo. |
Para o Percentual de Consultas de Pesquisa Limitada, mínimo, máximo, médio e total, todos têm o mesmo valor: o percentual de consultas de pesquisa que foram limitadas, do número total de consultas de pesquisa durante um minuto.
Uso de unidades de computação
Essa métrica mede os recursos de computação, memória e E/S consumidos pelo serviço Pesquisa de IA do Azure , expressos em mCUs (unidades de computação milimétricas). Isso serve como um indicador do custo de processamento dos diferentes tipos de operação. O uso pode variar ao longo do tempo, dependendo das operações que estão sendo executadas.
Você pode exibir essa métrica em dois níveis:
- Nível de serviço de pesquisa: consumo de computação agregado em todo o serviço.
- Nível de índice: consumo com escopo para um índice específico, útil para identificar quais índices estão impulsionando o maior uso de recursos.
| Tipo de agregação | Descrição |
|---|---|
| Soma | Total de mCUs consumidos durante o intervalo de tempo selecionado. Útil para entender o custo geral da computação ao longo do tempo. |
| Média | Média de mCUs consumidas durante o intervalo de tempo selecionado. |
Essa métrica dá suporte aos seguintes filtros:
Nome do índice: filtra a métrica para um índice específico. Se nenhum filtro for aplicado, a métrica refletirá o consumo total em todos os índices no serviço.
Nome da operação: filtra a métrica pela operação que contribui para o consumo de computação. Se nenhum filtro for aplicado, a métrica refletirá o consumo combinado em todos os tipos de operação. Para obter valores com suporte, consulte Referência de Dados de Monitoramento.
Dimensões métricas
Para informações sobre o que são dimensões métricas, veja Métricas multidimensionais.
Pesquisa de IA do Azure tem dimensões associadas às seguintes métricas que capturam uma contagem de documentos ou habilidades que foram executadas.
| Nome da métrica | 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, falha, nome do índice, nome do indexador, nome do conjunto de habilidades | Pode ser referenciado como uma medida aproximada de taxa de transferência (número de documentos processados pelo indexador ao longo do tempo) - Configurar para alertar sobre documentos com falha |
| Contagem de invocação de execução de habilidades | Mostra o número de invocações de habilidades. | Nome da fonte de dados, falha, nome do índice, nome do indexador, nome da habilidade, tipo da habilidade, nome do conjunto de habilidades | Referência para garantir que as habilidades sejam invocadas conforme o esperado, comparando números de invocações relativos entre habilidades e o número de invocação de habilidades com o número de documentos. – Configurar para alertar sobre invocações de habilidades com falha |
| Uso de unidades de computação | Exibe as mCUs consumidas pelas operações no serviço de busca | Nome do índice, Operação | Avalie qual operação consumiu mais computação. -Configurar alertas quando o consumo de sujeira excede os limites esperados para um determinado tipo de operação |
| Nome da dimensão | Descrição |
|---|---|
| Datasourcename | Uma conexã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 com suporte. |
| Falhou | Indica se a instância falhou. |
| Indexername | Nome de um indexador. |
| Indexname | Nome de um índice. |
| SkillsetName | Nome de um conjunto de habilidades usado durante a execução do indexador. |
| SkillName | Nome de uma habilidade dentro de um conjunto de habilidades. |
| SkillType | O @odata.type da habilidade. |
Logs de recursos
Esta seção lista os tipos de registros de recursos que você pode coletar para esse serviço. A seção extrai da lista de todos os tipos de categoria de logs de recursos com suporte no Azure Monitor.
Logs de recursos compatíveis para Microsoft.Search/searchServices
| Categoria | Custos de exportação | Tabela de log | Com suporte a plano de log básico | Suporta transformação durante a ingestão | Consultas de exemplo |
|---|---|---|---|---|---|
| OperationLogs | Não |
AzureDiagnostics Logs de vários recursos do Azure. |
Não | Não |
Tabelas de Logs do Azure Monitor
Esta seção lista as tabelas de Azure Monitor Logs relevantes para este serviço, que estão disponíveis para consulta pelo Log Analytics usando consultas Kusto. As tabelas contêm dados de log de recursos e possivelmente mais, dependendo do que é coletado e roteado para elas.
Serviços de Pesquisa
Microsoft.Search/searchServices
| Tabela | Descrição |
|---|---|
| AzureActivity | As entradas do log de atividades Azure fornecem informações sobre as operações do plano de controle. As tarefas invocadas no plano de controle, como adicionar ou remover réplicas e partições, são representadas por meio de uma atividade "Obter Chave de Administração". |
| AzureDiagnostics | Operações de consulta e indexação registradas. As consultas na tabela AzureDiagnostics no Log Analytics podem incluir as propriedades comuns, as propriedades específicas de pesquisa e as operações específicas de pesquisa listadas na seção de referência de esquema. |
| AzureMetrics | Dados de métrica emitidos pela IA do Azure Search que medem a integridade e o desempenho. |
Tabelas de log de recursos
A tabela a seguir lista as propriedades dos logs de recursos no Pesquisa de IA do Azure . Os registros de recursos são coletados nos Logs do Azure Monitor ou no Armazenamento do Azure. No Azure Monitor, os logs são coletados na tabela AzureDiagnostics no provedor de recursos denominado Microsoft.Search.
| Armazenamento do Azure campo ou propriedade | Propriedade de Logs do Azure Monitor | Descrição |
|---|---|---|
| Tempo | TIMESTAMP | 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 logs estão habilitados. |
| categoria | "OperationLogs" | As categorias de log 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.List, Query.Search, Query.Suggest, Query.Lookup, Query.Autocomplete, CORS.Preflight, , Indexes.Update, Indexes.Prototype, , ServiceStats, , DataSources.List, . Indexers.Warmup |
| durationMS | DuraçãoEmMilissegundos | A duração da operação, em milissegundos. |
| operationVersion | ApiVersion | A versão da API usada na solicitação. |
| TipoDeResultado | (Falha) ? "Falha" : "Êxito" | O tipo de resposta. |
| resultSignature | Status | O status de resposta HTTP da operação. |
| Propriedades | Propriedades | As propriedades estendidas relacionadas a essa categoria de eventos. |
Log de atividades
A tabela vinculada lista as operações que podem ser registradas no registro de atividades desse serviço. Essas operações são um subconjunto de todas as possíveis operações de provedores de recursos no registro de atividade.
Para mais informações sobre o esquema das entradas do registro de atividade, veja Esquema do Registro de Atividades.
A tabela a seguir lista operações comuns relacionadas a Pesquisa de IA do Azure que podem ser registradas no log de atividades. Para obter uma listagem completa de todas as operações do Microsoft.Search, consulte operações de provedor de recursos do Microsoft.Search.
| Operação | Descrição |
|---|---|
| Obter Chave de Administração | Qualquer operação que exija direitos administrativos é registrada como uma operação "Obter Chave de Administração". |
| Obter chave de consulta | Qualquer operação somente leitura na coleção de documentos de um índice. |
| Regenerar Chave de Administração | Uma solicitação para regenerar a chave de API de administração primária ou secundária. |
As entradas comuns incluem referências a chaves de API – notificações informativas genéricas, como Obter Chave de Administrador e Obter Chaves de Consulta. Essas atividades indicam solicitações feitas usando a chave de administrador (criar ou excluir objetos) ou a chave de consulta, mas não mostram a solicitação em si. Para obter informações sobre essa granularidade, configure o log de recursos.
Como alternativa, você pode obter algumas informações por meio do histórico de alterações. No portal Azure, selecione a atividade para abrir a página de detalhes e selecione "Histórico de alterações" para obter informações sobre a operação subjacente.
Outros esquemas
Os esquemas a seguir estão em uso para este serviço.
Se você estiver criando consultas ou relatórios personalizados, as estruturas de dados que contêm os logs de recursos do Pesquisa de IA do Azure estão em conformidade com os esquemas a seguir.
Para os logs de recursos enviados ao armazenamento de blobs, cada blob tem um objeto-raiz chamado registros que contém uma matriz de objetos de log. Cada blob contém registros para todas as operações que ocorreram durante a mesma hora.
Esquema de log de recursos
Todos os logs de recursos disponíveis por meio do Azure Monitor compartilham um esquema comum de nível superior. Pesquisa de IA do Azure complementa com mais propriedades e operações exclusivas de um serviço de pesquisa.
O exemplo a seguir ilustra um log de recursos que inclui propriedades comuns (TimeGenerated, Resource, Category e assim por diante) e propriedades específicas da pesquisa (OperationName e OperationVersion).
| Nome | Tipo | Descrição e exemplo |
|---|---|---|
| TimeGenerated | Data e Hora | Carimbo de data/hora da operação. Por exemplo: 2021-12-07T00:00:43.6872559Z |
| Recurso | String | ID do recurso. Por exemplo: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| Categoria | String | "OperationLogs". Esse valor é uma constante. OperationLogs é a única categoria usada para logs de recursos. |
| OperationName | String | O nome da operação (consulte a lista completa de operações). Um exemplo é Query.Search |
| VersãoDaOperação | String | A versão da API usada na solicitação. Por exemplo: 2026-04-01 |
| TipoDeResultado | String | "Sucesso". Outros valores possíveis: Êxito ou falha |
| ResultSignature | Int | Um código de resultado HTTP. Por exemplo: 200 |
| DurationMS | Int | Duração da operação em milissegundos. |
| Propriedades | Objeto | Objeto que contém dados específicos da operação. Consulte a tabela de esquema de propriedades a seguir. |
Esquema de propriedades
As propriedades a seguir são específicas para Pesquisa de IA do Azure .
| Nome | Tipo | Descrição e exemplo |
|---|---|---|
| Descrição | String | O ponto de extremidade da operação. Por exemplo: GET /indexes('content')/docs |
| Documentos_d | Int | Número de documentos processados. |
| IndexName_s | String | Nome do índice associado à operação. |
| Consulta(s) | String | Os parâmetros de consulta usados na solicitação. Por exemplo: ?search=beach access&$count=true&api-version=2026-04-01 |
Valores de OperationName (operações registradas em log)
As operações a seguir podem aparecer em um log de recursos.
| OperationName | Descrição |
|---|---|
| DataSources.* | Aplica-se a fontes de dados do indexador. Pode ser Criar, Excluir, Obter, Listar. |
| DebugSessions.* | Aplica-se a uma sessão de depuração. Pode ser Create, Delete, Get, List, Start e Status. |
| DebugSessions.DocumentStructure | Um documento enriquecido é carregado em uma sessão de depuração. |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | Uma solicitação para detalhes de execução do indexador. |
| SessõesDeDepuração.RecuperarDadosHistóricosDeExecuçãoDoIndexadorProjetado | Histórico de execução para enriquecimentos projetados de um armazenamento de conhecimento. |
| Indexadores.* | Aplica-se a um indexador. Pode ser Create, Delete, Get, List e Status. |
| Índices.* | Aplica-se a um índice de pesquisa. Pode ser Criar, Excluir, Obter, Listar. |
| indexes.Prototype | Os metadados de índice são definidos pelo assistente de importação de dados com base em entradas de dados. |
| Indexing.Index | Esta operação é uma chamada para Documentos de Índice. |
| Metadata.GetMetadata | Uma solicitação de dados do sistema de serviço de pesquisa. |
| Query.Autocomplete | Uma consulta de preenchimento automático em relação a um índice. Consulte os tipos de consulta e a composição. |
| Query.Lookup | Uma consulta de pesquisa em relação a um índice. Consulte os tipos de consulta e a composição. |
| Consulta.Pesquisa | Uma solicitação de pesquisa de texto completo em um índice. Consulte os tipos de consulta e a composição. |
| Query.Suggest | Preenchimento automático de consulta em um índice. Consulte os tipos de consulta e a composição. |
| ServiceStats | Essa operação é uma chamada de rotina para obter estatísticas de serviço, é chamada direta ou implicitamente para preencher uma página de visão geral do portal quando ela é carregada ou atualizada. |
| Conjuntos de habilidades.* | Aplica-se a um conjunto de habilidades. Pode ser Criar, Excluir, Obter, Listar. |
Conteúdo relacionado
- Consulte Monitor Pesquisa de IA do Azure para obter uma descrição do monitoramento Pesquisa de IA do Azure .
- Veja Monitorar os recursos do Azure com o Azure Monitor para detalhes sobre o monitoramento de recursos do Azure.