Azure AI Search izleme verileri başvurusu

Bu makale, bu hizmetin tüm izleme başvuru bilgilerini içerir.

Azure AI Search için toplayabileceğiniz veriler ve nasıl kullanılacağı hakkında ayrıntılı bilgi için bkz. Azure Yapay Zeka Arama'yı izleme.

Ölçümler

Bu bölümde, bu hizmet için otomatik olarak toplanan tüm platform ölçümleri listelenir. Bu ölçümler, Azure İzleyici'de desteklenen tüm platform ölçümlerinin genel listesinin de bir parçasıdır.

Ölçüm saklama hakkında bilgi için bkz . Azure İzleyici Ölçümlerine genel bakış.

Microsoft.Search/searchServices için desteklenen ölçümler

Aşağıdaki tabloda, Microsoft.Search/searchServices kaynak türü için kullanılabilen ölçümler listelanmaktadır.

  • Tüm sütunlar her tabloda mevcut olmayabilir.
  • Bazı sütunlar sayfanın görüntüleme alanının dışında olabilir. Kullanılabilir tüm sütunları görüntülemek için Tabloyu genişlet'i seçin.

Tablo başlıkları

  • Kategori - Ölçüm grubu veya sınıflandırma.
  • Ölçüm - Azure portalında göründüğü şekilde ölçüm görünen adı.
  • REST API'deki ad - REST API'de bahsedilen ölçüm adı.
  • Birim - Ölçü birimi.
  • Toplama - Varsayılan toplama türü. Geçerli değerler: Ortalama (Ortalama), Minimum (Min), Maksimum (Maksimum), Toplam (Toplam), Sayı.
  • - Ölçüm için kullanılabilen Boyutlar Boyutları.
  • Ölçümün örneklendiği Zaman Dilimleri - Aralıkları. Örneğin, PT1M ölçümün dakikada bir, 30 dakikada bir, PT30M PT1H saatte bir vb. örneklendiğini gösterir.
  • DS Dışarı Aktarma- Ölçümün tanılama ayarları aracılığıyla Azure İzleyici Günlüklerine aktarılıp aktarılmayacağı. Ölçümleri dışarı aktarma hakkında bilgi için bkz . Azure İzleyici'de tanılama ayarları oluşturma.
Metric REST API'de ad Unit Toplama Boyutlar Zaman Dilimleri DS Dışarı Aktarma
Belge işlenen sayısı

İşlenen belge sayısı
DocumentsProcessedCount Sayı Toplam (Toplam), Sayı DataSourceName, Failed, IndexerName, IndexName, , SkillsetName PT1M Yes
Arama Gecikme Süresi

Arama hizmeti için ortalama arama gecikme süresi
SearchLatency Saniye Ortalama <none> PT1M Yes
Saniye başına arama sorguları

Arama hizmeti için saniye başına arama sorguları
SearchQueriesPerSecond CountPerSecond Ortalama <none> PT1M Yes
Beceri yürütme çağırma sayısı

Beceri yürütme sayısı
SkillExecutionCount Sayı Toplam (Toplam), Sayı DataSourceName, Failed, IndexerName, , SkillName, SkillsetName, SkillType PT1M Yes
Kısıtlanmış arama sorguları yüzdesi

Arama hizmeti için kısıtlanan arama sorgularının yüzdesi
ThrottledSearchQueriesPercentage Yüzde Ortalama <none> PT1M Yes

Saniye başına arama sorguları

Bu ölçüm, arama hizmeti için saniye başına arama sorgularının (QPS) ortalamasını gösterir. Sorguların milisaniye cinsinden yürütülmesi yaygın bir durum olduğundan, QPS gibi bir ölçümde yalnızca saniye olarak ölçen sorgular görünür. En düşük değer, o dakika boyunca kaydedilen saniye başına arama sorguları için en düşük değerdir. En yüksek değer en yüksek değerdir. Ortalama, dakikanın tamamı boyunca toplam değerdir.

Toplama türü Açıklama
Ortalama Sorgu yürütmenin gerçekleştiği bir dakika içindeki ortalama saniye sayısı.
Sayı Bir dakikalık aralık içinde günlüğe yayılan ölçümlerin sayısı.
En Büyük Bir dakika boyunca kaydedilen saniyede en yüksek arama sorgusu sayısı.
Minimum Bir dakika içinde kaydedilen saniyede en düşük arama sorgusu sayısı.
Sum Dakika içinde yürütülen tüm sorguların toplamı.

Örneğin, bir dakika içinde şuna benzer bir desene sahip olabilirsiniz: SearchQueriesPerSecond için en yüksek yük bir saniye, ardından ortalama yük 58 saniye ve son olarak yalnızca bir sorguyla bir saniye (en düşük değerdir).

Başka bir örnek: Bir düğüm 100 ölçüm yayarsa ve burada her ölçümün değeri 40, "Sayı" 100, "Toplam" 4000, "Ortalama" 40 ve "Maksimum" 40 olur.

Arama gecikme süresi

Arama gecikmesi, bir sorguyu tamamlamanın ne kadar sürdüğünü gösterir.

Toplama türü Gecikme süresi
Ortalama Milisaniye cinsinden ortalama sorgu süresi.
Sayı Bir dakikalık aralık içinde günlüğe yayılan ölçümlerin sayısı.
En Büyük Örnekteki en uzun çalışan sorgu.
Minimum Örnekteki en kısa çalışan sorgu.
Toplam Örnekteki tüm sorguların toplam yürütme süresi( bir dakika) içinde yürütülür.

Kısıtlanmış arama sorguları yüzdesi

Bu ölçüm, işlenmek yerine bırakılan sorgulara başvurur. Yürütmedeki istek sayısı kapasiteyi aştığında azaltma gerçekleşir. Bir çoğaltma döndürmeden çıkarıldığında veya dizin oluşturma sırasında kısıtlanmış isteklerde bir artış görebilirsiniz. Hem sorgu hem de dizin oluşturma istekleri aynı kaynak kümesi tarafından işlenir.

Hizmet, kaynak tüketimine göre isteklerin bırakılıp bırakılmayacağını belirler. Bellek, CPU ve disk GÇ arasında tüketilen kaynakların yüzdesi bir süre boyunca ortalama olarak alınır. Bu yüzde eşiği aşarsa, istek hacmi azaltılana kadar dizine yönelik tüm istekler kısıtlanır.

İstemcinize bağlı olarak, kısıtlanmış bir istek şu yollarla belirtilir:

  • Hizmet hata döndürüyor "You are sending too many requests. Please try again later."
  • Hizmet, hizmetin şu anda kullanılamadığını belirten bir 503 hata kodu döndürür.
  • Portalı kullanıyorsanız (örneğin, Arama Gezgini), sorgu sessizce bırakılır ve Yeniden Ara'yı seçmeniz gerekir.

Kısıtlanmış sorguları onaylamak için Kısıtlanmış arama sorguları ölçümünü kullanın. Bu makalede açıklandığı gibi portalda ölçümleri keşfedebilir veya bir uyarı ölçümü oluşturabilirsiniz. Örnekleme aralığı içinde bırakılan sorgular için, yürütülmeyen sorguların yüzdesini almak için Toplam'ı kullanın.

Toplama türü Azaltma
Ortalama Aralık içinde bırakılan sorguların yüzdesi.
Sayı Bir dakikalık aralık içinde günlüğe yayılan ölçümlerin sayısı.
En Büyük Aralık içinde bırakılan sorguların yüzdesi.
Minimum Aralık içinde bırakılan sorguların yüzdesi.
Toplam Aralık içinde bırakılan sorguların yüzdesi.

Kısıtlanmış Arama Sorguları Yüzdesi(minimum, maksimum, ortalama ve toplam) için, tümü aynı değere sahiptir: bir dakika boyunca toplam arama sorgusu sayısından kısıtlanan arama sorgularının yüzdesi.

Ölçüm boyutları

Ölçüm boyutlarının ne olduğu hakkında bilgi için bkz . Çok boyutlu ölçümler.

Azure AI Search,yürütülen belge veya becerilerin sayısını yakalayan aşağıdaki ölçümlerle ilişkilendirilmiş boyutlara sahiptir.

Ölçüm adı Açıklama Boyutlar Örnek kullanım örnekleri
Belge işlenen sayısı Dizin oluşturucu tarafından işlenen belgelerin sayısını gösterir. Veri kaynağı adı, başarısız, dizin adı, dizin oluşturucu adı, beceri kümesi adı Kaba bir aktarım hızı ölçüsü olarak başvurulabilir (zaman içinde dizin oluşturucu tarafından işlenen belge sayısı)
- Başarısız belgelerde uyarı vermek için ayarlama
Beceri yürütme çağırma sayısı Beceri çağrılarının sayısını gösterir. Veri kaynağı adı, başarısız, dizin adı, dizin oluşturucu adı, beceri adı, beceri türü, beceri kümesi adı Beceri sayısı ile beceri çağırma sayısı arasındaki göreli çağrı sayıları belge sayısıyla karşılaştırılarak becerilerin beklendiği gibi çağrıldığından emin olmak için başvuru.
- Başarısız beceri çağrılarında uyarı vermek için ayarlama
Boyut adı Açıklama
DataSourceName Dizin oluşturucu yürütmesi sırasında kullanılan adlandırılmış veri kaynağı bağlantısı. Geçerli değerler desteklenen veri kaynağı türlerinden biridir.
Başarısız oldu Örneğin başarısız olup olmadığını gösterir.
IndexerName Dizin oluşturucunun adı.
IndexName Dizinin adı.
Beceri KümesiAdı Dizin oluşturucu yürütmesi sırasında kullanılan beceri kümesinin adı.
SkillName Beceri kümesi içindeki bir becerinin adı.
SkillType Becerinin @odata.type .

Kaynak günlükleri

Bu bölümde, bu hizmet için toplayabileceğiniz kaynak günlükleri türleri listelenmiştir. bölümü, Azure İzleyici'de desteklenen tüm kaynak günlükleri kategori türleri listesinden çekilir.

Microsoft.Search/searchServices için desteklenen kaynak günlükleri

Kategori Kategori görünen adı Günlük tablosu Temel günlük planını destekler Alım zamanı dönüşümlerini destekler Örnek sorgular Dışarı aktarma maliyetleri
OperationLogs İşlem Günlükleri AzureDiagnostics

Birden çok Azure kaynağından günlükler.

Hayır Hayır Hayır

Azure İzleyici Günlükleri tabloları

Bu bölümde, Kusto sorguları kullanılarak Log Analytics tarafından sorgulanabilen bu hizmetle ilgili Azure İzleyici Günlükleri tabloları listelenmektedir. Tablolar, toplanan ve bunlara yönlendirilenlere bağlı olarak kaynak günlüğü verilerini ve büyük olasılıkla daha fazlasını içerir.

Arama Hizmetleri

Microsoft.Search/searchServices

Table Açıklama
AzureActivity Azure etkinlik günlüğündeki girişler, denetim düzlemi işlemleri hakkında içgörü sağlar. Çoğaltmaları ve bölümleri ekleme veya kaldırma gibi denetim düzleminde çağrılan görevler bir "Yönetici Anahtarını Al" etkinliğiyle temsil edilir.
AzureDiagnostics Günlüğe kaydedilen sorgu ve dizin oluşturma işlemleri. Log Analytics'teki AzureDiagnostics tablosuna yönelik sorgular ortak özellikleri, aramaya özgü özellikleri ve şema başvurusu bölümünde listelenen aramaya özgü işlemleri içerebilir.
AzureMetrics Azure AI Search tarafından yayılan ve sistem durumunu ve performansını ölçen ölçüm verileri.

Kaynak günlüğü tabloları

Aşağıdaki tabloda Azure AI Search'teki kaynak günlüklerinin özellikleri listelanmaktadır. Kaynak günlükleri Azure İzleyici Günlükleri'ne veya Azure Depolama'ya toplanır. Azure İzleyici'de günlükler AzureDiagnostics tablosunda kaynak sağlayıcısı adı Microsoft.Searchaltında toplanır.

Azure Depolama alanı veya özelliği Azure İzleyici Günlükleri özelliği Açıklama
time TIMESTAMP İşlemin gerçekleştiği tarih ve saat (UTC).
resourceId Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) Günlüklerin etkinleştirildiği Azure AI Search kaynağı.
category "OperationLogs" Günlük kategorileri , , OperationalExecutionve Request'yi içerirAudit.
operationName Veri Akışı Adı İşlemin adı. İşlem adı , , , , , , Query.Search, Query.Suggest, , Query.Lookup, , CORS.PreflightIndexes.PrototypeIndexes.UpdateQuery.AutocompleteIndexers.WarmupDataSources.ListServiceStats, olabilir.Indexes.ListIndexStatsSummariesIndexers.ListIndexes.StatsIndexes.Get
durationMS SüreMilliseconds İşlemin milisaniye cinsinden süresi.
operationVersion ApiVersion İstekte kullanılan API sürümü.
resultType (Başarısız) ? "Başarısız" : "Başarılı" Yanıt türü.
resultSignature Durum İşlemin HTTP yanıt durumu.
özellikler Properties Bu olay kategorisiyle ilgili tüm genişletilmiş özellikler.

Etkinlik günlüğü

Bağlı tablo, bu hizmetin etkinlik günlüğüne kaydedilebilecek işlemleri listeler. Bu işlemler, etkinlik günlüğündeki tüm olası kaynak sağlayıcısı işlemlerinin bir alt kümesidir.

Etkinlik günlüğü girdilerinin şeması hakkında daha fazla bilgi için bkz . Etkinlik Günlüğü şeması.

Aşağıdaki tabloda Azure AI Search ile ilgili etkinlik günlüğüne kaydedilebilecek yaygın işlemler listelenmiştir. Tüm Microsoft.Search işlemlerinin tam listesi için bkz . Microsoft.Search kaynak sağlayıcısı işlemleri.

Operasyon Açıklama
Yönetici Anahtarını Al Yönetim hakları gerektiren tüm işlemler "Yönetici Anahtarını Al" işlemi olarak günlüğe kaydedilir.
Sorgu Anahtarını Al Bir dizinin belge koleksiyonuna karşı herhangi bir salt okunur işlem.
Yönetici Anahtarını Yeniden Oluştur Birincil veya ikincil yönetici API anahtarını yeniden oluşturma isteği.

Yaygın girişler API anahtarlarına başvurular içerir: Yönetici Anahtarını Al ve Sorgu Anahtarlarını Al gibi genel bilgilendirme bildirimleri. Bu etkinlikler, yönetici anahtarı (nesneleri oluşturma veya silme) veya sorgu anahtarı kullanılarak yapılan istekleri gösterir, ancak isteğin kendisini göstermez. Bu ayrıntılı bilgi için kaynak günlüğünü yapılandırmanız gerekir.

Alternatif olarak, değişiklik geçmişi aracılığıyla bazı içgörüler elde edebilirsiniz. Azure portalında etkinliği seçerek ayrıntı sayfasını açın ve ardından temel alınan işlem hakkında bilgi için "Geçmişi değiştir"i seçin.

Diğer şemalar

Bu hizmet için aşağıdaki şemalar kullanılıyor.

Sorgular veya özel raporlar oluşturuyorsanız, Azure AI Search kaynak günlüklerini içeren veri yapıları aşağıdaki şemalara uygundur.

Blob depolamaya gönderilen kaynak günlükleri için her blobun günlük nesneleri dizisi içeren kayıtlar adlı bir kök nesnesi vardır. Her blob, aynı saat içinde gerçekleşen tüm işlemlerin kayıtlarını içerir.

Kaynak günlüğü şeması

Azure İzleyici aracılığıyla kullanılabilen tüm kaynak günlükleri ortak bir üst düzey şemayı paylaşır. Azure AI Search, bir arama hizmetine özgü daha fazla özellik ve işlemle destek sağlar.

Aşağıdaki örnekte ortak özellikler (TimeGenerated, Resource, Category vb.) ve aramaya özgü özellikler (OperationName ve OperationVersion) içeren bir kaynak günlüğü gösterilmektedir.

Adı Tip Açıklama ve örnek
TimeGenerated Datetime İşlemin zaman damgası. Örneğin: 2021-12-07T00:00:43.6872559Z
Kaynak String Kaynak Kimliği. Örneğin: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Kategori String "OperationLogs". Bu değer bir sabittir. OperationLogs, kaynak günlükleri için kullanılan tek kategoridir.
OperationName String İşlemin adı (işlemlerin tam listesine bakın). Örnek olarak Query.Search
OperationVersion String İstekte kullanılan api sürümü. Örneğin: 2024-07-01
ResultType String "Başarı". Diğer olası değerler: Başarı veya Başarısızlık
ResultSignature Int HTTP sonuç kodu. Örneğin: 200
SüreMS Int İşlemin milisaniye cinsinden süresi.
Properties Object İşleme özgü verileri içeren nesne. Aşağıdaki özellikler şema tablosuna bakın.

Özellikler şeması

Aşağıdaki özellikler Azure AI Search'e özeldir.

Adı Tip Açıklama ve örnek
Description_s String İşlemin uç noktası. Örneğin: GET /indexes('content')/docs
Documents_d Int İşlenen belge sayısı.
IndexName_s String İşlemle ilişkili dizinin adı.
Query_s String İstekte kullanılan sorgu parametreleri. Örneğin: ?search=beach access&$count=true&api-version=2024-07-01

OperationName değerleri (günlüğe kaydedilen işlemler)

Aşağıdaki işlemler bir kaynak günlüğünde görüntülenebilir.

OperationName Açıklama
DataSources.* Dizin oluşturucu veri kaynakları için geçerlidir. Oluşturma, Silme, Alma, Listeleme olabilir.
DebugSessions.* Hata ayıklama oturumu için geçerlidir. Oluşturma, Silme, Alma, Listeleme, Başlangıç ve Durum olabilir.
DebugSessions.DocumentStructure Zenginleştirilmiş bir belge bir hata ayıklama oturumuna yüklenir.
DebugSessions.RetrieveIndexerExecutionHistoricalData Dizin oluşturucu yürütme ayrıntıları için bir istek.
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData Bir bilgi deposuna yansıtılan zenginleştirmeler için yürütme geçmişi.
Dizinleyicileri.* Dizin oluşturucu için geçerlidir. Oluşturma, Silme, Alma, Listeleme ve Durum olabilir.
Dizin.* Arama dizini için geçerlidir. Oluşturma, Silme, Alma, Listeleme olabilir.
Dizin. Prototip Bu dizin, Verileri İçeri Aktarma sihirbazı tarafından oluşturulur.
Indexing.Index Bu işlem, Dizin Belgeleri'ne yapılan bir çağrıdır.
Metadata.GetMetadata Arama hizmeti sistem verileri için bir istek.
Query.Autocomplete Dizine karşı otomatik tamamlama sorgusu. Bkz. Sorgu türleri ve oluşturma.
Query.Lookup Dizine karşı arama sorgusu. Bkz. Sorgu türleri ve oluşturma.
Query.Search Dizine karşı tam metin arama isteği. Bkz. Sorgu türleri ve oluşturma.
Query.Suggest Dizine karşı önceden sorgu yazın. Bkz. Sorgu türleri ve oluşturma.
ServiceStats Bu işlem, bir portal genel bakış sayfasını yüklendiğinde veya yenilendiğinde doldurmak için doğrudan veya örtük olarak çağrılan, Hizmet İstatistiklerini Alma işlemine yönelik rutin bir çağrıdır.
Beceri kümeleri.* Beceri kümesi için geçerlidir. Oluşturma, Silme, Alma, Listeleme olabilir.