Referência de dados de monitoramento da Pesquisa de IA do Azure
Este artigo contém todas as informações de referência de monitoramento para este serviço.
Consulte Monitorar o Azure AI Search para obter detalhes sobre os dados que você pode coletar para o Azure AI Search e como usá-los.
Métricas
Esta seção lista todas as métricas da plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas da plataforma com suporte no Azure Monitor.
Para obter informações sobre retenção de métricas, consulte Visão geral das métricas do Azure Monitor.
Métricas com suporte para Microsoft.Search/searchServices
A tabela a seguir lista as métricas disponíveis para o tipo de 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 exibir todas as colunas disponíveis.
Títulos de tabela
- Categoria: o grupo ou classificação de métricas.
- Métrica: o nome de exibição da métrica como aparece no portal do Azure.
- Nome na API REST: o nome da métrica, conforme mencionado na API REST.
- Unidade: unidade de medida
- Agregação: o tipo de agregação padrão. Valores válidos: Médio (Méd.), Mínimo (Mín.), Máximo (Máx.), Total (Soma), Contagem.
- Dimensões: as Dimensões disponíveis para a métrica.
- Intervalos de agregação: 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 por diante. - Exportação de DS: se a métrica é exportável para os Logs do Azure Monitor via configurações de diagnóstico. Para obter mais informações sobre exportação de métricas, consulte as Criar configurações de diagnóstico no Azure Monitor.
| Métrica | Nome na API REST | Unidade | Agregação | Dimensões | Granularidade de tempo | Exportação de DS |
|---|---|---|---|---|---|---|
| Contagem de documentos processados Número de documentos processados |
DocumentsProcessedCount |
Count | Total (Soma), Contagem | DataSourceName, Failed, IndexerName, IndexName, SkillsetName |
PT1M | Sim |
| Latência de pesquisa Latência média de pesquisa do serviço de pesquisa |
SearchLatency |
Segundos | Média | <none> | PT1M | Sim |
| Consultas de pesquisa por segundo Consultas de pesquisa por segundo para o serviço de pesquisa |
SearchQueriesPerSecond |
CountPerSecond | Média | <none> | PT1M | Sim |
| Contagem de invocação de execução de habilidade Número de execuções de habilidade |
SkillExecutionCount |
Count | Total (Soma), Contagem | DataSourceName, Failed, IndexerName, SkillName, SkillsetName, , SkillType |
PT1M | Sim |
| Porcentagem de consultas de pesquisa limitadas Porcentagem de consultas de pesquisa que eram limitadas para o serviço de pesquisa |
ThrottledSearchQueriesPercentage |
Porcentagem | Média | <none> | PT1M | Sim |
Consultas de pesquisa por segundo
Essa 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, portanto, apenas as 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 registrado durante esse minuto. Maximum é 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 a execução da consulta ocorreu. |
| 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 número mais baixo de consultas de pesquisa por segundo registradas durante um minuto. |
| Somar | A soma de todas as consultas executadas dentro do minuto. |
Por exemplo, dentro de um minuto, é possível ver um padrão como este: um segundo com uma carga muito alta, que é o valor máximo para SearchQueriesPerSecond, seguido de 58 segundos de carga mediana, e, por fim, um segundo com apenas uma consulta, que será o valor mínimo.
Outro exemplo: se um nó emite 100 métricas, em que o valor de cada métrica é 40, "Count" é 100, "Sum" é 4000, "Average" é 40 e "Max" é 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 no exemplo, executando dentro do 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 descartadas 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 essa porcentagem 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 do Azure (por exemplo, Gerenciador de Pesquisa), a consulta será descartada silenciosamente e você precisará selecionar Pesquisar novamente.
Para confirmar as consultas limitadas, use a métrica de Consultas de pesquisa limitada. Você pode explorar métricas no portal do Azure ou criar uma métrica de alerta, conforme descrito neste artigo. Para as consultas que foram descartadas dentro do intervalo de amostragem, use Total para obter a porcentagem de consultas que não foram executadas.
| Tipo de agregação | Limitação |
|---|---|
| Média | Porcentagem 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 | Porcentagem de consultas descartadas dentro do intervalo. |
| Mínimo | Porcentagem de consultas descartadas dentro do intervalo. |
| Total | Porcentagem de consultas descartadas dentro do intervalo. |
Para Porcentagem de consultas de pesquisa limitadas, os valores mínimo, máximo, médio e total são o mesmo: a porcentagem de consultas de pesquisa que foram limitadas, a partir do no número total de consultas de pesquisa durante um minuto.
Dimensões de métrica
Para obter mais informações sobre o que são dimensões de métrica, confira Métricas multidimensionais.
O Azure AI Search tem dimensões associadas às métricas a seguir que capturam uma contagem de documentos ou habilidades que foram executadas.
| Nome da métrica | Descrição | Dimensões | Casos de uso de exemplo |
|---|---|---|---|
| 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 habilidade | 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 os números de invocação relativos entre as habilidades e o número de invocações de habilidade com o número de documentos. – Configurar para alertar sobre invocações de habilidades com falha |
| Nome da dimensão | Descrição |
|---|---|
| DataSourceName | Uma conexão de fonte de dados nomeada que é usada durante a execução do indexador. Os valores válidos são um dos tipos de fontes de dados compatíveis. |
| Com falha | 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 de um conjunto de habilidades. |
| SkillType | O @odata.type da habilidade. |
Logs de recursos
Esta seção lista os tipos de logs de recursos que você pode coletar para o este 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 com suporte para Microsoft.Search/searchServices
| Categoria | Nome de exibição da categoria | Tabela de log | Com suporte a plano de log básico | Com suporte a transformações de tempo-ingestão | Consultas de exemplo | Custos para exportar |
|---|---|---|---|---|---|---|
OperationLogs |
Logs de operação | AzureDiagnostics Logs de vários recursos do Azure. |
Não | No | No |
Tabelas de Logs do Azure Monitor
Esta seção lista todas as tabelas dos Logs do Azure Monitor relevantes para este serviço e disponíveis para consulta pela análise de logs usando o 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 do Azure fornecem informações sobre as operações do painel de controle. As tarefas invocadas no painel 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 registradas de consulta e indexação. 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 Azure AI Search. Os logs de recursos são coletados em logs do Azure Monitor ou no Armazenamento do Microsoft Azure. No Azure Monitor, os logs são coletados na tabela AzureDiagnostics com o nome do provedor de recursos .Microsoft.Search
| Propriedade ou campo de Armazenamento do Microsoft Azure | Propriedade de logs do Azure Monitor | Descrição |
|---|---|---|
| time | 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 do Azure AI Search para o qual os logs estão habilitados. |
| categoria | "OperationLogs" | As categorias de log incluem Audit, Operational, Executione Request. |
| operationName | Nome | Nome da operação. O nome da operação pode ser Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Query.SearchQuery.SuggestServiceStatsDataSources.ListIndexers.ListQuery.AutocompleteIndexers.WarmupQuery.LookupCORS.PreflightIndexes.UpdateIndexes.Prototype, . |
| durationMS | DuraçãoMilissegundos | A duração da operação em milissegundos. |
| operationVersion | ApiVersion | A versão da API usada na solicitação. |
| resultType | (Falhou)? "Falha" : "Sucesso" | O tipo de resposta. |
| resultSignature | Status | O status de resposta HTTP da operação. |
| properties | 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 log de atividades desse serviço. Essas operações são um subconjunto de todas as operações do provedor de recursos possíveis no log de atividades.
Para obter mais informações sobre o esquema de entradas do log de atividades, confira Esquema do log de atividades.
A tabela a seguir lista as operações comuns relacionadas ao Azure AI Search que podem ser registradas no log de atividades. Para obter uma lista completa de todas as operações Microsoft.Search, consulte Operações do provedor de recursos Microsoft.Search.
| Operação | Descrição |
|---|---|
| Obter a chave de administrador | Qualquer operação que exija direitos administrativos é registrada como uma operação "Obter Chave de Administração". |
| Obter a 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 gerar novamente a chave de API de administrador primária ou secundária. |
As entradas comuns incluem referências a chaves de API – notificações informativas genéricas, como Obter Chave de Administração e Obter Chaves de Consulta. Essas atividades indicam solicitações que foram 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, é possível obter insights por meio do histórico de alterações. No portal do Azure, selecione a atividade para abrir a página de detalhes e, em seguida, 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 logs de recursos do Azure AI Search estarã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 de todas as operações que ocorreram durante a mesma hora.
Esquemas de log de recursos
Todos os logs de recursos disponíveis por meio do Azure Monitor compartilham um esquema de nível superior comum. O Azure AI Search 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 de pesquisa (OperationName e OperationVersion).
| Nome | Tipo | Descrição e exemplo |
|---|---|---|
| TimeGenerated | Datetime | 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. |
| OperationVersion | String | A versão da API usada na solicitação. Por exemplo: 2024-07-01 |
| ResultType | String | "Success". Outros valores possíveis: Success ou Failure |
| 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 os 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 do Azure AI Search.
| Nome | Tipo | Descrição e exemplo |
|---|---|---|
| Description_s | String | O ponto de extremidade da operação. Por exemplo: GET /indexes('content')/docs |
| Documents_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=2024-07-01 |
Valores de OperationName (operações registradas)
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 Create, Delete, Get e List. |
| 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 de detalhes de execução do indexador. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | Histórico de execução para enriquecimentos projetados de um armazenamento de conhecimento. |
| Indexers.* | Aplica-se a um indexador. Pode ser Create, Delete, Get, List e Status. |
| Indexes.* | Aplica-se a um índice de pesquisa. Pode ser Create, Delete, Get e List. |
| indexes.Prototype | Esse índice é criado pelo assistente Importar Dados. |
| Indexação de cadeias de caracteres | Essa operação é uma chamada para indexar documentos. |
| Metadata.GetMetadata | Uma solicitação de dados do sistema do serviço de pesquisa. |
| Query.Autocomplete | Uma consulta de preenchimento automático em um índice. Confira Tipos de consulta e composição. |
| Query.Lookup | Uma consulta de pesquisa em um índice. Confira Tipos de consulta e composição. |
| Query.Search | Uma solicitação de pesquisa de texto completo em um índice. Confira Tipos de consulta e composição. |
| Query.Suggest | Preenchimento automático de consulta em um índice. Confira Tipos de consulta e 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. |
| Skillsets.* | Aplica-se a um conjunto de habilidades. Pode ser Create, Delete, Get e List. |
Conteúdo relacionado
- Consulte Monitorar o Azure AI Search para obter uma descrição do monitoramento do Azure AI Search.
- Confira Monitorar recursos do Azure com o Azure Monitor para ver informações detalhadas sobre o monitoramento dos recursos do Azure.