Referência de dados de monitoramento do Azure AI Search
Este artigo contém todas as informações de referência de monitoramento para este serviço.
Consulte Monitorar a Pesquisa de IA do Azure para obter detalhes sobre os dados que você pode coletar para a Pesquisa de IA do Azure e como usá-la.
Métricas
Esta seção lista todas as métricas de plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas de plataforma com suporte no Azure Monitor.
Para obter informações sobre retenção de métricas, consulte Visão geral do Azure Monitor Metrics.
Métricas suportadas 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 visualizar todas as colunas disponíveis.
Cabeçalhos de tabela
- Categoria - O grupo ou classificação de métricas.
- Métrica - O nome para exibição da métrica conforme aparece no portal do Azure.
- Nome na API REST - O nome da métrica conforme 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ínima (Mín), Máxima (Máx), Total (Soma), Contagem.
- Dimensões - Dimensões disponíveis para a métrica.
- Intervalos de grãos de - tempo 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. - DS Export- Se a métrica é exportável para os Logs do Azure Monitor por meio de configurações de diagnóstico. Para obter informações sobre como exportar métricas, consulte Criar configurações de diagnóstico no Azure Monitor.
| Métrica | Nome na API REST | Unit | Agregação | Dimensões | Grãos de tempo | DS Exportação |
|---|---|---|---|---|---|---|
| Contagem de documentos processados Número de documentos tratados |
DocumentsProcessedCount |
Count | Total (soma), contagem | DataSourceName, Failed, IndexerName, IndexName, SkillsetName |
PT1M | Sim |
| Latência de pesquisa Latência média de pesquisa para o serviço de pesquisa |
SearchLatency |
Segundos | Média | <nenhum> | PT1M | Sim |
| Consultas de pesquisa por segundo Consultas de pesquisa por segundo para o serviço de pesquisa |
SearchQueriesPerSecond |
CountPerSecond | Média | <nenhum> | PT1M | Sim |
| Contagem de invocação de execução de habilidades Número de execuções de habilidades |
SkillExecutionCount |
Count | Total (soma), contagem | DataSourceName, Failed, IndexerName, SkillName, SkillsetName, SkillType |
PT1M | Sim |
| Percentagem de consultas de pesquisa limitadas Porcentagem de consultas de pesquisa que foram limitadas para o serviço de pesquisa |
ThrottledSearchQueriesPercentage |
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, 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 que foram registadas durante esse minuto. Máximo é o valor mais alto. A média é o agregado ao longo de todo o minuto.
| Tipo de agregação | Description |
|---|---|
| Média | O número médio de segundos dentro de um minuto durante o qual ocorreu a execução da consulta. |
| Count | O número de métricas emitidas para o log 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, 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, 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 "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. |
| Count | 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, executadas dentro do intervalo (um minuto). |
Percentagem de 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 na memória, CPU e E/S do disco é calculada em média ao longo de um período de tempo. Se essa porcentagem exceder um limite, todas as solicitações ao í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, o Gerenciador de Pesquisa), a consulta será descartada silenciosamente e você precisará selecionar Pesquisar novamente.
Para confirmar consultas limitadas, use a métrica Consultas de pesquisa limitadas. Você pode explorar métricas no portal do 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 a porcentagem de consultas que não foram executadas.
| Tipo de agregação | Limitação |
|---|---|
| Média | Porcentagem de consultas caídas dentro do intervalo. |
| Count | O número de métricas emitidas para o log dentro do intervalo de um minuto. |
| Máximo | Porcentagem de consultas caídas dentro do intervalo. |
| Mínimo | Porcentagem de consultas caídas dentro do intervalo. |
| Total | Porcentagem de consultas caídas dentro do intervalo. |
Para Porcentagem de Consultas de Pesquisa Limitada, mínimo, máximo, média e total, todos têm o mesmo valor: a porcentagem de consultas de pesquisa que foram limitadas, a partir do número total de consultas de pesquisa durante um minuto.
Dimensões métricas
Para obter informações sobre o que são dimensões métricas, consulte 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 | Description | Dimensões | Casos de utilização de amostra |
|---|---|---|---|
| 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 da 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 de habilidade, nome do conjunto de habilidades | Referência para garantir que as competências são invocadas como esperado, comparando os números relativos de invocação entre as competências e o número de invocações de competências com o número de documentos. - Configuração para alertar sobre invocações de habilidade com falha |
| Nome da dimensão | Description |
|---|---|
| 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 suportados. |
| Falhado | 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. |
| Tipo de habilidade | O @odata.type da habilidade. |
Registos do recurso
Esta seção lista os tipos de logs de recursos que você pode coletar para 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 suportados para Microsoft.Search/searchServices
| Categoria | Nome de exibição da categoria | Tabela de registo | Suporta plano de log básico | Suporta a transformação do tempo de ingestão | Consultas de exemplo | Custos de exportação |
|---|---|---|---|---|---|---|
OperationLogs |
Logs de operação | AzureDiagnostics Logs de vários recursos do Azure. |
No | No | Não |
Tabelas de Logs do Azure Monitor
Esta seção lista as tabelas de Logs do Azure Monitor 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.
Pesquisar Serviços
Microsoft.Search/searchServices
| Table | Description |
|---|---|
| AzureActivity | As entradas do log de atividades do 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 administrador". |
| AzureDiagnostics | Consulta registada e operações de indexação. As consultas na tabela AzureDiagnostics no Log Analytics podem incluir as propriedades comuns, as propriedades específicas da pesquisa e as operações específicas da pesquisa listadas na seção de referência do esquema. |
| AzureMetrics | Dados métricos emitidos pelo Azure AI 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 nos Logs do Azure Monitor ou no Armazenamento do Azure. No Azure Monitor, os logs são coletados na tabela AzureDiagnostics sob o nome do provedor de recursos .Microsoft.Search
| Campo ou propriedade do Armazenamento do Azure | Propriedade de registos do Azure Monitor | Description |
|---|---|---|
| hora | CARIMBO DE DATA/HORA | A data e hora (UTC) em que a operação ocorreu. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | O recurso Azure AI Search para o qual os logs estão habilitados. |
| category | "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.Stats, Indexers.List, Query.LookupQuery.AutocompleteQuery.SuggestQuery.Search, CORS.Preflight, , Indexes.Update, Indexes.PrototypeIndexers.WarmupServiceStatsDataSources.List. Indexes.Get |
| duraçãoMS | DuraçãoMilissegundos | A duração da operação, em milissegundos. |
| operationVersion | ApiVersion | A versão da API usada na solicitação. |
| resultType | (Falhou) ? "Falhou" : "Sucesso" | O tipo de resposta. |
| resultSignature | Status | O status de resposta HTTP da operação. |
| propriedades | Propriedades | Quaisquer propriedades estendidas relacionadas a essa categoria de eventos. |
Registo 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 possíveis do provedor de recursos no log de atividades.
Para obter mais informações sobre o esquema de entradas do log de atividades, consulte 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 do Microsoft.Search, consulte Operações do provedor de recursos Microsoft.Search.
| Operation | Description |
|---|---|
| Obter chave de administrador | Qualquer operação que exija direitos administrativos é registrada como uma operação "Obter chave de administrador". |
| Obter chave de consulta | Qualquer operação somente leitura na coleção de documentos de um índice. |
| Regenerar a chave de administrador | 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 que foram feitas usando a chave admin (criar ou excluir objetos) ou a chave de consulta, mas não mostram a solicitação em si. Para obter informações desse grão, você deve configurar o log de recursos.
Como alternativa, você pode obter algumas informações através 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 logs de recursos enviados para armazenamento de blob, cada blob tem um objeto raiz chamado registros contendo uma matriz de objetos de log. Cada blob contém registros de todas as operações que ocorreram durante a mesma hora.
Esquema do registo 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". Este valor é uma constante. OperationLogs é a única categoria usada para logs de recursos. |
| OperationName | String | O nome da operação (ver a lista completa de operações). Um exemplo é Query.Search |
| OperationVersion | String | A versão api usada na solicitação. Por exemplo: 2024-07-01 |
| ResultType | String | "Sucesso". Outros valores possíveis: Sucesso ou Fracasso |
| ResultSignature | Int | Um código de resultado HTTP. Por exemplo: 200 |
| DuraçãoMS | Int | Duração da operação em milissegundos. |
| Propriedades | Object | 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 do Azure AI Search.
| Nome | Tipo | Descrição e exemplo |
|---|---|---|
| Description_s | String | O ponto final 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. |
| Query_s | String | Os parâmetros de consulta usados na solicitação. Por exemplo: ?search=beach access&$count=true&api-version=2024-07-01 |
Valores OperationName (operações registradas)
As operações a seguir podem aparecer em um log de recursos.
| OperationName | Description |
|---|---|
| Fontes de dados.* | 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 Criar, Excluir, Obter, Listar, Iniciar 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 para um armazenamento de conhecimento. |
| Indexadores.* | Aplica-se a um indexador. Pode ser Criar, Excluir, Obter, Listar e Status. |
| Índices.* | Aplica-se a um índice de pesquisa. Pode ser Criar, Excluir, Obter, Listar. |
| índices. Protótipo | Este índice é criado pelo assistente Importar Dados. |
| Indexação.Índice | 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 Tipos de consulta e composição. |
| Consulta.Pesquisa | Uma consulta de pesquisa em relação a um índice. Consulte Tipos de consulta e composição. |
| Query.Search | Uma solicitação de pesquisa de texto completo em relação a um índice. Consulte Tipos de consulta e composição. |
| Consulta.Sugerir | Digite a consulta antecipada em relação a um índice. Consulte Tipos de consulta e composição. |
| ServiceStats | Esta 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 competências.* | Aplica-se a um conjunto de competências. Pode ser Criar, Excluir, Obter, Listar. |
Conteúdos relacionados
- Consulte Monitorar a Pesquisa de IA do Azure para obter uma descrição do monitoramento da Pesquisa de IA do Azure.
- Consulte Monitorar recursos do Azure com o Azure Monitor para obter detalhes sobre o monitoramento de recursos do Azure.