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, 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, 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 |
Funkcja SearchQueriesPerSecond 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.
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.
Wymiary metryk
Aby uzyskać informacje na temat wymiarów metryk, zobacz Metryki wielowymiarowe.
Usługa Azure AI Search ma następujące wymiary skojarzone z metrykami, które przechwytują liczbę wykonanych dokumentów lub umiejętności, "Liczba przetworzonych dokumentów" i "Liczba wywołań wykonywania umiejętności".
| 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 Administracja". |
| 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 Administracja | Każda operacja, która wymaga praw administracyjnych, jest rejestrowana jako operacja "Pobierz klucz Administracja". |
| Uzyskiwanie klucza zapytania | Każda operacja tylko do odczytu względem kolekcji dokumentów indeksu. |
| Ponowne generowanie klucza Administracja | Żą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 Administracja 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: 2020-06-30. |
| 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=2020-06-30. |
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 polecenia Dodaj, Aktualizuj lub Usuń dokumenty. |
| 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. |
| Skillsets.* | 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 .