dokumentacja danych monitorowania Wyszukiwanie AI platformy Azure

Note

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

Ten artykuł zawiera wszystkie informacje referencyjne dotyczące monitoringu tej usługi.

Zobacz Monitor Wyszukiwanie AI platformy Azure aby uzyskać szczegółowe informacje na temat danych, które można zbierać na potrzeby Wyszukiwanie AI platformy Azure i sposobu ich używania.

Wskaźniki

Ta sekcja zawiera listę wszystkich automatycznie zbieranych metryk platformy dla tej usługi. Te metryki są również częścią globalnej listy wszystkich wskaźników platform obsługiwanych w Azure Monitor.

Informacje o retencji metryki można znaleźć w przeglądzie usługi Azure Monitor Metrics.

Obsługiwane metryki dla Microsoft Search/searchServices

W poniższej tabeli wymieniono metryki dostępne dla typu zasobu Microsoft.Search/searchServices.

  • Wszystkie kolumny mogą nie być obecne we wszystkich tabelach.
  • Niektóre kolumny mogą znajdować się poza obszarem widoku strony. Wybierz Rozwiń tabelę , aby zobaczyć wszystkie dostępne kolumny.

Nagłówki tabeli

  • Kategoria – Grupa metryk lub klasyfikacja.
  • Metryka - Nazwa metryki wyświetlana w portalu Azure.
  • Nazwa w REST API – Nazwa metryki wspomniana w REST API.
  • Jednostka – jednostka miary.
  • Agregacja – Domyślny typ agregacji . Wartości: Średnia (Śr.), Minimalna (Min), Maksymalna (Maks), Suma (Suma), Ilość.
  • Wymiary - Dostępne wymiary dla metryki.
  • Rozdzielczość czasowa - Interwały, w których metryka jest próbkowana. Na przykład oznacza, PT1M że metryka jest próbkowana co minutę, PT30M co 30 minut, PT1H co godzinę i tak dalej.
  • DS Export – Czy metryka jest eksportowalna do Azure Monitor Logs przez ustawienia diagnostyczne. Aby uzyskać informacje o eksporcie metryk, zobacz Utwórz ustawienia diagnostyczne w Azure Monitor.
Metryka Nazwa w REST API Zaawansowane metryki platformy Jednostki Agregacja Wymiary Ziarna czasu Eksport DS
Pliki przetworzone przez indeksator (bajty)

Łączna liczba bajtów danych źródłowych przetwarzanych przez indeksatory z źródła danych opartego na plikach (np. Blob, ADLS Gen2, File, SharePoint, OneLake)
DocumentsProcessedBytes Nie Bytes Całkowita (suma), średnia DataSourceName, IndexerName, IndexName PT1M Tak
Liczba przetworzonych dokumentów

Liczba przetworzonych dokumentów
DocumentsProcessedCount Nie Liczba Suma (Suma), Liczba DataSourceName, Failed, , IndexerName, IndexNameSkillsetName PT1M Tak
Użycie magazynu

Użycie magazynu (tekst i wektor) dla usługi wyszukiwania według indeksu
IndexStorageUsage Nie Bytes Średnia, Maksimum, Minimum IndexName PT1M Tak
Użycie magazynu wektorowego

Wykorzystanie magazynu wektorów w usłudze wyszukiwania według indeksu
IndexVectorUsage Nie Bytes Średnia, Maksimum, Minimum IndexName PT1M Tak
Używane jednostki obliczeniowe

Jednostki obliczeniowe zużywane przez operacje usługi wyszukiwania i okna utrzymywania indeksu w gotowości, wyrażone w mikro-CU-godzinach (podziel sumę przez 1 000 000, aby uzyskać CU-godziny). Filtr stanu jest przestarzały.
PerRequestComputeConsumption Nie Liczba Całkowita (suma), średnia Status, , IndexName, , ResourceKindEventType PT1M Tak
Opóźnienie wyszukiwania

Średnie opóźnienie wyszukiwania dla usługi wyszukiwania
SearchLatency Nie Sekund Średnia <Brak> PT1M Tak
Zapytania wyszukiwania na sekundę

Zapytania wyszukiwania na sekundę dla usługi wyszukiwania
SearchQueriesPerSecond Nie LiczbaNaSekundę Średnia <Brak> PT1M Tak
Liczba uruchomień działania funkcji

Liczba wykonań umiejętności
SkillExecutionCount Nie Liczba Suma (Suma), Liczba DataSourceName, , Failed, IndexerName, SkillName, , SkillsetNameSkillType PT1M Tak
Procent zapytań wyszukiwania z ograniczeniami

Procent zapytań wyszukiwania, które zostały ograniczone dla usługi wyszukiwania
ThrottledSearchQueriesPercentage Nie Procent Średnia <Brak> PT1M Tak

Zapytania wyszukiwania na sekundę

Ta metryka przedstawia średnią zapytań wyszukiwania na sekundę (QPS) dla usługi wyszukiwania. Często zapytania są wykonywane w milisekundach, więc w metryce takiej jak QPS pojawiają się tylko zapytania, które miarują się w sekundach. Wartość minimalna to najniższa wartość zapytań wyszukiwania na sekundę, która została zarejestrowana w tej chwili. Wartość maksymalna to najwyższa wartość. Średnia to agregacja w ciągu całej minuty.

Typ agregacji Opis
Średnia Średnia liczba sekund w ciągu minuty, w której wystąpiło wykonanie zapytania.
Liczba Liczba metryk zapisanych do dziennika w ciągu jednej minuty.
Maksimum Największa liczba zapytań wyszukiwania na sekundę zarejestrowanych w ciągu minuty.
Minimalne Najniższa liczba zapytań wyszukiwania na sekundę zarejestrowanych w ciągu minuty.
Suma Suma wszystkich zapytań wykonanych w ciągu minuty.

Na przykład w ciągu jednej minuty może istnieć wzorzec podobny do następującego: jedna sekunda dużego obciążenia, która jest maksymalną wartością dla parametru SearchQueriesPerSecond, a następnie 58 sekund średniego obciążenia, a na koniec jedną sekundę z tylko jednym zapytaniem, co jest minimum.

Inny przykład: jeśli węzeł emituje 100 metryk, gdzie wartość każdej metryki wynosi 40, wartość "Count" to 100, "Sum" to 4000, "Average" to 40, a wartość "Max" to 40.

Opóźnienie wyszukiwania

Opóźnienie wyszukiwania wskazuje, jak długo trwa ukończenie zapytania.

Typ agregacji Opóźnienie
Średnia Średni czas trwania zapytania w milisekundach.
Liczba Liczba metryk zapisanych do dziennika w ciągu jednej minuty.
Maksimum Najdłużej działające zapytanie w próbce.
Minimalne Najkrótsze uruchomione zapytanie w przykładzie.
Łącznych Łączny czas wykonywania wszystkich zapytań w próbce, wykonywanych w ciągu (jednej minuty).

Odsetek ograniczonych zapytań wyszukiwania

Ta metryka odwołuje się do zapytań porzuconych zamiast przetworzonych. Ograniczanie występuje, gdy liczba żądań w wykonaniu przekracza zasoby. Możesz zauważyć wzrost liczby żądań ograniczanych, gdy replika zostanie wyłączona z rotacji lub podczas indeksowania. Żądania zapytań i indeksowania są obsługiwane przez ten sam zestaw zasobów.

Usługa określa, czy żądania mają być porzucane na podstawie użycia zasobów. Procent zużycia zasobów dla pamięci, CPU i operacji we/wy na dysku jest uśredniany w określonym czasie. Jeśli ta wartość procentowa przekroczy próg, wszystkie żądania do indeksu są ograniczane do momentu zmniejszenia liczby żądań.

W zależności od klienta ograniczone żądanie jest wskazywane na następujące sposoby:

  • Usługa zwraca błąd "You are sending too many requests. Please try again later."
  • Usługa zwraca kod błędu 503 wskazujący, że usługa jest obecnie niedostępna.
  • Jeśli używasz portalu Azure (na przykład Eksploratora wyszukiwania), zapytanie zostanie usunięte w trybie dyskretnym i musisz wybrać pozycję Search ponownie.

Aby potwierdzić ograniczenie zapytań, użyj metryki Ograniczone zapytania wyszukiwania. Metryki można eksplorować w portalu Azure lub utworzyć metrykę alertu zgodnie z opisem w tym artykule. W przypadku zapytań, które zostały porzucone w interwale próbkowania, użyj Suma, aby uzyskać procent zapytań, które nie zostały wykonane.

Typ agregacji Ograniczanie
Średnia Procent zapytań porzuconych w interwale.
Liczba Liczba metryk zapisanych do dziennika w ciągu jednej minuty.
Maksimum Procent zapytań porzuconych w interwale.
Minimalne Procent zapytań porzuconych w interwale.
Łącznych Procent zapytań porzuconych w interwale.

W przypadku odsetka zapytań wyszukiwania z ograniczeniami, minimalna, maksymalna, średnia i całkowita wartość są takie same: procent zapytań wyszukiwania, które zostały ograniczone, z łącznej liczby zapytań wyszukiwania w ciągu jednej minuty.

Użycie jednostek obliczeniowych

Ta metryka mierzy zasoby obliczeniowe, pamięć i zasoby wejścia/wyjścia zużywane przez usługę Wyszukiwanie AI platformy Azure, wyrażone w miliobliczeniowych jednostkach obliczeniowych (mCU). Służy jako serwer proxy dla kosztu przetwarzania różnych typów operacji. Użycie może się różnić w czasie w zależności od wykonywanych operacji.

Tę metryę można wyświetlić na dwóch poziomach:

  • Poziom usługi wyszukiwania: zagregowane użycie zasobów obliczeniowych w całej usłudze.
  • Poziom indeksu: Użycie ograniczone do określonego indeksu, przydatne do identyfikowania indeksów, które napędzają największe użycie zasobów.
Typ agregacji Opis
Sum Łączna liczba jednostek mCU użytych w wybranym interwale czasu. Przydatne do zrozumienia ogólnych kosztów obliczeń w czasie.
Średnia Średnia liczba zużytych jednostek mCU w wybranym przedziale czasu.

Ta metryka obsługuje następujące filtry:

  • Nazwa indeksu: filtruje metrykę do określonego indeksu. Jeśli żaden filtr nie zostanie zastosowany, metryka odzwierciedla całkowite zużycie we wszystkich indeksach w usłudze.

  • Nazwa operacji: filtruje metryki według operacji przyczyniającej się do użycia zasobów obliczeniowych. Jeśli filtr nie zostanie zastosowany, metryka odzwierciedla łączne zużycie we wszystkich typach operacji. Aby uzyskać informacje o obsługiwanych wartościach, zobacz Monitoring Data Reference (Dokumentacja danych monitorowania).

Wymiary metryczne

Aby uzyskać informacje o wymiarach metrycznych, zobacz metryki wielowymiarowe.

Wyszukiwanie AI platformy Azure ma wymiary skojarzone z następującymi metrykami, które przechwytują liczbę wykonanych dokumentów lub umiejętności.

Nazwa metryki Opis Wymiary Przykładowe przypadki użycia
Liczba przetworzonych dokumentów Pokazuje liczbę przetworzonych dokumentów indeksatora. Nazwa źródła danych, niepowodzenie, nazwa indeksu, nazwa indeksatora, nazwa zestawu umiejętności Może być użyte jako przybliżona miara przepustowości (liczba dokumentów przetwarzanych przez indeksator w czasie)
— Konfigurowanie alertu dotyczącego dokumentów, które zakończyły się niepowodzeniem
Liczba uruchomień działania funkcji Pokazuje liczbę wywołań umiejętności. Nazwa źródła danych, niepowodzenie, nazwa indeksu, nazwa indeksatora, nazwa umiejętności, typ umiejętności, nazwa zestawu umiejętności Odniesienie pozwalające upewnić się, że umiejętności są wywoływane zgodnie z oczekiwaniami poprzez porównanie względnej liczby wywołań między umiejętnościami oraz liczby wywołań umiejętności z liczbą dokumentów.
— Konfigurowanie alertu dotyczącego wywołań umiejętności, które zakończyły się niepowodzeniem
Użycie jednostek obliczeniowych Pokazuje jednostki mCU zużywane przez operacje w usłudze wyszukiwania Nazwa indeksu, Operacja Oceń, która operacja zużywa najwięcej zasobów obliczeniowych.
-Skonfiguruj alerty, gdy zużycie urobku przekroczy oczekiwane progi dla danego typu operacji
Nazwa wymiaru Opis
DataSourceName Nazwane połączenie ze źródłem danych używane podczas wykonywania indeksatora. Prawidłowe wartości są jednym z obsługiwanych typów źródeł danych.
Nie powiodło się Wskazuje, czy wystąpienie nie powiodło się.
IndexerName Nazwa indeksatora.
Nazwa indeksu Nazwa indeksu.
Nazwa zestawu umiejętności Nazwa zestawu umiejętności wykorzystywanego podczas wykonywania indeksacji.
SkillName Nazwa umiejętności w zestawie umiejętności.
Typ umiejętności Umiejętności @odata.type .

Dzienniki zasobów

Ta sekcja zawiera listę rodzajów dzienników zasobów, które możesz zbierać dla tej usługi. Sekcja ta pobiera z listy wszystkich typów kategorii dzienników zasobów obsługiwanych w Azure Monitor.

Obsługiwane dzienniki zasobów dla Microsoft. Search/searchServices

Kategoria Koszty eksportu Tabela logów Obsługuje podstawowy plan logowania Wspiera transformację w czasie przetwarzania danych Przykładowe zapytania
Dzienniki operacji Nie AzureDiagnostics

Logi z wielu różnych zasobów Azure.

Nie Nie

Tabele dzienników Azure Monitor

Ta sekcja zawiera tabele Azure Monitor Logs istotne dla tej usługi, które są dostępne do zapytań przez Log Analytics za pomocą zapytań Kusto. Tabele zawierają dane z dziennika zasobów, a być może także więcej, w zależności od tego, co jest zbierane i kierowane do nich.

Usługi wyszukiwania

Microsoft.Search/searchServices

Tabeli Opis
AzureActivity Wpisy z dziennika aktywności Azure zapewniają wgląd w operacje płaszczyzny sterowania. Zadania wywoływane na płaszczyźnie sterowania, takie jak dodawanie lub usuwanie replik i partycji, są reprezentowane za pomocą działania "Pobierz klucz administratora".
AzureDiagnostics Zarejestrowane operacje zapytań i indeksowania. Zapytania względem tabeli AzureDiagnostics w Log Analytics mogą zawierać typowe właściwości, właściwości specyficzne dla wyszukiwania oraz operacje specyficzne dla wyszukiwania wymienione w sekcji referencyjnej schematu.
AzureMetrics Dane metryk emitowane przez Wyszukiwanie AI platformy Azure, które mierzy kondycję i wydajność.

Tabele logów zasobów

W poniższej tabeli wymieniono właściwości dzienników zasobów w Wyszukiwanie AI platformy Azure. Dzienniki zasobów są zbierane w dziennikach Azure Monitor lub Azure Storage. W Azure Monitor dzienniki są zbierane w tabeli AzureDiagnostics pod nazwą dostawcy zasobów Microsoft.Search.

Azure Storage pole lub właściwość właściwość dzienników Azure Monitor Opis
Czas ZNACZNIK CZASU Data i godzina (UTC) podczas operacji.
resourceId Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) Zasób Wyszukiwanie AI platformy Azure, dla którego są włączone dzienniki.
kategoria "Dzienniki operacji" Kategorie dzienników obejmują Audit, Operational, Execution i Request.
nazwaOperacji Nazwa Nazwa operacji. Nazwa operacji może być Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Indexers.List, Query.Search, Query.Suggest, Query.Lookup, Query.Autocomplete, CORS.Preflight, Indexes.Update, Indexes.Prototype, ServiceStats, DataSources.List, Indexers.Warmup.
durationMS CzasTrwaniaMilisekundy Czas trwania operacji w milisekundach.
wersjaOperacji ApiVersion Wersja interfejsu API używana w żądaniu.
TypWyniku (Niepowodzenie) ? "Nieudany" : "Sukces" Typ odpowiedzi.
sygnatura wyniku Stan Status odpowiedzi HTTP operacji.
Właściwości Właściwości Wszelkie właściwości rozszerzone związane z tą kategorią zdarzeń.

Dziennik aktywności

Powiązana tabela zawiera operacje, które można zarejestrować w dzienniku aktywności tej usługi. Operacje te stanowią podzbiór wszystkich możliwych operacji dostawcy zasobów w dzienniku aktywności.

Więcej informacji na temat schematu wpisów dziennika aktywności można znaleźć w Schemat Dziennika Aktywności.

W poniższej tabeli wymieniono typowe operacje związane z Wyszukiwanie AI platformy Azure, które mogą być rejestrowane w dzienniku aktywności. Aby uzyskać pełną listę wszystkich operacji Microsoft.Search, zobacz operacje dostawcy zasobów Microsoft.Search.

Operacja Opis
Uzyskiwanie klucza administratora Każda operacja, która wymaga uprawnień administracyjnych, jest rejestrowana jako operacja "Pobierz klucz administratora".
Uzyskiwanie klucza zapytania Każda operacja względem kolekcji dokumentów indeksu, która jest tylko do odczytu.
Ponowne generowanie klucza administratora Żądanie ponownego wygenerowania klucza podstawowego lub pomocniczego interfejsu API administratora.

Typowe wpisy obejmują odwołania do kluczy interfejsu API — ogólne powiadomienia informacyjne, takie jak Pobieranie klucza administratora i Uzyskiwanie kluczy zapytań. Te działania wskazują żądania, które zostały wykonane przy użyciu klucza administratora (tworzenia lub usuwania obiektów) lub klucza zapytania, ale nie pokazują samego żądania. Aby uzyskać informacje o tym ziarnie, należy skonfigurować rejestrowanie zasobów.

Alternatywnie możesz uzyskać wgląd w historię zmian. W portalu Azure wybierz działanie, aby otworzyć stronę szczegółów, a następnie wybierz pozycję "Historia zmian", aby uzyskać informacje o operacji bazowej.

Inne schematy

W tej usłudze są używane następujące schematy.

Jeśli tworzysz zapytania lub raporty niestandardowe, struktury danych zawierające dzienniki zasobów Wyszukiwanie AI platformy Azure są zgodne z następującymi schematami.

W przypadku dzienników zasobów wysyłanych do magazynu blob, każdy blob ma jeden obiekt główny o nazwie rekordy, zawierający tablicę obiektów dziennika. Każdy blob zawiera rekordy wszystkich operacji, które miały miejsce w tej samej godzinie.

Schemat dziennika zasobów

Wszystkie dzienniki zasobów dostępne za pośrednictwem Azure Monitor mają wspólny schemat najwyższego poziomu. Wyszukiwanie AI platformy Azure uzupełnia o dodatkowe właściwości i operacje które są unikatowe dla usługi wyszukiwania.

Poniższy przykład ilustruje dziennik zasobów, który zawiera typowe właściwości (TimeGenerated, Resource, Category itd.) i właściwości specyficzne dla wyszukiwania (OperationName i OperationVersion).

Nazwa Typ Opis i przykład
TimeGenerated Data i czas Sygnatura czasowa operacji. Na przykład: 2021-12-07T00:00:43.6872559Z
Zasobów Ciąg Identyfikator zasobu. Na przykład: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Kategoria Ciąg "OperationLogs". Ta wartość jest stałą. OperationLogs to jedyna kategoria używana dla dzienników zasobów.
OperationName Ciąg Nazwa operacji (zobacz pełną listę operacji). Przykład: Query.Search
OperationVersion Ciąg Wersja interfejsu API używana w żądaniu. Na przykład: 2026-04-01
Resulttype Ciąg "Powodzenie". Inne możliwe wartości: Powodzenie lub Niepowodzenie
ResultSignature Int Kod wyniku HTTP. Na przykład: 200
Czas trwania (w ms) Int Czas trwania operacji w milisekundach.
Właściwości Obiektu Obiekt zawierający dane specyficzne dla operacji. Zobacz poniższą tabelę schematu właściwości.

Schemat właściwości

Następujące właściwości są specyficzne dla Wyszukiwanie AI platformy Azure.

Nazwa Typ Opis i przykład
Opis_s Ciąg Punkt końcowy operacji. Na przykład: GET /indexes('content')/docs
Dokumenty_d Int Liczba przetworzonych dokumentów.
IndexName_s Ciąg Nazwa indeksu skojarzonego z operacją.
Zapytanie_s Ciąg Parametry zapytania używane w żądaniu. Na przykład: ?search=beach access&$count=true&api-version=2026-04-01

Wartości OperationName (zarejestrowane operacje)

Następujące operacje mogą pojawić się w dzienniku zasobów.

OperationName Opis
DataSources.* Dotyczy źródeł danych indeksatora. Może to być tworzenie, usuwanie, pobieranie, lista.
DebugSessions.* Dotyczy sesji debugowania. Może to być Tworzenie, Usuwanie, Pobieranie, Listowanie, Uruchamianie i Stan.
DebugSessions.DocumentStructure Wzbogacony dokument jest ładowany do sesji debugowania.
DebugSessions.RetrieveIndexerExecutionHistoricalData Żądanie szczegółów wykonywania indeksatora.
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData Historia wykonywania dla wzbogaceń przewidywanych w magazynie wiedzy.
Indeksatory. Dotyczy indeksatora. Może być Create, Delete, Get, List i Status.
Indeksy.* Dotyczy indeksu wyszukiwania. Może to być tworzenie, usuwanie, pobieranie, lista.
Indeksy. Prototyp Metadane indeksu są definiowane przez kreatora importu danych na podstawie danych wejściowych.
Indeksowanie.Indeks Ta operacja jest wywołaniem Indeksowania Dokumentów.
Metadata.GetMetadata Żądanie danych systemu usługi wyszukiwania.
Query.Autocomplete Autouzupełnianie zapytania względem indeksu. Zobacz Typy zapytań i kompozycja.
Query.Lookup Zapytanie wyszukiwania do indeksu. Zobacz Typy zapytań i kompozycja.
Zapytanie.Szukaj Żądanie wyszukiwania pełnotekstowego względem indeksu. Zobacz Typy zapytań i kompozycja.
Query.Suggest Wpisz zapytanie z wyprzedzeniem względem indeksu. Zobacz Typy zapytań i kompozycja.
ServiceStats Ta operacja to rutynowe wywołanie funkcji Pobieranie statystyk usługi, wywoływane bezpośrednio lub niejawnie w celu wypełnienia strony przeglądu portalu po załadowaniu lub odświeżeniu.
Zestaw umiejętności.* Dotyczy zestawu umiejętności. Może to być tworzenie, usuwanie, pobieranie, lista.