Status en resultaten van de indexeerfunctie bewaken in Azure AI Zoeken

U kunt de verwerking van indexeerfuncties bewaken in Azure Portal of programmatisch via REST-aanroepen of een Azure SDK. Naast de status van de indexeerfunctie zelf, kunt u de begin- en eindtijden en gedetailleerde fouten en waarschuwingen van een bepaalde uitvoering bekijken.

Bewaken met behulp van Azure Portal

U kunt de huidige status van al uw indexeerfuncties zien op de pagina van de zoekserviceportal. Pagina's in Azure Portal worden om de paar minuten vernieuwd, zodat u geen bewijs ziet dat een nieuwe indexeerfunctie meteen wordt uitgevoerd. Selecteer Vernieuwen boven aan de pagina om direct de meest recente weergave op te halen.

U kunt een indexeerfunctie in de lijst selecteren voor meer informatie over de huidige en recente uitvoeringen van de indexeerfunctie.

Als u gedetailleerde logboeken voor een specifieke uitvoering wilt zien, selecteert u de statuswaarde van de uitvoering (bijvoorbeeld Mislukt) en selecteert u Vervolgens Downloaden als CSV.

Het indexeersamenvattingsdiagram geeft een grafiek weer van het aantal documenten dat in de meest recente runs is verwerkt.

De lijst met uitvoeringsdetails bevat maximaal 50 van de meest recente uitvoeringsresultaten. Selecteer een uitvoeringsresultaat in de lijst om details over die uitvoering weer te geven. Dit omvat de begin- en eindtijden, en eventuele fouten en waarschuwingen die zijn opgetreden.

Als er documentspecifieke problemen zijn tijdens de uitvoering, worden deze weergegeven in de velden Fouten en Waarschuwingen.

Waarschuwingen zijn gebruikelijk bij sommige typen indexeerfuncties en geven niet altijd een probleem aan. Indexeerfuncties die gebruikmaken van Foundry Tools kunnen bijvoorbeeld waarschuwingen rapporteren wanneer afbeeldings- of PDF-bestanden geen tekst bevatten die moet worden verwerkt.

Zie de richtlijnen voor het oplossen van problemen met indexeerfuncties voor meer informatie over het onderzoeken van indexeerfouten en waarschuwingen.

Bewaken met metrische gegevens van Azure Monitoring

Azure AI Zoeken is een bewaakte resource in Azure Monitor. Dit betekent dat u Metrics Explorer kunt gebruiken om metrische basisgegevens te bekijken over het aantal documenten en vaardigheden die door de indexeerfunctie zijn verwerkt. Deze metrische gegevens kunnen worden gebruikt om de voortgang van de indexeerfunctie te bewaken en waarschuwingen in te stellen.

Metrische weergaven kunnen worden gefilterd of gesplitst door een set vooraf gedefinieerde dimensies. Zie Metric dimensions voor meer informatie over de dimensies die zijn gekoppeld aan de statistieken Document processed count en Skill execution invocation count.

In de volgende schermopname ziet u het aantal documenten dat is verwerkt door indexeerfuncties binnen een service gedurende een uur, opgesplitst op naam van de indexeerfunctie.

U kunt de grafiek ook configureren om het aantal vaardigheidsoproepen binnen hetzelfde uurinterval weer te geven.

Monitor de Status van de Indexer Opvragen (REST API)

U kunt de status en uitvoeringsgeschiedenis van een indexeerfunctie ophalen met behulp van de opdracht Status van indexeerfunctie ophalen:

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

Het antwoord bevat de algemene status van de indexeerfunctie, de laatste (of actieve) indexeerfunctie aanroep en de geschiedenis van recente indexeerfuncties.

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

De uitvoeringsgeschiedenis bevat maximaal 50 meest recente uitvoeringen, die in omgekeerde chronologische volgorde worden gesorteerd (meest recente eerste).

Let op: er zijn twee verschillende statuswaarden. De status op het hoogste niveau is voor de indexeerfunctie zelf. Een indexeerfunctiestatus van uitvoering betekent dat de indexeerfunctie correct is ingesteld en beschikbaar is om uit te voeren, maar niet dat deze momenteel wordt uitgevoerd.

Elke uitvoering van de indexeerfunctie heeft ook een eigen status die aangeeft of de specifieke uitvoering wordt uitgevoerd (actief) of al is voltooid met een geslaagde, tijdelijkeFailure- of persistentFailure-status .

Wanneer een indexeerfunctie opnieuw wordt ingesteld om de status van het bijhouden van wijzigingen te vernieuwen, wordt een afzonderlijke vermelding voor de uitvoeringsgeschiedenis toegevoegd met de status Opnieuw instellen .

Zie Status van indexeerfunctie ophalen voor meer informatie over statuscodes en bewakingsgegevens van de indexeerfunctie.

Bewaken met behulp van .NET

In het volgende C#-voorbeeld wordt informatie over de status van een indexer en de resultaten van de meest recente (of lopende) uitvoering naar de console geschreven.

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

De uitvoer in de console ziet er ongeveer als volgt uit:

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

Let op: er zijn twee verschillende statuswaarden. De status op het hoogste niveau is de status van de indexeerfunctie zelf. Een indexeerfunctiestatus van Actief, betekent dat de indexeerfunctie correct is ingesteld en beschikbaar is voor uitvoer, maar niet dat deze wel momenteel wordt uitgevoerd.

Elke uitvoering van de indexeerder heeft ook een eigen status voor of die specifieke uitvoering loopt (Running) of al is voltooid met de status Success of TijdelijkeFout.

Wanneer een indexeerfunctie opnieuw wordt ingesteld om de status van het bijhouden van wijzigingen te vernieuwen, wordt een afzonderlijke geschiedenisvermelding toegevoegd met de status Opnieuw instellen .

Volgende stappen

Zie de volgende API-verwijzing voor meer informatie over statuscodes en bewakingsinformatie voor indexeerfuncties:

• Indexeerders: Status ophalen (REST API)
• IndexerStatus
• IndexerExecutionStatus
• IndexerExecutionResult