Monitorování stavu indexeru a výsledků ve službě Azure AI Vyhledávač

Zpracování indexeru můžete monitorovat na webu Azure Portal nebo programově prostřednictvím volání REST nebo sady Azure SDK. Kromě stavu samotného indexeru můžete zkontrolovat časy spuštění a ukončení a podrobné chyby a upozornění z konkrétního spuštění.

Monitorování pomocí webu Azure Portal

Aktuální stav všech indexerů můžete zobrazit na stránce portálu vyhledávací služby. Stránky webu Azure Portal se aktualizují každých pár minut, takže hned neuvidíte důkaz o novém indexeru. Klikněte na možnost Aktualizovat v horní části stránky pro okamžité zobrazení aktualizovaného zobrazení.

V seznamu můžete vybrat indexer a zobrazit další podrobnosti o aktuálním a nedávném spuštění indexeru.

Pokud chcete zobrazit podrobné protokoly pro konkrétní spuštění, vyberte hodnotu stavu spuštění (například Selhání) a pak vyberte Stáhnout jako CSV.

Souhrnný graf Indexeru zobrazuje graf počtu dokumentů zpracovaných v jeho nejnovějších spuštěních.

Seznam podrobností o spuštění zobrazuje až 50 nejnovějších výsledků spuštění. Výběrem výsledku provedení ze seznamu zobrazíte podrobnosti o daném běhu. To zahrnuje počáteční a koncové časy a všechny chyby a upozornění, ke kterým došlo.

Pokud během spuštění došlo k problémům specifickým pro dokument, jsou uvedené v polích Chyby a Upozornění.

Upozornění jsou běžná u některých typů indexerů a ne vždy značí problém. Například indexery, které používají Nástroje Foundry, můžou hlásit upozornění, když obrázky nebo soubory PDF neobsahují žádný text ke zpracování.

Další informace o zkoumání chyb a upozornění indexeru najdete v pokynech k řešení potíží s indexerem.

Monitorování s využitím metrik monitorování Azure

Azure AI Vyhledávač je monitorovaný prostředek ve službě Azure Monitor, což znamená, že pomocí Průzkumníka metrik můžete zobrazit základní metriky týkající se počtu dokumentů zpracovaných indexerem a vyvolání dovedností. Tyto metriky se dají použít k monitorování průběhu indexeru a nastavení upozornění.

Zobrazení metrik je možné filtrovat nebo rozdělit podle sady předdefinovaných dimenzí. Další informace o dimenzích spojených s metrikami Počet zpracovaných dokumentů a Počet vyvolání provedení dovedností naleznete v části Dimenze metriku.

Následující snímek obrazovky ukazuje počet dokumentů zpracovaných indexery v rámci služby za hodinu, rozdělený podle názvu indexeru.

Graf můžete také nakonfigurovat tak, aby zobrazoval počet volání dovedností v průběhu stejné hodiny.

Monitorování pomocí získání stavu indexeru (REST API)

Stav a historii spuštění indexeru můžete načíst pomocí příkazu Získat stav indexeru:

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

Odpověď obsahuje celkový stav indexeru, poslední (nebo probíhající) vyvolání indexeru a historii nedávných vyvolání indexeru.

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

Historie spuštění obsahuje až 50 nejnovějších provedení, která jsou seřazena v obráceném chronologickém pořadí (nejaktuálnější jako první).

Všimněte si, že existují dvě různé hodnoty stavu. Stav nejvyšší úrovně je určený pro samotný indexer. Stav spuštěného indexeru znamená, že je indexer správně nastavený a dostupný ke spuštění, ale ne to, že je aktuálně spuštěný.

Každé spuštění indexeru má také svůj vlastní stav, který označuje, jestli je konkrétní spuštění probíhající (běžící), nebo již dokončeno se stavem úspěchu, přechodného selhání, nebo trvalého selhání.

Když je indexer resetován, aby obnovil stav sledování změn, automaticky se přidá samostatná položka historie provádění se stavem Reset.

Další informace o stavových kódech a monitorování dat indexeru najdete v tématu Získání stavu indexeru.

Monitorování pomocí .NET

Následující příklad jazyka C# zapisuje informace o stavu indexeru a výsledcích jeho nejnovějšího (nebo probíhajícího) spuštění do konzoly.

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

Výstup v konzole vypadá přibližně takto:

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

Všimněte si, že existují dvě různé hodnoty stavu. Stav nejvyšší úrovně je stav samotného indexeru. Stav indexeru Spuštěno znamená, že je indexer správně nastavený a dostupný ke spuštění, ale ne, že se právě spouští.

Každé spuštění indexeru má také svůj vlastní stav pro to, jestli konkrétní spuštění probíhá (spuštěno), nebo už bylo dokončeno se stavem Success nebo TransientError .

Když je indexer resetován, aby obnovil svůj stav sledování změn, přidá se samostatná položka historie se stavem Reset.

Další kroky

Další informace o stavových kódech a monitorování indexerů najdete v následujících referenčních informacích k rozhraní API:

• Indexery – Získání stavu (REST API)
• IndexerStatus
• IndexerExecutionStatus
• IndexerExecutionResult