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, PT30MPT1H 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, 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, 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: 2023-11-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=2023-11-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, Belge Ekleme, Güncelleştirme veya Silme çağrısı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.

İlgili içerik

• Azure AI Arama'yı izlemenin açıklaması için bkz. Azure AI Arama'yı izleme.
• Azure kaynaklarını izleme hakkında ayrıntılı bilgi için bkz . Azure İzleyici ile Azure kaynaklarını izleme.