Überwachung von Status und Ergebnissen von Indexern in Foundry IQ (Azure KI-Suche)

Note

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Sie können die Indexerverarbeitung im Azure-Portal oder programmatisch über REST-Aufrufe oder ein Azure-SDK überwachen. Zusätzlich zum Status über den Indexer selbst können Sie Start- und Endzeiten sowie detaillierte Fehler und Warnungen einer bestimmten Ausführung anzeigen.

Überwachen mit dem Azure-Portal

Sie können den aktuellen Status all Ihrer Indexer auf der Portalseite Ihres Foundry IQ-Diensts sehen. Azure-Portalseiten werden alle paar Minuten aktualisiert, sodass Sie keine Beweise für einen neuen Indexer sofort sehen. Wählen Sie oben auf der Seite Aktualisieren aus, um sofort die neueste Ansicht abzurufen.

Indexerliste

Der Status BESCHREIBUNG
In Bearbeitung Gibt die aktive Ausführung an. Das Azure-Portal berichtet über Teilinformationen. Beim Fortschreiten der Indizierung erkennen Sie, dass der Wert Dokumente erfolgreich entsprechend ansteigt. Die Ausführung von Indexern, die große Datenmengen verarbeiten, kann sehr lange dauern. So können beispielsweise Indexer, die Millionen von Quelldokumenten verarbeiten, eine Laufzeit von 24 Stunden haben und nahezu umgehend neu gestartet werden und dort weitermachen, wo aufgehört wurde. Daher verfügen Indexer mit hohem Datenvolumen im Azure-Portal unter Umständen durchgehend über den Status In Bearbeitung. Details zum Fortschritt sowie zu vergangenen Ausführungen sind allerdings auch während der Ausführung eines Indexers verfügbar.
Success Gibt an, dass die Ausführung erfolgreich war. Eine Indexerausführung kann auch erfolgreich sein, wenn bei einzelnen Dokumenten Fehler aufgetreten sind – vorausgesetzt, die Fehleranzahl liegt unter der Indexereinstellung Max. Fehlerelemente.
Fehlgeschlagen Die Anzahl der Fehler überschreitet die Max fehlgeschlagenen Elemente und die Indizierung wird gestoppt.
Zurücksetzen Der interne Änderungsnachverfolgungs-Zustand des Indexers wurde zurückgesetzt. Der Indexer führt den kompletten Vorgang aus und aktualisiert alle Dokumente, nicht nur diejenigen mit einem neueren Zeitstempel.

Sie können einen Indexer in der Liste auswählen, um weitere Details zur aktuellen und letzten Ausführung des Indexers anzuzeigen.

Wenn Sie detaillierte Protokolle für eine bestimmte Ausführung anzeigen möchten, wählen Sie den Statuswert der Ausführung aus (z. B. fehlgeschlagen), und wählen Sie dann "Als CSV herunterladen" aus.

Indexerzusammenfassung und Ausführungsverlauf

Im Diagramm Indexerzusammenfassung wird die Anzahl verarbeiteter Dokumente der letzten Ausführungen grafisch dargestellt.

Die Liste Ausführungsdetails enthält bis zu 50 der letzten Ausführungsergebnisse. Wählen Sie in der Liste auf ein Ausführungsergebnis aus, um Einzelheiten zur entsprechenden Ausführung anzuzeigen. Hierzu zählen unter anderem die Start- und Endzeit sowie möglicherweise aufgetretene Fehler und Warnungen.

Indexer-Ausführungsdetails

Wenn während der Ausführung dokumentspezifische Probleme aufgetreten sind, werden sie in den Feldern "Fehler" und "Warnungen" aufgeführt.

Indexerdetails mit Fehlern

Warnungen sind bei bestimmten Arten von Indexern keine Seltenheit und deuten nicht immer auf ein Problem hin. Beispielsweise können Indexer, die Foundry Tools verwenden, Warnungen melden, wenn Bild- oder PDF-Dateien keinen zu verarbeitenden Text enthalten.

Weitere Informationen zur Untersuchung von Indexerfehlern und -warnungen finden Sie unter Beheben von häufigen Problemen bei Suchindexern in der kognitiven Azure-Suche.

Überwachen mit Azure-Überwachungsmetriken

Foundry IQ ist eine überwachte Ressource in Azure Monitor, was bedeutet, dass Sie den Metrik-Explorer verwenden können, um grundlegende Metriken über die Anzahl der vom Indexer verarbeiteten Dokumente und Skillaufrufe anzuzeigen. Diese Metriken können zum Überwachen des Indexerfortschritts und zum Einrichten von Warnungen verwendet werden.

Metrikansichten können nach vordefinierten Dimensionen gefiltert oder aufgeteilt werden. Weitere Informationen zu den Dimensionen, die mit den Metriken Anzahl verarbeiteter Dokumente und Anzahl der Aufrufe der Skillausführung verknüpft sind, finden Sie unter Metrikdimensionen.

Der folgende Screenshot zeigt die Anzahl der Dokumente, die von Indexern innerhalb eines Diensts in einer Stunde verarbeitet werden, aufgeteilt nach Indexername.

Metrik für verarbeitete Indexerdokumente

Sie können das Diagramm auch so konfigurieren, dass die Anzahl von Skillaufrufen im gleichen Stundenintervall angezeigt wird.

Metrik für aufgerufene Indexer-Skills

Überwachen mithilfe des Befehls zum Abrufen des Indexerstatus (Rest-API)

Verwenden Sie die stabile 2026-10-01 REST-API, um einen Indexer auszuführen und den Status zu überwachen. Aktivieren Sie die schlüssellose Authentifizierung, und weisen Sie dem Aufrufer Search Service Contributor zu. Rufen Sie ein Token für den https://search.azure.com/.default Scope ab, und geben Sie es im Header Authorization: Bearer <access-token> jeder Anforderung an. Ein Administrator-API-Schlüssel ist eine Alternative.

Um eine On-Demand-Ausführung zu starten, senden Sie POST https://<search-service-name>.search.windows.net/indexers('<indexer-name>')/search.run?api-version=2026-10-01 mit dem Authentifizierungsheader. Run Indexer gibt HTTP 202 zurück, wenn die Ausführung akzeptiert wird. Die Annahme bedeutet nicht, dass die Ausführung abgeschlossen ist oder der endgültige Berechnungsverbrauch gemeldet wird.

Abrufen des Status und des jüngsten Ausführungsverlaufs mit Get Indexer Status:

GET https://<search-service-name>.search.windows.net/indexers('<indexer-name>')/search.status?api-version=2026-10-01
Authorization: Bearer <access-token>

HTTP 200 gibt den Gesamtindexerstatus, den letzten (oder laufenden) Indexeraufruf und den letzten Ausführungsverlauf zurück. Der folgende Antwortauszug veranschaulicht diese separaten Statusfelder:

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

Der Ausführungsverlauf enthält bis zu 50 der letzten Ausführungen und ist in umgekehrter chronologischer Reihenfolge sortiert, sodass die neuesten Ausführungen zuerst aufgeführt werden.

Die oberste Ebene status beschreibt den Indexer selbst, nicht eine einzelne Ausführung. Overall running bedeutet, dass der Indexer ordnungsgemäß eingerichtet ist und zur Ausführung verfügbar ist. Dies bedeutet nicht, dass eine Ausführung aktiv ist. error weist insgesamt auf ein Problem auf Indexerebene hin.

Der status in lastResult oder ein executionHistory-Eintrag beschreibt eine einzelne Ausführung. Aktive Ausführungsberichte inProgress. Eine abgeschlossene Ausführung meldet success oder transientFailure (eine fehlgeschlagene Ausführung, die wiederholt werden kann).

Wenn ein Indexer zurückgesetzt wird, um den Status der Änderungsnachverfolgung zu aktualisieren, wird ein separater Ausführungsverlaufseintrag mit einem reset Status hinzugefügt.

Weitere Informationen zu Statuscodes und Indexerüberwachungsdaten finden Sie unter Abrufen des Indexerstatus.

Überwachen des Fortschritts nach einem Ausführungszeitstopp

Um die automatische Fortsetzung der Inhaltsverarbeitung zu überwachen, verwenden Sie lastResult und executionHistory, um eine aufgrund eines Kontingents angehaltene Ausführung mit nachfolgenden Arbeiten am gleichen Indexer zu korrelieren:

  1. Suchen Sie die Ausführung, deren errorMessage meldet, dass das Zeitkontingent für die Indexerausführung erreicht wurde. Ein solcher unterbrochener Lauf kann den Status transientFailure melden; allein anhand dieses Status lässt sich ein Abbruch wegen Erreichens eines Kontingents nicht erkennen.
  2. Vergleichen Sie seine endTime mit späteren Ausführungs-startTimeWerten. Eine Fortsetzung in der Warteschlange wird möglicherweise nicht sofort als aktive Ausführung angezeigt.
  3. Überprüfen Sie später die Werte status, itemsProcessed, itemsFailed, errorMessage und errors auf Fortschritt oder wiederholte Fehler. Die Anzahl der Elemente bezieht sich auf jede Ausführung, nicht auf die kumulierte Anzahl eindeutiger indizierter Dokumente.

Diese Beobachtungen zeigen den Stopp und die nachfolgende Verarbeitung; der zeitliche Ablauf allein belegt jedoch nicht, ob eine spätere Ausführung systemseitig ausgelöst, geplant oder bei Bedarf angefordert wurde. Gehen Sie nicht davon aus, dass jedes transientFailure eine Fortsetzung des Kontingents auslöst oder dass ein allgemeines running bedeutet, dass nicht abgeschlossene Arbeit erledigt wurde.

Wenn wiederholte Ausführungen keinen Fortschritt erzielen, lesen Sie die Problembehandlung bei nicht abgeschlossener Ingestion.

Kumulative Laufzeit überwachen

Auf S3 HD und Serverless teilen alle Indexer 48 kumulierte Laufzeitstunden pro Dienst in einem 24-Stunden-UTC-Fenster. Dieses Kontingent ist von der Zwei-Stunden-Grenze für einen einzelnen Mehrinstanzenlauf getrennt.

Die 2026-10-01 stabile API macht zwei Laufzeitansichten verfügbar:

Antworteigenschaft Umfang und Auslegung
Indexerstatus abrufen: runtime.usedSeconds Sekunden, die von diesem Indexer während des Antwortfensters verwendet werden.
Dienststatistiken abrufen: indexersRuntime.usedSeconds Sekunden, die alle Indexer im Dienst im Antwortzeitraum verwendet haben.
Eines der beiden Laufzeitobjekte: remainingSeconds Verbleibende Sekunden, die von allen Indexern im Dienst gemeinsam genutzt werden, kein Budget, das für einen Indexer reserviert ist.
Entwederes der Laufzeitobjekte: beginningTime, endingTime Grenzen des 24-Stunden-UTC-Buchhaltungsfensters. Vergleichen Sie Beobachtungen aus demselben Fenster.
Dienststatistiken abrufen: limits.maxCumulativeIndexerRuntimeSeconds Der gemeldete kumulierte Grenzwert des Diensts in Sekunden. Diese Antworteigenschaft kann nicht vom Kunden festgelegt werden.

Verwenden Sie dieselbe Authentifizierung zum Aufrufen von Dienststatistiken:

GET https://<search-service-name>.search.windows.net/servicestats?api-version=2026-10-01
Authorization: Bearer <access-token>

Der folgende illustrative HTTP 200-Antwortauszug zeigt 7.200 Sekunden, die für den Dienst verwendet werden, und ein Grenzwert von 172.800 Sekunden (48 Stunden). Andere Dienststatistiken werden weggelassen:

{
  "limits": {
    "maxCumulativeIndexerRuntimeSeconds": 172800
  },
  "indexersRuntime": {
    "usedSeconds": 7200,
    "remainingSeconds": 165600,
    "beginningTime": "2026-11-04T00:00:00Z",
    "endingTime": "2026-11-05T00:00:00Z"
  }
}

Rufen Sie den Indexerstatus auf, um die Verwendung eines Indexers mit der dienstweiten Verwendung zu vergleichen:

GET https://<search-service-name>.search.windows.net/indexers('<indexer-name>')/search.status?api-version=2026-10-01
Authorization: Bearer <token>

Der folgende illustrative HTTP 200-Antwortauszug zeigt 3.600 Sekunden, die von diesem Indexer im selben Fenster wie das Dienstbeispiel verwendet werden. Andere Indexerstatusfelder werden weggelassen:

{
  "runtime": {
    "usedSeconds": 3600,
    "remainingSeconds": 165600,
    "beginningTime": "2026-11-04T00:00:00Z",
    "endingTime": "2026-11-05T00:00:00Z"
  }
}

Die 3.600 verwendeten Sekunden dieses Indexers sind Teil der 7.200 Sekunden, die in allen Indexern verwendet werden. Beide Antworten geben dieselben 165.600 verbleibenden Sekunden an, da dieses Budget im gesamten Dienst gemeinsam genutzt wird. Pro Indexer runtime.usedSeconds und gemeinsam genutzter runtime.remainingSeconds Dienst müssen nicht dem Dienstgrenzwert entsprechen.

Im stabilen 2026-10-01 Vertrag runtime und indexersRuntime optional. Gehen Sie nicht davon aus, dass jeder Dienst diese Objekte verfügbar macht. Wenn ein Objekt vorhanden ist, usedSecondsbeginningTime, , und endingTime sind erforderlich.

remainingSeconds und limits.maxCumulativeIndexerRuntimeSeconds sind optional und können null sein. Behandeln Sie fehlende Werte explizit, anstatt sie standardmäßig auf Null zu setzen:

Antwortbeispiel Überwachungsverhalten
runtime oder indexersRuntime fehlt Laufzeitdaten als nicht verfügbar für diese Antwort anzeigen, nicht als Nullverwendung.
remainingSeconds ist nicht vorhanden oder null in einem vorhandenen Laufzeitobjekt ist Zeigen Sie die verbleibende Laufzeit als nicht verfügbar an, nicht als Null oder als Budget, das für diesen Indexer reserviert ist. Behalten Sie die gemeldete Verwendung und das gemeldete Fenster bei.
limits.maxCumulativeIndexerRuntimeSeconds nicht vorhanden oder null Zeigen Sie den gemeldeten Grenzwert als nicht verfügbar an, nicht als Null. Berechnen Sie keinen Kontingentprozentsatz ohne ein bekanntes Limit.

Verwenden Sie diese Beobachtungen, um das Kontingent zu verwalten, nicht um Gebühren zu berechnen. Laufzeitsekunden sind keine Computeeinheiten. Korrelieren Sie bei der Ausführung berechtigter kostenpflichtiger Serverless-Indexer die aggregierte Computenutzung mit dem Ausführungsverlauf; Ein Run-Antwortheader ist kein vollständiger Abrechnungseintrag pro Ausführung.

Interpretieren von Inhaltsverständnisergebnissen

Überprüfen Sie für eine Content Understanding-Pipeline Fehler auf Skill-Ebene und fehlende Chunk-Ausgabe sowie den Gesamtausführungsstatus. Das Standardmäßige Acht-Minuten-Analyse-Abruffenster ist von der Indexerlaufzeit getrennt. Ein Abfrage-Timeout führt nicht unbedingt zum Fehlschlagen der gesamten Ausführung, und eine Anzahl verarbeiteter Dokumente beweist nicht, dass jeder erwartete Block erstellt wurde. Verwenden Sie die Problembehandlung bei der Inhaltsverständnisanalyse , bevor Sie die Arbeit wiederholen, die zusätzliche Gebühren verursachen kann.

Überwachung mit .NET

Im folgenden C#-Beispiel werden Informationen zum Status eines Indexers sowie die Ergebnisse der letzten (oder aktuellen) Ausführung in der Konsole ausgegeben:

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

Die Konsolenausgabe sieht in etwa wie folgt aus:

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

Es gibt zwei verschiedene Statuswerte. Der übergeordnete Status gilt für den Indexer an sich. Der Indexerstatus Wird ausgeführt bedeutet, dass der Indexer ordnungsgemäß eingerichtet ist und ausgeführt werden kann, jedoch nicht, dass er momentan ausgeführt wird.

Jede Ausführung des Indexers hat auch einen eigenen Status, der angibt, ob die jeweilige Ausführung gerade stattfindet (Running) oder bereits abgeschlossen wurde (Success oder TransientError).

Wenn ein Indexer zurückgesetzt wird, um den Zustand seiner Änderungsnachverfolgung zu aktualisieren, wird ein separater Verlaufseintrag mit dem Status Reset hinzugefügt.

Nächste Schritte

Weitere Informationen zu Statuscodes und zur Indexerüberwachung finden Sie in den folgenden API-Referenzen: