Dokumentacja danych monitorowania usługi Azure AI Search
Ten artykuł zawiera wszystkie informacje referencyjne dotyczące monitorowania tej usługi.
Zobacz Monitorowanie usługi Azure AI Search , aby uzyskać szczegółowe informacje na temat danych, które można zbierać w usłudze Azure AI Search i jak z niej korzystać.
Metryki
W tej sekcji wymieniono wszystkie automatycznie zebrane metryki platformy dla tej usługi. Te metryki są również częścią globalnej listy wszystkich metryk platformy obsługiwanych w usłudze Azure Monitor.
Aby uzyskać informacje na temat przechowywania metryk, zobacz Omówienie metryk usługi Azure Monitor.
Obsługiwane metryki dla usługi Microsoft.Search/searchServices
W poniższej tabeli wymieniono metryki dostępne dla typu zasobu Microsoft.Search/searchServices.
- Wszystkie kolumny mogą nie być obecne w każdej tabeli.
- Niektóre kolumny mogą wykraczać poza obszar wyświetlania strony. Wybierz pozycję Rozwiń tabelę , aby wyświetlić wszystkie dostępne kolumny.
Nagłówki tabeli
- Kategoria — grupa metryk lub klasyfikacja.
- Metryka — nazwa wyświetlana metryki wyświetlana wyświetlana w witrynie Azure Portal.
- Nazwa w interfejsie API REST — nazwa metryki określona w interfejsie API REST.
- Jednostka — jednostka miary.
- Agregacja — domyślny typ agregacji. Prawidłowe wartości: Średnia (średnia), Minimalna (Minimalna), Maksymalna (Maksymalna), Łączna (Suma), Liczba.
- - Wymiary dostępne dla metryki.
- Interwały ziarna - czasu, w których próbkowana jest metryka. Na przykład wskazuje,
PT1Mże metryka jest próbkowana co minutę,PT30Mco 30 minut,PT1Hco godzinę itd. - Eksportowanie ds — określa, czy metryka jest eksportowana do dzienników usługi Azure Monitor za pośrednictwem ustawień diagnostycznych. Aby uzyskać informacje na temat eksportowania metryk, zobacz Tworzenie ustawień diagnostycznych w usłudze Azure Monitor.
| Metric | Nazwa w interfejsie API REST | Jednostka | Agregacja | Wymiary | Ziarna czasu | Eksportowanie ds |
|---|---|---|---|---|---|---|
| Liczba przetworzonych dokumentów Liczba przetworzonych dokumentów |
DocumentsProcessedCount |
Count | Suma (suma), liczba | DataSourceName, , Failed, IndexerName, , IndexNameSkillsetName |
PT1M | Tak |
| Opóźnienie wyszukiwania Średnie opóźnienie wyszukiwania dla usługi wyszukiwania |
SearchLatency |
Sekundy | Średnia | <none> | PT1M | Tak |
| Zapytania wyszukiwania na sekundę Zapytania wyszukiwania na sekundę dla usługi wyszukiwania |
SearchQueriesPerSecond |
CountPerSecond | Średnia | <none> | PT1M | Tak |
| Liczba wywołań wykonywania umiejętności Liczba wykonań umiejętności |
SkillExecutionCount |
Count | 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 |
Procent | Średnia | <none> | 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. |
| Count | Liczba metryk emitowanych do dziennika w ciągu jednej minuty. |
| Maksymalnie | Największa liczba zapytań wyszukiwania na sekundę zarejestrowanych w ciągu minuty. |
| Minimum | Najniższa liczba zapytań wyszukiwania na sekundę zarejestrowanych w ciągu minuty. |
| Sum | 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. |
| Count | Liczba metryk emitowanych do dziennika w ciągu jednej minuty. |
| Maksymalnie | Najdłuższe uruchomione zapytanie w przykładzie. |
| Minimum | Najkrótsze uruchomione zapytanie w przykładzie. |
| Łącznie | Łączny czas wykonywania wszystkich zapytań w przykładzie, wykonywany w interwale (minuta). |
Procent zapytań wyszukiwania z ograniczeniami
Ta metryka odwołuje się do zapytań porzuconych zamiast przetworzonych. Ograniczanie występuje, gdy liczba żądań w wykonaniu przekracza pojemność. Może wystąpić wzrost liczby żądań ograniczonych, gdy replika zostanie wyjęta 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żywanych zasobów w pamięci, procesora CPU i operacji we/wy dysku jest średni w danym okresie. 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 żądanie ograniczone jest wskazane 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 witryny Azure Portal (na przykład Eksploratora wyszukiwania), zapytanie zostanie porzucone w trybie dyskretnym i musisz ponownie wybrać pozycję Wyszukaj .
Aby potwierdzić ograniczone zapytania, użyj metryki Zapytania wyszukiwania z ograniczeniami. Metryki można eksplorować w witrynie Azure Portal lub utworzyć metrykę alertu zgodnie z opisem w tym artykule. W przypadku zapytań, które zostały porzucone w interwale próbkowania, użyj opcji Suma , aby uzyskać procent zapytań, które nie zostały wykonane.
| Typ agregacji | Ograniczanie przepływności |
|---|---|
| Średnia | Procent zapytań porzuconych w interwale. |
| Count | Liczba metryk emitowanych do dziennika w ciągu jednej minuty. |
| Maksymalnie | Procent zapytań porzuconych w interwale. |
| Minimum | Procent zapytań porzuconych w interwale. |
| Łącznie | Procent zapytań porzuconych w interwale. |
W przypadku kwerend wyszukiwania z ograniczeniami wartość procentowa, minimalna, maksymalna, średnia i suma mają tę samą wartość: procent zapytań wyszukiwania, które zostały ograniczone, z łącznej liczby zapytań wyszukiwania w ciągu jednej minuty.
Wymiary metryk
Aby uzyskać informacje na temat wymiarów metryk, zobacz Metryki wielowymiarowe.
Usługa Azure AI Search 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żna odwoływać się jako przybliżoną miarę przepływności (liczba dokumentów przetwarzanych przez indeksator w czasie) — Konfigurowanie alertu dotyczącego dokumentów, które zakończyły się niepowodzeniem |
| Liczba wywołań wykonywania umiejętności | 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 do zapewnienia, że umiejętności są wywoływane zgodnie z oczekiwaniami, porównując względne liczby wywołań między umiejętnościami i liczbą wywołań umiejętności do liczby dokumentów. — Konfigurowanie alertu dotyczącego wywołań umiejętności, które zakończyły się niepowodzeniem |
| 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 działa | 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 używanego podczas wykonywania indeksatora. |
| SkillName | Nazwa umiejętności w zestawie umiejętności. |
| Typ umiejętności | Umiejętności @odata.type . |
Dzienniki zasobów
W tej sekcji wymieniono typy dzienników zasobów, które można zbierać dla tej usługi. Sekcja pobiera z listy wszystkich typów kategorii dzienników zasobów obsługiwanych w usłudze Azure Monitor.
Obsługiwane dzienniki zasobów dla usługi Microsoft.Search/searchServices
| Kategoria | Nazwa wyświetlana kategorii | Tabela dzienników | Obsługuje podstawowy plan dziennika | Obsługuje transformację czasu pozyskiwania | Przykładowe zapytania | Koszty eksportowania |
|---|---|---|---|---|---|---|
OperationLogs |
Dzienniki operacji | AzureDiagnostics Dzienniki z wielu zasobów platformy Azure. |
Nie | Nie. | Nie. |
Tabele dzienników usługi Azure Monitor
W tej sekcji wymieniono tabele dzienników usługi Azure Monitor dotyczące tej usługi, które są dostępne do wykonywania zapytań przez usługę Log Analytics przy użyciu zapytań Kusto. Tabele zawierają dane dziennika zasobów i prawdopodobnie więcej w zależności od tego, co jest zbierane i kierowane do nich.
Usługi wyszukiwania
Microsoft.Search/searchServices
| Table | opis |
|---|---|
| AzureActivity | Wpisy z dziennika aktywności platformy 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 usłudze Log Analytics mogą zawierać typowe właściwości, właściwości specyficzne dla wyszukiwania i operacje specyficzne dla wyszukiwania wymienione w sekcji odwołania do schematu. |
| AzureMetrics | Dane metryk emitowane przez usługę Azure AI Search, które mierzy kondycję i wydajność. |
Tabele dzienników zasobów
W poniższej tabeli wymieniono właściwości dzienników zasobów w usłudze Azure AI Search. Dzienniki zasobów są zbierane w dziennikach usługi Azure Monitor lub usłudze Azure Storage. W usłudze Azure Monitor dzienniki są zbierane w tabeli AzureDiagnostics pod nazwą Microsoft.Searchdostawcy zasobów .
| Pole lub właściwość usługi Azure Storage | Właściwość Dzienniki usługi Azure Monitor | opis |
|---|---|---|
| time | TIMESTAMP | Data i godzina (UTC) podczas operacji. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | Zasób usługi Azure AI Search, dla którego włączono dzienniki. |
| category | "Dzienniki operacji" | Kategorie dzienników obejmują Audit, , OperationalExecutioni Request. |
| operationName | Nazwisko | Nazwa operacji. Nazwa operacji może mieć Indexes.ListIndexStatsSummarieswartość , Indexes.GetIndexers.ListQuery.SearchQuery.SuggestIndexes.UpdateQuery.AutocompleteQuery.LookupIndexes.StatsIndexes.PrototypeServiceStatsCORS.Preflight, . Indexers.WarmupDataSources.List |
| durationMS | DurationMilliseconds | Czas trwania operacji w milisekundach. |
| operationVersion | ApiVersion | Wersja interfejsu API używana w żądaniu. |
| resultType | (Niepowodzenie) ? "Niepowodzenie": "Powodzenie" | Typ odpowiedzi. |
| resultSignature | Stan | Stan 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
Tabela połączona zawiera listę operacji, które można zarejestrować w dzienniku aktywności dla tej usługi. Te operacje są podzbiorem wszystkich możliwych operacji dostawcy zasobów w dzienniku aktywności.
Aby uzyskać więcej informacji na temat schematu wpisów dziennika aktywności, zobacz Schemat dziennika aktywności.
W poniższej tabeli wymieniono typowe operacje związane z usługą Azure AI Search, 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.
| Działanie | 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 tylko do odczytu względem kolekcji dokumentów indeksu. |
| 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 witrynie Azure Portal wybierz działanie, aby otworzyć stronę szczegółów, a następnie wybierz pozycję "Historia zmian", aby uzyskać informacje o podstawowej operacji.
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 usługi Azure AI Search są zgodne z następującymi schematami.
W przypadku dzienników zasobów wysyłanych do magazynu obiektów blob każdy obiekt blob ma jeden obiekt główny o nazwie rekordy zawierające tablicę obiektów dziennika. Każdy obiekt blob zawiera rekordy dla wszystkich operacji, które miały miejsce w ciągu tej samej godziny.
Schemat dziennika zasobów
Wszystkie dzienniki zasobów dostępne za pośrednictwem usługi Azure Monitor mają wspólny schemat najwyższego poziomu. Usługa Azure AI Search uzupełnia o więcej właściwości i operacji , 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).
| Nazwisko | Typ | Opis i przykład |
|---|---|---|
| TimeGenerated | Datetime | Sygnatura czasowa operacji. Na przykład: 2021-12-07T00:00:43.6872559Z. |
| Zasób | String | Identyfikator zasobu. Na przykład: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>. |
| Kategoria | String | "OperationLogs". Ta wartość jest stałą. OperationLogs to jedyna kategoria używana dla dzienników zasobów. |
| OperationName | String | Nazwa operacji (zobacz pełną listę operacji). Przykład: Query.Search |
| OperationVersion | String | Wersja interfejsu API używana w żądaniu. Na przykład: 2024-07-01. |
| ResultType | String | "Powodzenie". Inne możliwe wartości: Powodzenie lub Niepowodzenie |
| ResultSignature | Int | Kod wyniku HTTP. Na przykład: 200. |
| Czas trwania | Int | Czas trwania operacji w milisekundach. |
| Właściwości | Objekt | Obiekt zawierający dane specyficzne dla operacji. Zobacz poniższą tabelę schematu właściwości. |
Schemat właściwości
Poniższe właściwości są specyficzne dla usługi Azure AI Search.
| Nazwisko | Typ | Opis i przykład |
|---|---|---|
| Description_s | String | Punkt końcowy operacji. Na przykład: GET /indexes('content')/docs. |
| Documents_d | Int | Liczba przetworzonych dokumentów. |
| IndexName_s | String | Nazwa indeksu skojarzonego z operacją. |
| Query_s | String | Parametry zapytania używane w żądaniu. Na przykład: ?search=beach access&$count=true&api-version=2024-07-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, lista, 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 to być tworzenie, usuwanie, pobieranie, wyświetlanie listy i stan. |
| Indeksy.* | Dotyczy indeksu wyszukiwania. Może to być tworzenie, usuwanie, pobieranie, lista. |
| Indeksy. Prototyp | Ten indeks jest tworzony przez kreatora importu danych. |
| Indexing.Index | 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 odnośnika względem indeksu. Zobacz Typy zapytań i kompozycja. |
| Query.Search | Żą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. |
| Zestawy umiejętności.* | Dotyczy zestawu umiejętności. Może to być tworzenie, usuwanie, pobieranie, lista. |
Powiązana zawartość
- Zobacz Monitorowanie usługi Azure AI Search , aby zapoznać się z opisem monitorowania usługi Azure AI Search.
- Aby uzyskać szczegółowe informacje na temat monitorowania zasobów platformy Azure, zobacz Monitorowanie zasobów platformy Azure za pomocą usługi Azure Monitor .