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 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á-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, Contagem | DataSourceName, Failed, IndexerName, IndexName, SkillsetName |
PT1M | Yes |
| Latência de pesquisa Latência média de pesquisa do serviço de pesquisa |
SearchLatency |
Segundos | Média | <none> | PT1M | Yes |
| Consultas de pesquisa por segundo Consultas de pesquisa por segundo para o serviço de pesquisa |
SearchQueriesPerSecond |
CountPerSecond | Média | <none> | PT1M | Yes |
| Contagem de invocação de execução de habilidade Número de execuções de habilidade |
SkillExecutionCount |
Count | Total, Contagem | DataSourceName, Failed, IndexerName, SkillName, , SkillsetNameSkillType |
PT1M | Yes |
| 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 | Yes |
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 registrado durante esse minuto. Máximo é o valor mais alto. A média é a agregação de todo o 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.
Dimensões de métrica
Para obter mais informações sobre o que são dimensões de métrica, confira Métricas multidimensionais.
A Pesquisa de IA do Azure tem as seguintes dimensões associadas às métricas que capturam uma contagem de documentos ou habilidades que foram executados, "Contagem de documentos processados" e "Contagem de invocação de execução de habilidades".
| 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 de exportação |
|---|---|---|---|---|---|---|
OperationLogs |
Logs de operação | AzureDiagnostics Logs de vários recursos do Azure. |
Não | 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 eles.
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 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 | 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 na Pesquisa de IA do Azure. 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 sob 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 de Pesquisa de IA do Azure 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.Get, Indexes.Stats, Query.SearchQuery.LookupCORS.PreflightIndexers.ListQuery.AutocompleteQuery.Suggest, . Indexes.UpdateIndexes.PrototypeServiceStatsDataSources.ListIndexers.Warmup |
| durationMS | DuraçãoMilésimos de segundo | 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. |
| 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 operações comuns relacionadas à Pesquisa de IA do Azure 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.
| Operação | Descrição |
|---|---|
| Obter a chave de administrador | Qualquer operação que exija direitos administrativos é registrada como uma operação "Obter chave de administrador". |
| 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 "Alterar histórico" 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 da Pesquisa de IA do Azure 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. A 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 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: 2020-06-30 |
| 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 da Pesquisa de IA do Azure.
| 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=2020-06-30 |
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 Adicionar, Atualizar ou Excluir 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 a Pesquisa de IA do Azure para obter uma descrição do monitoramento da Pesquisa de IA do Azure.
- Confira Monitorar recursos do Azure com o Azure Monitor para ver informações detalhadas sobre o monitoramento dos recursos do Azure.