Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Przetwarzanie indeksatora można monitorować w witrynie Azure Portal lub programowo za pomocą wywołań REST lub zestawu Azure SDK. Oprócz stanu samego indeksatora można przejrzeć czasy rozpoczęcia i zakończenia oraz szczegółowe błędy i ostrzeżenia z określonego przebiegu.
Monitorowanie przy użyciu witryny Azure Portal
Bieżący stan wszystkich indeksatorów można wyświetlić na stronie portalu usługi Foundry IQ. Strony witryny Azure Portal są odświeżane co kilka minut, aby od razu nie widać dowodów na uruchomienie nowego indeksatora. Wybierz pozycję Odśwież w górnej części strony, aby natychmiast pobrać najnowszy widok.
| Status | Opis |
|---|---|
| W toku | Wskazuje aktywne wykonywanie. witryna Azure Portal zgłasza częściowe informacje. W miarę postępu indeksowania można obserwować wzrost wartości Docs Succeeded w odpowiedzi. Indeksatory przetwarzające duże ilości danych mogą wymagać dużo czasu na wykonanie. Na przykład indeksatory obsługujące miliony dokumentów źródłowych mogą działać przez 24 godziny, a następnie restartować się niemal natychmiast, aby kontynuować od miejsca, w którym się zatrzymały. W związku z tym stan indeksatorów o dużym wolumenie może zawsze być wyświetlany w toku w portalu Azure. Nawet jeśli indeksator jest uruchomiony, szczegółowe informacje dotyczące trwającego postępu i poprzednich przebiegów są dostępne. |
| Success | Wskazuje, że przebieg zakończył się pomyślnie. Uruchomienie indeksatora może zakończyć się powodzeniem, nawet jeśli poszczególne dokumenty mają błędy, jeśli liczba błędów jest mniejsza niż ustawienie Maksymalna liczba elementów zakończonych niepowodzeniem indeksatora. |
| Nie powiodło się | Liczba błędów przekroczyła maksymalną liczbę elementów zakończonych niepowodzeniem i zatrzymanie indeksowania. |
| Reset | Stan wewnętrznego śledzenia zmian indeksatora został zresetowany. Indeksator jest uruchamiany w trybie pełnym, odświeżając wszystkie dokumenty, a nie tylko te z nowszymi znacznikami czasu. |
Możesz wybrać indeksator na liście, aby wyświetlić więcej szczegółów na temat bieżących i ostatnich przebiegów indeksatora.
Aby wyświetlić szczegółowe dzienniki dla określonego przebiegu, wybierz wartość Stanu przebiegu (na przykład Niepowodzenie), a następnie wybierz pozycję "Pobierz jako plik CSV".
Wykres Podsumowanie indeksatora przedstawia diagram liczby dokumentów przetworzonych w jego ostatnich uruchomieniach.
Lista Szczegóły wykonania pokazuje maksymalnie 50 najnowszych wyników wykonania. Wybierz wynik uruchomienia na liście, aby wyświetlić szczegółowe informacje o tym wykonaniu. Obejmuje to czas rozpoczęcia i zakończenia oraz wszelkie błędy i ostrzeżenia, które wystąpiły.
Jeśli podczas uruchamiania wystąpiły problemy specyficzne dla dokumentu, są one wymienione w polach Błędy i Ostrzeżenia.
Ostrzeżenia są typowe dla niektórych typów indeksatorów i nie zawsze wskazują problem. Na przykład indeksatory korzystające z narzędzi Foundry mogą zgłaszać ostrzeżenia, gdy pliki obrazów lub plików PDF nie zawierają żadnego tekstu do przetworzenia.
Aby uzyskać więcej informacji na temat badania błędów i ostrzeżeń indeksatora, zobacz Wskazówki dotyczące rozwiązywania problemów z indeksatorem.
Monitorowanie za pomocą metryk monitorowania platformy Azure
Foundry IQ to monitorowany zasób w Azure Monitor, co oznacza, że możesz użyć Eksploratora metryk, aby wyświetlić podstawowe metryki dotyczące liczby dokumentów przetworzonych przez indeksator i wywołań umiejętności. Te metryki mogą służyć do monitorowania postępu indeksatora i konfigurowania alertów.
Widoki metryk można filtrować lub dzielić według zestawu wstępnie zdefiniowanych wymiarów. Aby dowiedzieć się więcej o wymiarach skojarzonych z metrykami Liczba przetworzonych dokumentów i Liczba wywołań wykonywania umiejętności, zobacz Wymiary metryk.
Poniższy zrzut ekranu przedstawia liczbę dokumentów przetwarzanych przez indeksatory w usłudze przez godzinę podzieloną według nazwy indeksatora.
Możesz również skonfigurować wykres, aby zobaczyć liczbę wywołań umiejętności w tym samym interwale godzinowym.
Monitorowanie przy użyciu funkcji Uzyskiwanie stanu indeksatora (interfejs API REST)
Użyj stabilnego 2026-10-01 interfejsu API REST, aby uruchomić indeksator i monitorować jego stan. Włącz uwierzytelnianie bez użycia klucza i przypisz do obiektu wywołującego rolę Współautor usługi wyszukiwania. Uzyskaj token dla https://search.azure.com/.default zakresu i dołącz go do nagłówka Authorization: Bearer <access-token> każdego żądania.
Klucz interfejsu API administratora jest alternatywą.
Aby rozpocząć uruchamianie na żądanie, wyślij POST https://<search-service-name>.search.windows.net/indexers('<indexer-name>')/search.run?api-version=2026-10-01 za pomocą nagłówka uwierzytelniania.
Uruchom indeksator zwraca kod HTTP 202 po zaakceptowaniu wykonania. Przyjęcie nie oznacza ukończenia przebiegu ani raportowania końcowego użycia zasobów obliczeniowych.
Pobierz stan i ostatnią historię wykonywania za pomocą polecenia 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>
Protokół HTTP 200 zwraca ogólny stan indeksatora, ostatnie wywołanie indeksatora (lub będące w toku) oraz niedawną historię wykonań. Poniższy fragment odpowiedzi ilustruje następujące oddzielne pola stanu:
{
"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
}]
}
Historia wykonywania zawiera maksymalnie 50 najnowszych uruchomień, które sortowane są w odwrotnej kolejności chronologicznej (najnowsze na górze).
Element najwyższego poziomu status opisuje sam indeksator, a nie indywidualne wykonanie. Ogólnie running oznacza, że indeksator jest poprawnie skonfigurowany i dostępny do uruchomienia. Nie oznacza to, że przebieg jest aktywny. Ogólnie error wskazuje problem na poziomie indeksatora.
Wpis status w lastResult lub wpis executionHistory opisuje pojedyncze wykonanie. Aktywne uruchamianie raportów inProgress. Ukończone uruchomienie raportuje success lub transientFailure (uruchomienie zakończone niepowodzeniem, które można ponowić).
Gdy indeksator zostanie zresetowany w celu odświeżenia stanu śledzenia zmian, zostanie dodany oddzielny wpis historii wykonywania ze stanem reset .
Aby uzyskać więcej informacji na temat kodów stanu i danych monitorowania indeksatora, zobacz Pobieranie stanu indeksatora.
Monitorowanie postępu po zatrzymaniu podczas wykonywania
Aby monitorować kontynuację automatycznego przetwarzania zawartości, użyj polecenia lastResult i executionHistory, aby skorelować wykonanie zatrzymane z powodu limitu z kolejnymi pracami na tym samym indeksatorze:
- Znajdź wykonanie, w którym
errorMessagewskazuje, że osiągnięto limit czasu wykonywania indeksatora. Taki przerwany przebieg może zgłaszać stantransientFailure; sam stan nie identyfikuje zatrzymania z powodu osiągnięcia limitu. - Porównaj je
endTimez późniejszymi wartościami wykonywaniastartTime. Kontynuacja w kolejce może nie być wyświetlana jako aktywne wykonanie natychmiast. - Sprawdź później
statuswartości , ,itemsProcesseditemsFailed,errorsierrorMessagepod kątem postępu lub powtarzających się niepowodzeń. Liczba elementów opisuje każde wykonanie, a nie skumulowaną liczbę unikatowych dokumentów indeksowanych.
Te obserwacje pokazują zatrzymanie i kolejne przetwarzanie; sam czas nie dowodzi, czy późniejsze wykonanie zostało wygenerowane przez system, zaplanowane lub żądane na żądanie. Nie zakładaj, że każde transientFailure powoduje kontynuację limitu ani że ogólne running oznacza, że nieukończona praca została zakończona.
Jeśli powtarzające się wykonania nie przynoszą żadnych postępów, zobacz Rozwiązywanie problemów z nieukończonym pozyskiwaniem danych.
Monitoruj skumulowany czas działania
W usługach S3 HD i Serverless wszystkie indeksatory współużytkują 48 skumulowanych godzin czasu wykonywania na usługę w 24-godzinnym oknie UTC. Ten limit przydziału jest oddzielony od limitu dwugodzinnego dla pojedynczego wielodostępnego przebiegu.
Stabilny 2026-10-01 interfejs API uwidacznia dwa widoki środowiska uruchomieniowego:
| Właściwość odpowiedzi | Zakres i interpretacja |
|---|---|
Pobierz stan indeksatora: runtime.usedSeconds |
Sekundy używane przez ten indeksator w oknie odpowiedzi. |
Uzyskiwanie statystyk usługi: indexersRuntime.usedSeconds |
Liczba sekund wykorzystanych przez wszystkie indeksatory w usłudze w okresie odpowiedzi. |
Dowolny obiekt środowiska uruchomieniowego: remainingSeconds |
Pozostałe sekundy współużytkowane przez wszystkie indeksatory w usłudze, a nie budżet zarezerwowany dla jednego indeksatora. |
Dowolny obiekt środowiska wykonawczego: beginningTime, endingTime |
Granice 24-godzinnego okna ewidencjonowania UTC. Porównaj obserwacje z tego samego okna. |
Uzyskiwanie statystyk usługi: limits.maxCumulativeIndexerRuntimeSeconds |
Zgłoszono skumulowany limit usługi w sekundach. Ta właściwość odpowiedzi nie jest ustawiana przez klienta. |
Użyj tego samego uwierzytelniania, aby wywołać metodę Get Service Statistics:
GET https://<search-service-name>.search.windows.net/servicestats?api-version=2026-10-01
Authorization: Bearer <access-token>
Poniższy przykładowy fragment odpowiedzi HTTP 200 pokazuje 7 200 sekund wykorzystanych w całej usłudze oraz limit wynoszący 172 800 sekund (48 godzin). Inne statystyki usługi są pomijane:
{
"limits": {
"maxCumulativeIndexerRuntimeSeconds": 172800
},
"indexersRuntime": {
"usedSeconds": 7200,
"remainingSeconds": 165600,
"beginningTime": "2026-11-04T00:00:00Z",
"endingTime": "2026-11-05T00:00:00Z"
}
}
Aby porównać wykorzystanie jednego indeksatora z wykorzystaniem w skali całej usługi, wywołaj Get Indexer Status:
GET https://<search-service-name>.search.windows.net/indexers('<indexer-name>')/search.status?api-version=2026-10-01
Authorization: Bearer <token>
Poniższy przykładowy fragment odpowiedzi HTTP 200 pokazuje 3 600 sekund wykorzystanych przez ten indeksator w tym samym przedziale czasu, jak w przykładzie dla usługi. Inne pola stanu indeksatora zostały pominięte:
{
"runtime": {
"usedSeconds": 3600,
"remainingSeconds": 165600,
"beginningTime": "2026-11-04T00:00:00Z",
"endingTime": "2026-11-05T00:00:00Z"
}
}
3 600 użytych sekund tego indeksatora stanowi część 7 200 sekund użytych we wszystkich indeksatorach. Obie odpowiedzi podają tę samą liczbę 165 600 pozostałych sekund, ponieważ ten budżet jest współdzielony w ramach całej usługi. Wartość na indeksator runtime.remainingSeconds plus współdzielone runtime.usedSeconds nie muszą się równać limitowi usługi.
W stabilnym 2026-10-01 kontrakcie runtime i indexersRuntime są opcjonalne. Nie zakładaj, że każda usługa udostępnia te obiekty. Gdy obiekt jest obecny, usedSeconds, beginningTime i endingTime są wymagane.
remainingSeconds i limits.maxCumulativeIndexerRuntimeSeconds są opcjonalne i dopuszczane do wartości null. Jawnie obsługuj brakujące wartości, zamiast domyślnie ustawiać je na zero:
| Przykład odpowiedzi | Działanie monitorowania |
|---|---|
runtime lub indexersRuntime brakuje |
Pokaż dane środowiska uruchomieniowego jako niedostępne dla tej odpowiedzi, a nie jako zerowe użycie. |
remainingSeconds jest nieobecny lub null jest nieobecny w istniejącym obiekcie runtime |
Pokaż pozostały czas działania jako niedostępny, a nie jako zero lub budżet zarezerwowany dla tego indeksatora. Zachowaj raportowane użycie i okres. |
limits.maxCumulativeIndexerRuntimeSeconds jest nieobecny lub null |
Pokaż zgłoszony limit jako niedostępny, a nie zero. Nie obliczaj procentu przydziału bez znanego limitu. |
Te obserwacje służą do zarządzania limitami przydziału, a nie do obliczania opłat. Sekundy wykonywania nie są jednostkami obliczeniowymi. W przypadku kwalifikującego się płatnego wykonywania indeksatora bezserwerowego skoreluj zagregowane użycie zasobów obliczeniowych z historią uruchamiania; nagłówek odpowiedzi Run nie jest kompletnym rekordem rozliczeniowym dla pojedynczego uruchomienia.
Interpretacja wyników usługi Content Understanding
W przypadku potoku usługi Content Understanding sprawdź błędy na poziomie umiejętności i brakujące dane wyjściowe fragmentu, a także ogólny stan uruchomienia. Domyślne ośmiominutowe okno odpytywania analizy jest oddzielone od czasu wykonywania indeksatora. Limit czasu sondy nie musi powodować niepowodzenia całego przebiegu, a liczba przetworzonych dokumentów nie dowodzi, że każdy oczekiwany fragment został utworzony. Użyj narzędzia do rozwiązywania problemów z analizą Content Understanding przed ponowieniem próby wykonania pracy, która może spowodować naliczenie dodatkowych opłat.
Monitorowanie przy użyciu platformy .NET
Poniższy przykład w języku C# zapisuje informacje o stanie indeksatora i wynikach jego ostatniego (lub bieżącego) uruchomienia do konsoli.
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
}
}
Dane wyjściowe w konsoli wyglądają mniej więcej tak:
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
Zwróć uwagę, że istnieją dwie różne wartości stanu. Stan najwyższego poziomu to stan samego indeksatora. Stan indeksatora Uruchomiono oznacza, że indeksator jest poprawnie skonfigurowany i dostępny do wykonania, ale nie, że jest obecnie wykonywany.
Każdy przebieg indeksatora ma również swój własny status, który określa, czy dane wykonanie jest w toku (Uruchomiony), czy zostało już ukończone ze statusem Powodzenie lub TransientError.
Gdy indeksator zostanie zresetowany w celu odświeżenia stanu śledzenia zmian, zostanie dodany oddzielny wpis historii ze stanem Reset.
Dalsze kroki
Aby uzyskać więcej informacji na temat kodów stanu i informacji monitorowania indeksatora, zobacz następujące informacje dotyczące interfejsu API: