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.
| Metric | 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, 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, 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 |
SearchQueriesPerSecond 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.
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.
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 as seguintes dimensões associadas às métricas que capturam uma contagem de documentos ou habilidades que foram executadas, "Contagem de documentos processados" e "Contagem de invocação de execução de habilidades".
| 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 Azure Monitor Logs | 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: 2020-06-30 |
| 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=2020-06-30 |
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 Adicionar, Atualizar ou Excluir Documentos. |
| 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.