Mantıksal bölüm anahtarı için depolama alanının 20 GB'a yaklaşmakta olup olmadığını izlemek için uyarılar oluşturma

ŞUNLAR IÇIN GEÇERLIDIR: NoSQL MongoDB Cassandra Gremlin Masa

Azure Cosmos DB, en fazla 20 GB mantıksal bölüm anahtarı boyutu uygular. Örneğin, UserId tarafından bölümlenmiş bir kapsayıcınız/koleksiyonunuz varsa, "Alice" mantıksal bölümündeki veriler en fazla 20 GB veri depolayabilir.

20 GB mantıksal bölüm sınırına yaklaşan mantıksal bölüm anahtarlarınız olup olmadığını izlemek için uyarıları kullanabilirsiniz. Uyarılar size e-posta biçiminde bir bildirim gönderebilir veya koşul tetiklendiğinde Azure İşlevi veya Mantıksal Uygulama gibi bir eylem yürütebilir.

Bu makalede, mantıksal bölüm anahtarı için depolama alanı 20 GB sınırının %70'ini (14 GB'tan fazla depolama alanına sahip) aşarsa tetiklenecek bir uyarı oluşturacağız. Uyarıları belirli bir Azure Cosmos DB hesabındaki Uyarılar bölmesinden veya Azure portalındaki Azure İzleyici hizmetinden ayarlayabilirsiniz. Her iki arabirim de aynı seçenekleri sunar. Bu makalede Azure İzleyici'den uyarının nasıl ayarlanacağı gösterilmektedir.

Önkoşullar

Uyarımızı oluşturmak için Tanılama Günlükleri'ndeki PartitionKeyStatistics günlük kategorisindeki verileri kullanacağız. Tanılama Günlükleri bir kabul etme özelliğidir, bu nedenle devam etmeden önce etkinleştirmeniz gerekir. Örneğimizde önerilen Kaynağa Özgü Günlükler seçeneğini kullanacağız.

Aşağıdakilerden emin olmak için Azure'daki tanılama ayarlarını kullanarak Azure Cosmos DB verilerini izleme yönergelerini izleyin:

• Tanılama Günlükleri, izlemek istediğiniz Azure Cosmos DB hesaplarında etkinleştirilir
• PartitionKeyStatistics günlük kategorisinin koleksiyonunu yapılandırdığınız
• Tanılama günlükleri Log Analytics çalışma alanına gönderiliyor

Uyarıyı oluşturma

1. Azure portal oturum açın.

2. Sol gezinti çubuğundan İzleyici'yi ve ardından Uyarılar'ı seçin.

3. Yeni uyarı kuralı düğmesini seçerek Uyarı kuralı oluştur bölmesini açın.

4. Kapsam bölümünü doldurun:

   • Kaynak seçin bölmesini açın ve aşağıdakileri yapılandırın:

   • Abonelik adınızı seçin.

   • Kaynak türü için Azure Cosmos DB hesapları'nı seçin.

   • Azure Cosmos DB hesabınızın konumu.

   • Ayrıntılar doldurulduktan sonra, seçilen kapsamdaki Azure Cosmos DB hesaplarının listesi görüntülenir. Uyarıları yapılandırmak istediğiniz uyarıyı seçin ve Bitti'yi seçin.

5. Koşul bölümünü doldurun:

   • Koşul seçin bölmesini açarak Sinyal seçin sayfasını açın ve aşağıdakileri yapılandırın:

   • Sinyal türü için Günlük'e tıklayın.

   • İzleme hizmeti için Log Analytics'i seçin.

   • Sinyal adı için Özel günlük araması'nı seçin.

   • Sorgu düzenleyicisine aşağıdaki sorguyu ekleyin. Sonucu önizlemek için sorguyu çalıştırabilirsiniz.

   Not

   Sorgu şu anda hiçbir sonuç döndürmezse sorun olmaz. PartitionKeyStatistics günlükleri yalnızca önemli depolama boyutuna sahip mantıksal bölüm anahtarları varsa verileri gösterir, bu nedenle sonuç döndürülmezse, böyle bir anahtar olmadığı anlamına gelir. Gelecekte bu tür anahtarlar görünürse ve göründüğünde uyarı tetiklenir.

   CDBPartitionKeyStatistics
   // Get the latest storage size for each logical partition key value
   | summarize arg_max(TimeGenerated, *) by AccountName, DatabaseName, CollectionName, _ResourceId, PartitionKey 
   | extend utilizationOf20GBLogicalPartition = SizeKb / (20.0 * 1024.0 * 1024.0) // Current storage / 20GB
   | project TimeGenerated, AccountName, DatabaseName, CollectionName, _ResourceId, PartitionKey, SizeKb, utilizationOf20GBLogicalPartition
   

   • Uyarıyı Düzenlemeye Devam Et'i seçin.

   • Ölçüm bölümünde:

     • Ölçü için utilizationOf20GBLogicalPartition seçeneğini belirleyin.

     • Toplama türü için En Fazla'ya tıklayın.

     • Gereksinimlerinize göre istediğiniz Toplama ayrıntı düzeyini seçin. Örneğimizde 1 saat seçeceğiz. Bu, uyarının mantıksal bölümün depolama boyutunu saat içindeki en yüksek depolama değerini kullanarak hesaplanacağı anlamına gelir.

   • Boyutlara göre böl bölümünde:

     • Aşağıdaki altı boyutu ekleyin: AccountName, DatabaseName, CollectionName, _ResourceId, PartitionKey, SizeKb. Bu, uyarı tetiklendiğinde uyarıyı tetikleyen belirli Azure Cosmos DB hesabını, veritabanını, koleksiyonunu ve bölüm anahtarını tanımlayabilmenizi sağlar.

     • BoyutKb boyutu için Boyut değerleri olarak Tüm geçerli ve gelecekteki değerleri seç'i seçin.

     • Diğer tüm boyutlar için:

       • Yalnızca belirli bir Azure Cosmos DB hesabını, veritabanını, koleksiyonunu veya bölüm anahtarını izlemek istiyorsanız, belirli bir değeri seçin veya değer şu anda açılan listede görünmüyorsa Özel değer ekle'yi seçin.

       • Aksi takdirde Tüm geçerli ve gelecekteki değerleri seç'i seçin. Örneğin, Azure Cosmos DB hesabınızın şu anda iki veritabanı ve beş koleksiyonu varsa, Database ve CollectionName boyutu için tüm geçerli ve özellik değerlerinin seçilmesi, uyarının mevcut tüm veritabanlarına ve koleksiyonlara ve gelecekte oluşturabileceğiniz tüm koleksiyonlara uygulanmasını sağlar.

   • Uyarı mantığı bölümünde:

     • İşleç için Büyüktür seçeneğini belirleyin.

     • İstediğiniz eşik değerini seçin. Sorguyu nasıl yazdığımıza bağlı olarak geçerli bir eşik 0 ile 1 (dahil) arasında bir sayı olacaktır. Örneğimizde, mantıksal bölüm anahtarı izin verilen depolama alanının %70'ine ulaşırsa uyarıyı tetikleyeceğiz, bu nedenle 0,7 gireriz. Bu numarayı gereksinimlerinize göre ayarlayabilirsiniz.

     • Gereksinimlerinize göre istediğiniz Değerlendirme Sıklığını seçin. Örneğimizde 1 saat seçeceğiz. Bu değerin uyarı değerlendirme süresinden küçük veya buna eşit olması gerektiğini unutmayın.

     5. Adım tamamlandıktan sonra Koşul bölümü aşağıdaki örneğe benzer olacaktır.

     

6. Eylemler bölümünü doldurun:

   • Mevcut bir eylem grubunu seçin veya yeni bir eylem grubu oluşturun. Eylem grubu, uyarı tetiklendiğinde gerçekleştirilecek eylemleri tanımlamanızı sağlar. Bu örnekte, uyarı tetiklendiğinde e-posta bildirimi almak için yeni bir eylem grubu oluşturun. Eylem grubu oluştur bölmesini açın.

   • Temel Bilgiler bölümünde:

     • Bu eylem grubunun oluşturulacağı aboneliği ve kaynak grubunu seçin.

     • Eylem grubu adı - Eylem grubu adı bir kaynak grubu içinde benzersiz olmalıdır.

     • Görünen ad - Bu değer, bildirimin kaynağının hangi eylem grubu olduğunu belirlemek için e-posta ve SMS bildirimlerine eklenir.

   • Bildirimler bölümünde:

     • Bildiriminiz için bir ad belirtin.

     • Bildirim Türü olarak E-posta/SMS mesajı/Anında İletme/Ses'i seçin ve e-posta, SMS, Anında İletme Bildirimi veya Ses bilgilerinizi girin.

   • İsteğe bağlı: Eylemler bölümünde, Çalıştırılacak bir Eylem seçebilirsiniz; örneğin, Eylemler bölümünde Azure İşlevi veya Mantıksal Uygulama.

   • Eylem Grubunu oluşturmak için Gözden Geçir + oluştur'u seçin.

7. Ayrıntılar bölümünü doldurun:

   • Uyarı için bir ad tanımlayın, isteğe bağlı bir açıklama, uyarının önem düzeyi sağlayın ve kural oluşturma sırasında kuralın etkinleştirilip etkinleştirilmeyeceğini seçin.
   • Gözden geçir ve oluştur'u seçin ve oluştur'u seçerek uyarı oluşturmayı tamamlayın.

Uyarı oluşturulduktan sonra 10 dakika içinde etkin olur.

Örnek uyarı

Uyarılarınızı Azure portalında görmek için:

1. Azure portal oturum açın.

2. Sol gezinti çubuğundan İzleyici'yi ve ardından Uyarılar'ı seçin.

Uyarı tetiklendiğinde şunları içerir:

• Veritabanı hesabı adı
• Veritabanı adı
• Koleksiyon adı
• Mantıksal bölüm anahtarı
• Mantıksal bölüm anahtarının KB'sinde depolama
• 20 GB sınırının kullanımı

Örneğin, aşağıda tetiklenen uyarıda , "ContosoTenant" mantıksal bölümünün 20 GB mantıksal bölüm depolama sınırının 0,78'ine ulaştığını ve belirli bir veritabanı ve koleksiyonda 16 GB veri olduğunu görüyoruz.

Düzeltme adımları

20 GB mantıksal bölüm boyutu sınırına ulaşıldığında, bu mantıksal bölüme daha fazla veri yazamazsınız. Sonuç olarak, uygulamanızı uzun vadeli bir çözüm olarak farklı bir bölüm anahtarıyla yeniden tasarlamanız önerilir.

Bunun için zaman tanımaya yardımcı olmak için, mevcut uygulamanızın mantıksal bölüm anahtarı sınırında geçici bir artış isteyebilirsiniz. bir Azure desteği bileti oluşturun ve kota türünü seçin Kapsayıcının mantıksal bölüm anahtarı boyutunda geçici artış. Bunun geçici bir azaltma olarak tasarlandığına ve sınır artırıldığında SLA garantilerine uygun olmadığı için uzun vadeli bir çözüm olarak önerilmediğine dikkat edin. Yapılandırmayı kaldırmak için bir destek bileti oluşturun ve kota türü olarak Kapsayıcının mantıksal bölüm anahtarı boyutunu varsayılan değerine (20 GB) geri yükleme türünü seçin. Bu işlem, verileri 20 GB mantıksal bölüm sınırına uyacak şekilde sildikten veya uygulamanızı farklı bir bölüm anahtarıyla yeniden çizdikten sonra yapılabilir.

Depolama veya aktarım hızı için daha yüksek sınırlar gerektiren bölüm anahtarlarına sahip iş yüklerini yönetmeye yönelik en iyi uygulamalar hakkında daha fazla bilgi için bkz. Yapay bölüm anahtarı oluşturma.

Sonraki adımlar

• Azure İzleyici kullanarak Azure Cosmos DB için uyarılar oluşturma.
• Azure Cosmos DB kapsayıcısında normalleştirilmiş RU/sn ölçümünü izleme.
• Azure Cosmos DB'de bir işlemin aktarım hızını izleme veya birim kullanımını isteme.
• Azure Cosmos DB kapsayıcısında 429 özel durumlarını yorumlama ve ilk kez oluşturma.