Kılavuz: Azure portalını kullanarak Azure Cosmos DB çalışma alanı verilerine dönüştürme eklemesi

  • Şunlara uygulanır: ✅ NoSQL

Bu öğretici, Azure portalını kullanarak bir çalışma alanı veri toplama kuralındaki (DCR) örnek bir dönüşüm yapılandırması konusunda size yol gösterir.

Note

Log Analytics etkinleştirme maliyetlerinin artırılmasına yardımcı olmak için artık Log Analytics kaynaklarınıza veri toplama kuralları ve dönüştürmeleri ekleyerek sütunları filtrelemeyi, döndürülen sonuç sayısını azaltmayı ve veriler hedefe gönderilmeden önce yeni sütunlar oluşturmayı destekliyoruz.

Çalışma alanı dönüştürmeleri, çalışma alanı DCR olarak adlandırılan çalışma alanı için tek bir DCR'de birlikte depolanır. Her dönüştürme belirli bir tabloyla ilişkilendirilir. Dönüştürme, DCR kullanmayan herhangi bir iş akışından bu tabloya gönderilen tüm verilere uygulanır.

Note

Bu öğreticide çalışma alanı dönüşümü yapılandırmak için Azure portalı kullanılır. Azure Resource Manager şablonları ve REST API kullanarak aynı öğretici için bkz. Tutorial: Resource Manager şablonlarını kullanarak Azure İzleyici çalışma alanı veri toplama kuralına dönüştürme ekleme.

Bu eğitimde şunları öğreniyorsunuz:

  • Log Analytics çalışma alanında bir tablo için çalışma alanı dönüşümünü yapılandırın.
  • Çalışma alanı dönüşümü için bir günlük sorgusu yazın.

Prerequisites

Bu eğitimi tamamlamak için şunlara ihtiyacınız olacak:

Öğretici hakkında genel bakış

Bu öğreticide, belirli kayıtları filtreleyerek tablonun depolama gereksinimini CDBDataPlaneRequests azaltacaksınız. Ayrıca, bir veri parçasını özel bir sütunda depolamak için sütun verilerini ayrıştırırken bir sütunun içeriğini de kaldırırsınız. CdBDataPlaneRequests tablosu, çalışma alanında log analytics'i etkinleştirdiğinizde oluşturulur.

Bu öğreticide, alma zamanı dönüşümü oluşturma işleminde size yol gösteren bir sihirbaz sağlayan Azure portalı kullanılmaktadır. Adımları tamamladıktan sonra sihirbazın şu şekilde olduğunu görürsünüz:

  • Tablo şemasını sorgudaki diğer sütunlarla güncelleştirir.
  • WorkspaceTransformation Bir DCR oluşturur ve varsayılan bir DCR zaten çalışma alanına bağlı değilse bunu çalışma alanına bağlar.
  • Veri alma zamanı dönüşümü oluşturur ve DCR'ye ekler.

Sorgu denetim günlüklerini etkinleştirme

Üzerinde çalıştığınız tabloyu oluşturmak için çalışma alanınızda CDBDataPlaneRequests etkinleştirmeniz gerekir. Bu adım tüm alım süresi dönüştürmeleri için gerekli değildir. Yalnızca üzerinde çalıştığımız örnek verileri oluşturmak için kullanılır.

Tabloya bir dönüşüm ekleyin

Artık tablo oluşturulduğuna göre, bu tablo için dönüşümü oluşturabilirsiniz.

  1. Azure portalındaki Log Analytics çalışma alanları menüsünde Tables öğesini seçin. CDBDataPlaneRequests Tabloyu bulun ve Dönüştürme oluştur'u seçin.

    Yeni bir dönüşüm oluşturmayı gösteren ekran görüntüsü.

  2. Bu dönüşüm çalışma alanında ilk dönüşüm olduğundan, bir çalışma alanı dönüştürme DCR'sini oluşturmanız gerekir. Aynı çalışma alanında diğer tablolar için dönüştürmeler oluşturursanız, bunlar aynı DCR'de depolanır. Yeni veri toplama kuralı oluştur'u seçin. Abonelik ve Kaynak grubu çalışma alanı için zaten ayarlanmış. DCR için bir ad girin ve Bitti'yi seçin.

  3. Tablodan örnek verileri görüntülemek için İleri'yi seçin. Dönüştürmeyi tanımlarken sonuç örnek verilere uygulanır. Bu nedenle, sonuçları gerçek verilere uygulamadan önce değerlendirebilirsiniz. Dönüşümü tanımlamak için Dönüştürme düzenleyicisi'ni seçin.

    Günlük tablosundaki örnek verileri gösteren ekran görüntüsü.

  4. Dönüştürme düzenleyicisinde, tabloya veri alımından önce verilere uygulanan dönüşümü görebilirsiniz. adlı source sanal tablo, hedef tablonun kendisiyle aynı sütun kümesine sahip gelen verileri temsil eder. Dönüştürme başlangıçta tabloyu hiçbir değişiklik olmadan döndüren source basit bir sorgu içerir.

  5. Sorguyu aşağıdaki örnekte değiştirin:

    source
| where StatusCode != 200 // searching for requests that are not successful
| project-away Type, TenantId

    Değişiklik aşağıdaki değişiklikleri yapar:

    • Bu günlük girişleri kullanışlı olmadığından, tablonun kendisini sorgulamayla CDBDataPlaneRequests ilgili satırlar yer kazanmak için bırakıldı.
    • Yer kazanmak için TenantId ve Type sütunlarındaki veri kaldırıldı.
    • Dönüştürmeler, sorgunuzdaki extend işleci kullanarak sütun eklemeyi de destekler.

    Note

    Azure portalını kullanarak, gerekli olduğunda dönüştürmenin çıkışı tablo şemasında değişiklikler başlatacaktır. Sütunlar, henüz yoksa dönüştürme çıkışıyla eşleşecek şekilde eklenir. Çıkışınızda tabloya eklenmesini istemediğiniz sütunların olmadığından emin olun. Çıkışta zaten tabloda yer alan sütunlar yoksa, bu sütunlar kaldırılmaz, ancak veriler eklenmez.

    Yerleşik tabloya eklenen tüm özel sütunların ile _CFbitmesi gerekir. Özel tabloya eklenen sütunların bu son eke sahip olması gerekmez. Özel tablonun adı, _CL ile biter.

  6. Sorguyu dönüştürme düzenleyicisine kopyalayın ve örnek verilerden sonuçları görüntülemek için Çalıştır'ı seçin. Yeni Workspace_CF sütunun sorguda olduğunu doğrulayabilirsiniz.

    Dönüştürme düzenleyicisini gösteren ekran görüntüsü.

  7. Dönüşümü kaydetmek için Uygula'yı ve ardından İleri'yi seçerek yapılandırmayı gözden geçirin. DCR'yi yeni dönüşümle güncelleştirmek için Oluştur'u seçin.

    Dönüşümü kaydetmeyi gösteren ekran görüntüsü.

Dönüştürmeyi test edin

Dönüştürmenin etkili olması için yaklaşık 30 dakika bekleyin ve ardından tabloda bir sorgu çalıştırarak bunu test edin. Bu dönüştürme yalnızca dönüştürme uygulandıktan sonra tabloya gönderilen verileri etkiler.

Bu öğreticide tabloya veri CDBDataPlaneRequests göndermek için bazı örnek sorgular çalıştırın. Doğruluğunu kontrol edebilmeniz için bazı sorguları CDBDataPlaneRequests'e ekleyin ki dönüşüm bu kayıtları filtrelesin.

Troubleshooting

Bu bölümde, alabileceğiniz farklı hata koşulları ve bunları düzeltme yolları açıklanmaktadır.

Log Analytics'teki IntelliSense tablodaki yeni sütunları tanımıyor.

IntelliSense'i yönlendiren önbelleğin güncelleştirilmiş olması 24 saate kadar sürebilir.

Dinamik sütunda dönüştürme çalışmıyor

Bilinen bir sorun şu anda dinamik sütunları etkiler. Geçici çözüm, herhangi bir işlem gerçekleştirmeden önce dinamik sütun verilerini, parse_json() kullanarak açıkça ayrıştırmaktır.

Sonraki Adımlar

Veri toplama işlemleri

  • Last updated on