Azure Cosmos DB'yi izleme

Bu makalede şunlar açıklanmaktadır:

  • Bu hizmet için toplayabileceğiniz izleme verilerinin türleri.
  • Bu verileri analiz etme.

Not

Bu hizmeti ve/veya Azure İzleyici'yi zaten biliyorsanız ve yalnızca izleme verilerinin nasıl çözümleneceğini öğrenmek istiyorsanız, bu makalenin sonundaki Çözümle bölümüne bakın.

Azure kaynaklarını kullanan kritik uygulamalarınız ve iş süreçleriniz varsa sisteminiz için uyarıları izlemeniz ve almanız gerekir. Azure İzleyici hizmeti, sisteminizin her bileşeninden ölçümleri ve günlükleri toplar ve toplar. Azure İzleyici kullanılabilirlik, performans ve dayanıklılığın bir görünümünü sağlar ve sorunları size bildirir. İzleme verilerini ayarlamak ve görüntülemek için Azure portalı, PowerShell, Azure CLI, REST API veya istemci kitaplıklarını kullanabilirsiniz.

  • Azure İzleyici hakkında daha fazla bilgi için bkz. Azure İzleyici'ye genel bakış.
  • Azure kaynaklarını genel olarak izleme hakkında daha fazla bilgi için bkz . Azure İzleyici ile Azure kaynaklarını izleme.

İçgörüler

Azure'daki bazı hizmetler, Azure portalında hizmetinizi izlemek için bir başlangıç noktası sağlayan yerleşik bir izleme panosuna sahiptir. Bu panolara içgörü adı verilir ve bunları Azure portalındaki Azure İzleyici'nin Analizler Hub'ında bulabilirsiniz.

Azure Cosmos DB içgörüleri

Azure Cosmos DB içgörüleri, Azure İzleyici'nin çalışma kitapları özelliğini temel alan bir özelliktir. Birleşik etkileşimli bir deneyimde tüm Azure Cosmos DB kaynaklarınızın genel performansını, hatalarını, kapasitesini ve operasyonel durumunu görmek için Azure Cosmos DB içgörülerini kullanın.

Azure Cosmos DB içgörüleri hakkında daha fazla bilgi için aşağıdaki makalelere bakın:

Kaynak türleri

Azure, abonelikteki her şeyi tanımlamak için kaynak türleri ve kimlikler kavramını kullanır. Azure İzleyici, çekirdek izleme verilerini benzer şekilde, ad alanları olarak da adlandırılan kaynak türlerine göre ölçümler ve günlükler halinde düzenler. Farklı kaynak türleri için farklı ölçümler ve günlükler kullanılabilir. Hizmetiniz birden fazla kaynak türüyle ilişkilendirilebilir.

Kaynak türleri, Azure'da çalışan her kaynağın kaynak kimliklerinin de bir parçasıdır. Örneğin, bir sanal makine için kaynak türünden biri olur Microsoft.Compute/virtualMachines. Hizmetlerin ve ilişkili kaynak türlerinin listesi için bkz . Kaynak sağlayıcıları.

Azure Cosmos DB için kaynak türleri hakkında daha fazla bilgi için bkz . Azure Cosmos DB izleme verileri başvurusu.

Veri depolama

Azure İzleyici için:

  • Ölçüm verileri Azure İzleyici ölçüm veritabanında depolanır.
  • Günlük verileri Azure İzleyici günlükleri deposunda depolanır. Log Analytics, Azure portalında bu depoyu sorgulayan bir araçtır.
  • Azure etkinlik günlüğü, Azure portalında kendi arabirimine sahip ayrı bir depodur.
  • İsteğe bağlı olarak ölçüm ve etkinlik günlüğü verilerini Azure İzleyici günlükleri veritabanı deposuna yönlendirebilir, böylece Log Analytics'i kullanarak verileri sorgulayabilir ve diğer günlük verileriyle ilişkilendirebilirsiniz.

Azure İzleyici'nin verileri nasıl depolandığı hakkında ayrıntılı bilgi için bkz . Azure İzleyici veri platformu.

Azure İzleyici platform ölçümleri

Azure İzleyici çoğu hizmet için platform ölçümleri sağlar. Bu ölçümler şunlardır:

  • Her ad alanı için ayrı ayrı tanımlanır.
  • Azure İzleyici zaman serisi ölçüm veritabanında depolanır.
  • Hafif ve neredeyse gerçek zamanlı uyarıyı destekleyebilecek.
  • Bir kaynağın zaman içindeki performansını izlemek için kullanılır.

Koleksiyon: Azure İzleyici, platform ölçümlerini otomatik olarak toplar. Yapılandırma gerekmez.

Yönlendirme: Platform ölçümlerini genellikle Azure İzleyici günlüklerine / Log Analytics'e yönlendirerek bunları diğer günlük verileriyle sorgulayabilirsiniz. Daha fazla bilgi için Ölçüm tanılama ayarına bakın. Bir hizmet için tanılama ayarlarını yapılandırma hakkında bilgi için bkz . Azure İzleyici'de tanılama ayarları oluşturma.

Azure İzleyici'deki tüm kaynaklar için toplamanın mümkün olduğu tüm ölçümlerin listesi için bkz . Azure İzleyici'de desteklenen ölçümler.

Azure İzleyici, Azure Cosmos DB ölçümlerini varsayılan olarak toplar. Herhangi bir şeyi açıkça yapılandırmanız gerekmez. Ölçümlerin çoğu Azure Cosmos DB portalı sayfasından veya Azure İzleyici sayfasından kullanılabilir. Varsayılan olarak ölçümler bir dakikalık ayrıntı düzeyiyle toplanır. Ayrıntı düzeyi, seçtiğiniz ölçüme göre farklılık gösterebilir. Varsayılan olarak, bu ölçümlerin saklama süresi 30 gündür.

Azure Cosmos DB sunucu tarafı ölçümleri aktarım hızı, depolama, kullanılabilirlik, gecikme süresi, tutarlılık ve sistem düzeyi ölçümlerini içerir. İstemci tarafında istek ücreti, etkinlik kimliği, özel durum ve yığın izleme bilgileri, HTTP durumu ve alt durum kodu ve tanılama dizesi için ayrıntıları toplayabilirsiniz. Varsayılan olarak, bu ölçümlerin saklama süresi yedi gündür. Sorunlarda hata ayıklamak veya Azure Cosmos DB destek ekibine başvurmanız gerekiyorsa bu verileri kullanabilirsiniz.

Kapsayıcı adı gibi ölçümlerin boyut değerleri büyük/küçük harfe duyarlı değildir. Bu durum, bu tür adlara sahip kapsayıcılarda telemetri ve eylemlerin karışıklığa veya çakışmasına neden olabilir. Bu boyut değerlerinde dize karşılaştırmaları yaparken büyük/küçük harfe duyarsız karşılaştırma kullanın.

Azure Cosmos DB için kullanılabilir ölçümlerin listesi için bkz . Azure Cosmos DB izleme verileri başvurusu.

Azure İzleyici tabanlı olmayan ölçümler

Bu hizmet, Azure İzleyici ölçüm veritabanına dahil olmayan diğer ölçümleri de sağlar.

  • Azure Cosmos DB'yi izlemeye yardımcı olabilecek iş ortağı çözümleri ve araçları hakkında bilgi için bkz . Üçüncü taraf çözümleri kullanarak Azure Cosmos DB'yi izleme.
  • Prometheus ölçümlerini kullanarak Azure Cosmos DB için Java SDK'sında Mikrometre ölçümlerini uygulamak için bkz . Java için Mikrometre istemci ölçümlerini kullanma.

Azure İzleyici kaynak günlükleri

Kaynak günlükleri, bir Azure kaynağı tarafından yapılan işlemler hakkında içgörü sağlar. Günlükler otomatik olarak oluşturulur, ancak bunları kaydetmek veya sorgulamak için Azure İzleyici günlüklerine yönlendirmeniz gerekir. Günlükler kategoriye göre düzenlenir. Belirli bir ad alanının birden çok kaynak günlüğü kategorisi olabilir.

Koleksiyon: Bir tanılama ayarı oluşturup günlükleri bir veya daha fazla konuma yönlendirene kadar kaynak günlükleri toplanmaz ve depolanmaz. Tanılama ayarı oluşturduğunuzda, hangi günlük kategorilerinin topleneceğini belirtirsiniz. Azure portalı, program aracılığıyla ve ancak Azure İlkesi dahil olmak üzere tanılama ayarlarını oluşturmanın ve korumanın birden çok yolu vardır.

Yönlendirme: Önerilen varsayılan ayar, kaynak günlüklerini diğer günlük verileriyle sorgulayabileceğiniz Azure İzleyici Günlüklerine yönlendirmektir. Azure Depolama, Azure Event Hubs ve belirli Microsoft izleme iş ortakları gibi diğer konumlar da kullanılabilir. Daha fazla bilgi için bkz . Azure kaynak günlükleri ve Kaynak günlüğü hedefleri.

Kaynak günlüklerini toplama, depolama ve yönlendirme hakkında ayrıntılı bilgi için bkz . Azure İzleyici'de tanılama ayarları.

Azure İzleyici'deki tüm kullanılabilir kaynak günlüğü kategorilerinin listesi için bkz . Azure İzleyici'de desteklenen kaynak günlükleri.

Azure İzleyici'deki tüm kaynak günlükleri aynı üst bilgi alanlarına ve ardından hizmete özgü alanlara sahiptir. Ortak şema, Azure İzleyici kaynak günlüğü şemasında özetlenmiştir.

Azure Cosmos DB hesabınızdan tanılama günlüklerini izleyebilir ve Azure İzleyici'den panolar oluşturabilirsiniz. İkinci ayrıntı düzeyinde gerçekleşen olaylar ve izlemeler gibi veriler günlük olarak depolanır. Örneğin, kapsayıcının aktarım hızı değişirse Azure Cosmos DB hesabının özellikleri değişir. Günlükler bu olayları yakalar. Toplanan verilerde sorgu çalıştırarak bu günlükleri analiz edebilirsiniz.

Kullanılabilir kaynak günlüğü kategorileri, ilişkili Log Analytics tabloları ve Azure Cosmos DB için günlük şemaları için bkz . Azure Cosmos DB izleme verileri başvurusu.

Azure etkinlik günlüğü

Etkinlik günlüğü, bu kaynağın dışından görüldüğü gibi her Azure kaynağı için işlemleri izleyen abonelik düzeyinde olaylar içerir; örneğin, yeni bir kaynak oluşturma veya sanal makine başlatma.

Koleksiyon: Etkinlik günlüğü olayları otomatik olarak oluşturulur ve Azure portalında görüntülemek üzere ayrı bir depoda toplanır.

Yönlendirme: Etkinlik günlüğü verilerini Azure İzleyici Günlüklerine göndererek diğer günlük verileriyle birlikte analiz edebilirsiniz. Azure Depolama, Azure Event Hubs ve belirli Microsoft izleme iş ortakları gibi diğer konumlar da kullanılabilir. Etkinlik günlüğünü yönlendirme hakkında daha fazla bilgi için bkz . Azure etkinlik günlüğüne genel bakış.

İzleme verilerini analiz etme

İzleme verilerini analiz etmek için birçok araç vardır.

Azure İzleyici araçları

Azure İzleyici aşağıdaki temel araçları destekler:

Daha karmaşık görselleştirmelere olanak sağlayan araçlar şunlardır:

Azure İzleyici dışarı aktarma araçları

Aşağıdaki yöntemleri kullanarak Azure İzleyici'nin verilerini diğer araçlara alabilirsiniz:

  • Ölçümler: Azure İzleyici ölçüm veritabanından ölçüm verilerini ayıklamak için ölçümler için REST API'sini kullanın. API, alınan verileri iyileştirmek için filtre ifadelerini destekler. Daha fazla bilgi için bkz . Azure İzleyici REST API başvurusu.

  • Günlükler: REST API'sini veya ilişkili istemci kitaplıklarını kullanın.

  • Bir diğer seçenek de çalışma alanı verilerini dışarı aktarmadır.

Azure İzleyici için REST API'yi kullanmaya başlamak için bkz . Azure izleme REST API'sini izleme kılavuzu.

Azure Cosmos DB ölçümlerini analiz etme

Azure Cosmos DB hesap portalı gezintinizde İzleme altındaÖlçümler'i seçerek Azure Cosmos DB ölçümlerini diğer Azure hizmetlerinden ölçümlerle analiz etmek için Azure İzleyici Ölçüm Gezgini'ni kullanabilirsiniz. Ölçüm gezginini kullanma hakkında daha fazla bilgi için bkz . Azure İzleyici ölçüm gezginiyle ölçümleri analiz etme.

Azure Cosmos DB kaynaklarınız için sunucu tarafı gecikme süresini, istek birimi kullanımını ve normalleştirilmiş istek birimi kullanımını izleyebilirsiniz. İstek birimlerine, depolama alanına, gecikme süresine, kullanılabilirliğe, Cassandra'ya ve diğerlerine özgü ölçümleri seçebilirsiniz.

İstemci tarafında, istek ücreti, etkinlik kimliği, özel durum ve yığın izleme bilgileri, HTTP durumu ve alt durum kodu ve tanılama dizesi için ölçümler toplayarak sorunların hatalarını ayıklayabilirsiniz.

Daha fazla bilgi ve ayrıntılı yönergeler için aşağıdaki makalelere bakın:

Azure İzleyici'de desteklenen tüm kaynak ölçümlerinin listesi için bkz . Desteklenen Azure İzleyici ölçümleri. Azure Cosmos DB için toplanan platform ölçümlerinin listesi için bkz . Azure Cosmos DB veri başvuru ölçümlerini izleme.

Azure Cosmos DB'i program aracılığıyla izleme

Portalda hesap depolama alanı kullanımı ve toplam istekler gibi kullanılabilir hesap düzeyi ölçümleri NoSQL için API kullanılarak kullanılamaz. Ancak, NoSQL için API'yi kullanarak kullanım verilerini koleksiyon düzeyinde alabilirsiniz. Koleksiyon düzeyi verilerini almak için aşağıdaki yaklaşımlardan birini kullanın:

  • REST API'yi kullanmak için koleksiyonda bir GET gerçekleştirin. Koleksiyonun kota ve kullanım bilgileri yanıttaki x-ms-resource-quota ve x-ms-resource-usage üst bilgilerinde döndürülür.

  • .NET SDK'sını kullanmak için, CollectionSizeUsage, DatabaseUsage ve DocumentUsage gibi birçok kullanım özelliğini içeren bir ResourceResponse döndüren DocumentClient.ReadDocumentCollectionAsync yöntemini kullanın.

Daha fazla ölçüme erişmek için Azure İzleyici SDK'sını kullanın. Kullanılabilir ölçüm tanımları şu biçim kullanılarak alınabilir:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01

Tek tek ölçümleri almak için aşağıdaki biçimi kullanın:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metrics?timespan={StartTime}/{EndTime}&interval={AggregationInterval}&metricnames={MetricName}&aggregation={AggregationType}&`$filter={Filter}&api-version=2018-01-01

Daha fazla bilgi edinmek için bkz . Azure izleme REST API'si.

Azure Cosmos DB günlüklerini analiz etme

Azure İzleyici Günlüklerindeki veriler tablolarda depolanır. Her tablonun kendi benzersiz özellikler kümesi vardır. Azure İzleyici'deki tüm kaynak günlükleri aynı alanlara ve ardından hizmete özgü alanlara sahiptir. Ortak şema, Azure İzleyici kaynak günlüğü şemasında özetlenmiştir.

Azure Cosmos DB için toplanan kaynak günlükleri türleri için bkz . Azure Cosmos DB izleme verileri başvurusu.

Azure Cosmos DB için Azure İzleyici Günlükleriyle çalışma hakkında daha fazla bilgi için aşağıdaki makalelere bakın:

Kusto sorguları

Kusto sorgu dilini (KQL) kullanarak Azure İzleyici Günlükleri/Log Analytics deposundaki izleme verilerini analiz edebilirsiniz.

Önemli

Portaldaki hizmetin menüsünden Günlükler'i seçtiğinizde Log Analytics açılır ve sorgu kapsamı geçerli hizmete ayarlanır. Bu kapsam, günlük sorgularının yalnızca bu kaynak türündeki verileri içereceği anlamına gelir. Diğer Azure hizmetlerinden veri içeren bir sorgu çalıştırmak istiyorsanız Azure İzleyici menüsünden Günlükler'i seçin. Ayrıntılar için bkz . Azure İzleyici Log Analytics'te günlük sorgusu kapsamı ve zaman aralığı.

Herhangi bir hizmet için yaygın sorguların listesi için bkz . Log Analytics sorguları arabirimi.

Kusto sorguları göndermek için Log Analytics'i kullanmadan önce, denetim düzlemi işlemleri için tanılama günlüklerini etkinleştirmeniz gerekir. Tanılama günlüklerini etkinleştirdiğinizde, verilerinizi kaynağa özgü tablolarda veya tek bir AzureDiagnostics tablosunda (eski) depolamayı seçersiniz. Kusto sorgularının tam metni seçtiğiniz koleksiyon moduna bağlıdır.

Azure Cosmos DB kaynaklarınızı izlemenize yardımcı olmak için Günlük arama çubuğuna girebileceğiniz bazı sorgular aşağıdadır.

Azure Cosmos DB'deki tüm denetim düzlemi günlüklerini sorgulamak için:

CDBControlPlaneRequests

Azure Cosmos DB'deki tüm veri düzlemi günlüklerini sorgulamak için:

CDBDataPlaneRequests

Tek bir kaynağa özgü, filtrelenmiş veri düzlemi günlükleri listesini sorgulamak için:

CDBDataPlaneRequests
| where AccountName=="<account-name>"

Kaynağa göre gruplandırılmış veri düzlemi günlüklerinin sayısını almak için:

CDBDataPlaneRequests
| summarize count() by AccountName

veri düzlemi günlükleri için işlem türüne göre gruplandırılmış bir grafik oluşturmak için:

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

Azure Cosmos DB ile ilgili sorunları gidermek için kullanabileceğiniz Kusto sorguları için aşağıdaki makalelere bakın:

Bu örnekler, Kusto Sorgu Dili (KQL) kullanarak Azure İzleyici'de çalıştırabileceğiniz zengin sorguların küçük bir örneklemesidir. Daha fazla örnek için bkz . Kusto sorguları için örnekler.

Uyarılar

Azure İzleyici uyarıları, izleme verilerinizde belirli koşullar bulunduğunda sizi proaktif olarak bilgilendirir. Uyarılar, müşterileriniz fark etmeden önce sisteminizdeki sorunları tanımlamanıza ve çözmenize olanak sağlar. Daha fazla bilgi için bkz . Azure İzleyici uyarıları.

Azure kaynakları için birçok yaygın uyarı kaynağı vardır. Azure kaynaklarına yönelik yaygın uyarı örnekleri için bkz . Örnek günlük uyarısı sorguları. Azure İzleyici Temel Uyarıları (AMBA) sitesi, Azure Giriş Bölgesi (ALZ) senaryoları için önemli uyarı ölçümleri, panolar ve yönergeler sağlar.

Ortak uyarı şeması, Azure İzleyici uyarı bildirimlerinin kullanımını standartlaştırır. Daha fazla bilgi için bkz . Ortak uyarı şeması.

Uyarı türleri

Azure İzleyici veri platformundaki herhangi bir ölçüm veya günlük veri kaynağı hakkında uyarı alabilirsiniz. İzlediğiniz hizmetlere ve topladığınız izleme verilerine bağlı olarak birçok farklı uyarı türü vardır. Farklı uyarı türlerinin çeşitli avantajları ve dezavantajları vardır. Daha fazla bilgi için bkz . Doğru izleme uyarı türünü seçme.

Aşağıdaki listede oluşturabileceğiniz Azure İzleyici uyarılarının türleri açıklanmaktadır:

  • Ölçüm uyarıları , kaynak ölçümlerini düzenli aralıklarla değerlendirir. Ölçümler platform ölçümleri, özel ölçümler, Azure İzleyici'den ölçümlere dönüştürülen günlükler veya Uygulama Analizler ölçümleri olabilir. Ölçüm uyarıları birden çok koşul ve dinamik eşik de uygulayabilir.
  • Günlük uyarıları , kullanıcıların önceden tanımlanmış bir sıklıkta kaynak günlüklerini değerlendirmek için Log Analytics sorgusu kullanmasına olanak sağlar.
  • Etkinlik günlüğü uyarıları , tanımlı koşullarla eşleşen yeni bir etkinlik günlüğü olayı oluştuğunda tetikler. Kaynak Durumu uyarıları ve Hizmet Durumu uyarıları, hizmetiniz ve kaynak durumunuz hakkında rapor veren etkinlik günlüğü uyarılarıdır.

Bazı Azure hizmetleri akıllı algılama uyarılarını, Prometheus uyarılarını veya önerilen uyarı kurallarını da destekler.

Bazı hizmetler için, aynı Azure bölgesinde bulunan aynı türdeki birden çok kaynağa aynı ölçüm uyarı kuralını uygulayarak büyük ölçekte izleyebilirsiniz. İzlenen her kaynak için tek tek bildirimler gönderilir. Desteklenen Azure hizmetleri ve bulutları için bkz . Tek bir uyarı kuralıyla birden çok kaynağı izleme.

Azure Cosmos DB uyarı kuralları

Aşağıdaki tabloda Azure Cosmos DB için bazı yaygın ve önerilen uyarı kuralları listelenmiştir.

Uyarı türü Koşul Açıklama
İstek birimlerinde hız sınırlama (ölçüm uyarısı) Boyut adı: StatusCode, İşleç: Eşittir, Boyut değerleri: 429 Kapsayıcı veya veritabanı sağlanan aktarım hızı sınırını aştıysa uyarır.
Bölge yük devreddi İşleç: Büyüktür, Toplama türü: Sayı, Eşik değeri: 1 Tek bir bölge yük devredildiğinde. Hizmet tarafından yönetilen yük devretmeyi etkinleştirmediyseniz bu uyarı yararlı olur.
Anahtarları döndürme (etkinlik günlüğü uyarısı) Olay düzeyi: Bilgilendiren, Durum: başlatıldı Hesap anahtarları döndürüldüğünde uyarır. Uygulamanızı yeni anahtarlarla güncelleştirebilirsiniz.

Azure Cosmos DB için uyarı oluşturma hakkında daha fazla bilgi ve yönergeler için bkz . Ölçümler üzerinde uyarı oluşturma. Mantıksal bölüm anahtarının depolama alanının 20 GB'a yaklaşmakta olup olmadığını izlemek üzere bir uyarı oluşturmak için bkz . Mantıksal bölüm anahtarı boyutu üzerinde uyarı oluşturma.

Danışman önerileri

Bazı hizmetler için, kaynak işlemleri sırasında kritik koşullar veya yakın değişiklikler gerçekleşirse portaldaki hizmete Genel Bakış sayfasında bir uyarı görüntülenir. Uyarı için daha fazla bilgi ve önerilen düzeltmeleri soldaki menüde İzleme altında Danışman önerileri bölümünde bulabilirsiniz. Normal işlemler sırasında hiçbir danışman önerisi görüntülenmez.

Azure Danışmanı hakkında daha fazla bilgi için bkz . Azure Danışmanına genel bakış.

  • Azure Cosmos DB için oluşturulan ölçümlerin, günlüklerin ve diğer önemli değerlerin başvurusu için bkz . Azure Cosmos DB izleme verileri başvurusu.
  • Azure kaynaklarını izleme hakkında genel ayrıntılar için bkz . Azure İzleyici ile Azure kaynaklarını izleme.