Monitorizar o estado e os resultados do indexador no Pesquisa de IA do Azure

Pode monitorizar o processamento do indexador no portal Azure, ou programaticamente através de chamadas REST ou de um SDK do Azure. Para além do estado do próprio indexador, pode rever os horários de início e fim, bem como erros detalhados e avisos de uma determinada execução.

Monitorizar utilizando o Azure Portal

Pode ver o estado atual de todos os seus indexadores na página do portal de serviço de pesquisa. As páginas do portal do Azure atualizam-se a cada poucos minutos, por isso não vês evidências de uma nova execução de indexador imediatamente. Selecione Atualizar no topo da página para recuperar imediatamente a visualização mais recente.

Pode selecionar um indexador na lista para ver mais detalhes sobre as execuções atuais e recentes do indexador.

Para ver registos detalhados de uma execução específica, selecione o valor de Estado da execução (por exemplo, Falhado) e depois selecione "Download as CSV".

O quadro de resumo do Indexer apresenta um gráfico do número de documentos processados nas suas edições mais recentes.

A lista de detalhes de execução mostra até 50 dos resultados de execução mais recentes. Selecione um resultado de execução na lista para ver detalhes sobre essa execução. Isto inclui os seus horários de início e fim, bem como quaisquer erros e avisos que tenham ocorrido.

Se houve problemas específicos de um documento durante a execução, estes estão listados nos campos Erros e Avisos.

Os avisos são comuns em alguns tipos de indexadores e nem sempre indicam um problema. Por exemplo, os indexadores que usam o Foundry Tools podem reportar avisos quando ficheiros de imagem ou PDF não contêm texto para processar.

Para mais informações sobre a investigação de erros e avisos do indexador, consulte a orientação de resolução de problemas do indexador.

Monitorizar com Métricas de Monitorização do Azure

O Pesquisa de IA do Azure é um recurso monitorizado no Azure Monitor, o que significa que pode usar o Metrics Explorer para ver métricas básicas sobre o número de documentos processados pelo indexador e invocações de competências. Estas métricas podem ser usadas para monitorizar o progresso dos indexadores e configurar alertas.

As vistas métricas podem ser filtradas ou divididas por um conjunto de dimensões predefinidas. Para saber mais sobre as dimensões associadas às métricas Contagem de documentos processados e Contagem de execução de competências invocada, consulte Dimensões métricas.

A captura de ecrã seguinte mostra o número de documentos processados pelos indexadores num serviço ao longo de uma hora, divididos por nome do indexador.

Também podes configurar o gráfico para ver o número de invocações de habilidades no mesmo intervalo de horas.

Monitorizar o estado do indexador usando a função Get Indexer Status (API REST)

Pode recuperar o estado e o histórico de execução de um indexador usando o comando Get Indexer Status:

GET https://[service name].search.windows.net/indexers/[indexer name]/status?api-version=2026-04-01
api-key: [Search service admin key]

A resposta contém o estado geral do indexador, a última (ou em andamento) invocação do indexador e o histórico das invocações recentes do indexador.

{
    "status":"running",
    "lastResult": {
        "status":"success",
        "errorMessage":null,
        "startTime":"2018-11-26T03:37:18.853Z",
        "endTime":"2018-11-26T03:37:19.012Z",
        "errors":[],
        "itemsProcessed":11,
        "itemsFailed":0,
        "initialTrackingState":null,
        "finalTrackingState":null
     },
    "executionHistory":[ {
        "status":"success",
         "errorMessage":null,
        "startTime":"2018-11-26T03:37:18.853Z",
        "endTime":"2018-11-26T03:37:19.012Z",
        "errors":[],
        "itemsProcessed":11,
        "itemsFailed":0,
        "initialTrackingState":null,
        "finalTrackingState":null
    }]
}

O histórico de execuções contém até 50 execuções mais recentes, que estão ordenadas por ordem cronológica inversa (a mais recente primeiro).

Note que existem dois valores de estado diferentes. O estatuto de topo é para o próprio indexador. O estado de indexador em execução significa que o indexador está corretamente configurado e disponível para correr, mas não que esteja atualmente a correr.

Cada execução do indexador tem também o seu próprio estado que indica se essa execução específica está em curso (em execução) ou já concluída com um estado de sucesso, transientFailure ou persistentFailure .

Quando um indexador é reiniciado para atualizar o estado de monitorização de alterações, uma entrada separada no histórico de execução é adicionada com o estado Reset.

Para mais informações sobre códigos de estado e dados de monitorização do indexador, consulte Obter Estado do Indexador.

Monitor usando .NET

O exemplo seguinte de C# escreve informações sobre o estado de um indexador e os resultados da sua execução mais recente (ou em andamento) para a consola.

static void CheckIndexerStatus(SearchIndexerClient indexerClient, SearchIndexer indexer)
{
    try
    {
        string indexerName = "hotels-sql-idxr";
        SearchIndexerStatus execInfo = indexerClient.GetIndexerStatus(indexerName);

        Console.WriteLine("Indexer has run {0} times.", execInfo.ExecutionHistory.Count);
        Console.WriteLine("Indexer Status: " + execInfo.Status.ToString());

        IndexerExecutionResult result = execInfo.LastResult;

        Console.WriteLine("Latest run");
        Console.WriteLine("Run Status: {0}", result.Status.ToString());
        Console.WriteLine("Total Documents: {0}, Failed: {1}", result.ItemCount, result.FailedItemCount);

        TimeSpan elapsed = result.EndTime.Value - result.StartTime.Value;
        Console.WriteLine("StartTime: {0:T}, EndTime: {1:T}, Elapsed: {2:t}", result.StartTime.Value, result.EndTime.Value, elapsed);

        string errorMsg = (result.ErrorMessage == null) ? "none" : result.ErrorMessage;
        Console.WriteLine("ErrorMessage: {0}", errorMsg);
        Console.WriteLine(" Document Errors: {0}, Warnings: {1}\n", result.Errors.Count, result.Warnings.Count);
    }
    catch (Exception e)
    {
        // Handle exception
    }
}

A saída na consola é mais ou menos assim:

Indexer has run 18 times.
Indexer Status: Running
Latest run
  Run Status: Success
  Total Documents: 7, Failed: 0
  StartTime: 11:29:31 PM, EndTime: 11:29:31 PM, Elapsed: 00:00:00.2560000
  ErrorMessage: none
  Document Errors: 0, Warnings: 0

Note que existem dois valores de estado diferentes. O estado de topo é o estado do próprio indexador. O estado do indexador em Execução significa que o indexador está corretamente configurado e disponível para execução, mas não que está atualmente a executar.

Cada execução do indexador tem também o seu próprio estado para determinar se essa execução específica está em curso (Em Execução), ou se já foi concluída com um estado de Sucesso ou TransientError .

Quando um indexador é reiniciado para atualizar o seu estado de acompanhamento de alterações, é adicionada uma entrada de histórico separada com um estado de Reset .

Próximos passos

Para mais informações sobre códigos de estado e informações de monitorização do indexador, consulte a seguinte referência da API:

• Indexadores - Obter Estado (API REST)
• IndexerStatus
• IndexerExecutionStatus
• IndexerExecutionResult