Övervaka indexerarens status och resultat i Azure AI-sökning

Du kan övervaka indexerarens bearbetning i Azure Portal eller programmatiskt via REST-anrop eller en Azure SDKs. Förutom status för själva indexeraren kan du granska start- och sluttider samt detaljerade fel och varningar från en viss körning.

Övervaka med hjälp av Azure Portal

Du kan se den aktuella statusen för alla indexerare på söktjänstportalsidan. Azure-portalsidor uppdateras med några minuters mellanrum, så du ser inga tecken på att en ny indexerare körs direkt. Välj Uppdatera överst på sidan för att omedelbart hämta den senaste vyn.

Du kan välja en indexerare i listan för att se mer information om indexerarens aktuella och senaste körningar.

Om du vill se detaljerade loggar för en specifik körning väljer du körningens statusvärde (till exempel Misslyckades) och väljer sedan "Ladda ned som CSV".

Indexer-sammanfattningsdiagrammet visar en graf över antalet dokument som bearbetades i de senaste körningarna.

Listan Körningsinformation visar upp till 50 av de senaste körningsresultaten. Välj ett körningsresultat i listan för att se detaljer om den körningen. Detta inkluderar start- och sluttider samt eventuella fel och varningar som har inträffat.

Om det fanns dokumentspecifika problem under körningen visas de i fälten Fel och varningar.

Varningar är vanliga med vissa typer av indexerare och indikerar inte alltid ett problem. Till exempel kan indexerare som använder Foundry Tools rapportera varningar när bild- eller PDF-filer inte innehåller någon text att bearbeta.

Mer information om hur du undersöker indexeringsfel och varningar finns i Felsökningsvägledning för Indexer.

Övervaka med Azure Monitoring Metrics

Azure AI-sökning är en övervakad resurs i Azure Monitor, vilket innebär att du kan använda Metrics Explorer för att se grundläggande mått om antalet indexerarebearbetade dokument och kompetensanrop. Dessa mått kan användas för att övervaka indexerarens förlopp och konfigurera aviseringar.

Måttvyer kan filtreras eller delas upp med en uppsättning fördefinierade dimensioner. För att lära dig mer om de dimensioner som är associerade med måtten Dokument bearbetade antal och Körningsanrop för färdighet, se Måttdimensioner.

Följande skärmbild visar antalet dokument som bearbetas av indexerare inom en tjänst under en timme, uppdelat efter indexerarens namn.

Du kan också konfigurera diagrammet för att se antalet kompetensanrop under samma timintervall.

Övervaka med hjälp av Rest API (Get Indexer Status)

Du kan hämta status- och körningshistoriken för en indexerare med hjälp av kommandot Hämta indexerarestatus:

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

Svaret innehåller övergripande indexerarstatus, den sista (eller pågående) indexerarens anrop och historiken för de senaste anropen av indexerare.

{
    "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
    }]
}

Körningshistoriken innehåller upp till de 50 senaste körningarna, som sorteras i omvänd tidsföljd med den senaste först.

Observera att det finns två olika statusvärden. Den översta nivåns status är för själva indexeraren. En indexerares status som kör innebär att indexeraren är korrekt konfigurerad och tillgänglig att köra, men inte att den körs just nu.

Varje körning av indexeraren har också en egen status som anger om den specifika körningen pågår (körs) eller redan har slutförts med statusen framgång, tillfälligtFel eller ihållandeFel.

När en indexerare återställs för att uppdatera sin spårning av ändringar läggs en separat post i körningshistoriken till med Återställ-statusen.

Mer information om statuskoder och indexeringsövervakningsdata finns i Hämta indexeringsstatus.

Övervaka med .NET

I följande C#-exempel skrivs information om en indexerares status och resultatet av den senaste (eller pågående) körningen till konsolen.

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
    }
}

Utdata i konsolen ser ut ungefär så här:

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

Observera att det finns två olika statusvärden. Statusen på den översta nivån är indexerarens status. Indexerarens status körs innebär att indexeraren är korrekt konfigurerad och tillgänglig för körning, men inte att den körs för närvarande.

Varje körning av indexeraren har också sin egen status för huruvida den specifika körningen pågår (körs) eller redan har slutförts med statusen Lyckades eller TransientError .

När en indexerare återställs för att uppdatera sitt ändringsspårningstillstånd läggs en separat historikpost till med statusen Återställ .

Nästa steg

Mer information om statuskoder och övervakningsinformation för indexerare finns i följande API-referens:

• Indexerare – Hämta status (REST API)
• IndexerStatus
• IndexerExecutionStatus
• IndexerExecutionResult