Kqlmagic ile not defteri oluşturma ve çalıştırma

Kqlmagic , Azure Data Studio not defterlerindeki Python çekirdeğinin özelliklerini genişleten bir komutdur. Komutlarla render tümleştirilmiş zengin Plotly kitaplığını kullanarak verileri sorgulamak ve görselleştirmek için Python ve Kusto sorgu dilini (KQL) birleştirebilirsiniz. Kqlmagic size not defterleri, veri analizi ve zengin Python özelliklerinin avantajlarını aynı konumda sunar. Kqlmagic ile desteklenen veri kaynakları Azure Veri Gezgini, Application Insights ve Azure İzleyici günlükleridir.

Bu makalede, Azure Veri Gezgini kümesi, Application Insights günlüğü ve Azure İzleyici günlükleri için Kqlmagic uzantısını kullanarak Azure Data Studio'da not defteri oluşturma ve çalıştırma adımları gösterilmektedir.

Önkoşullar

• Azure Data Studio
• Python

Not defterine Kqlmagic yükleme ve ayarlama

Bu bölümdeki adımların tümü bir Azure Data Studio not defteri içinde çalıştırılır.

1. Yeni bir not defteri oluşturun ve Çekirdeği Python 3 olarak değiştirin.

   

2. Paketlerinizin güncelleştirilmesi gerektiğinde Python paketlerinizi yükseltmeniz istenebilir.

   

3. Kqlmagic'i yükleyin:

   import sys
   !{sys.executable} -m pip install Kqlmagic --no-cache-dir --upgrade
   

   Yüklendiğini doğrulayın:

   import sys
   !{sys.executable} -m pip list
   

   

4. Yük Kqlmagic:

   %reload_ext Kqlmagic
   

   Not

   Bu adım başarısız olursa dosyayı kapatıp yeniden açın.

   

5. Yardım belgelerine göz atarak veya sürümü denetleyerek Kqlmagic'in düzgün yüklenip yüklenmediğini test edebilirsiniz.

   %kql --help "help"
   

   Not

   Samples@help Parola istiyorsanız parolayı boş bırakıp Enter tuşuna basabilirsiniz.

   

   Hangi Kqlmagic sürümünün yüklü olduğunu görmek için aşağıdaki komutu çalıştırın.

   %kql --version
   

Azure Veri Gezgini kümesi ile Kqlmagic

Bu bölümde, Azure Veri Gezgini kümesiyle Kqlmagic kullanarak veri analizi çalıştırma işlemi açıklanmaktadır.

Azure Veri Gezgini için Kqlmagic yükleme ve kimlik doğrulaması

1. Çekirdeğin Python3 olarak ayarlandığını doğrulayın.

   

2. Yük Kqlmagic:

   %reload_ext Kqlmagic
   

   

3. Kümeye bağlanın ve kimlik doğrulaması:

   %kql azureDataExplorer://code;cluster='help';database='Samples'
   

   Not

   Kendi ADX kümenizi kullanıyorsanız bölgeyi aşağıdaki gibi bağlantı dizesi eklemeniz gerekir:

   %kql azuredataexplorer://code;cluster='mycluster.westus';database='mykustodb' Kimlik doğrulaması için cihaz oturum açma özelliğini kullanırsınız. Çıkıştan kodu kopyalayın ve kodu yapıştırmanız gereken tarayıcıyı açan kimliği doğrula'yı seçin. Başarıyla kimlik doğrulaması yaptıktan sonra, betiğin geri kalanıyla devam etmek için Azure Data Studio'ya geri dönebilirsiniz.

   

Azure Veri Gezgini için sorgulama ve görselleştirme

İşleme işlecini kullanarak verileri sorgular ve çizim kitaplığını kullanarak verileri görselleştirir. Bu sorgu ve görselleştirme, yerel KQL kullanan tümleşik bir deneyim sağlar.

1. İlk 10 fırtına olayını duruma ve sıklık düzeyine göre analiz edin:

   %kql StormEvents | summarize count() by State | sort by count_ | limit 10
   

   Kusto Sorgu Dili (KQL) hakkında bilginiz varsa, sorguyu sonra %kqlyazabilirsiniz.

   

2. Zaman çizelgesi grafiğini görselleştirme:

   %kql StormEvents \
   | summarize event_count=count() by bin(StartTime, 1d) \
   | render timechart title= 'Daily Storm Events'
   

   

3. kullanarak %%kqlçok satırlı sorgu örneği.

   %%kql
   StormEvents
   | summarize count() by State
   | sort by count_
   | limit 10
   | render columnchart title='Top 10 States by Storm Event count'
   

   

Application Insights ile Kqlmagic

Application Insights için Kqlmagic yükleme ve kimlik doğrulaması

1. Çekirdeğin Python3 olarak ayarlandığını doğrulayın.

   

2. Yük Kqlmagic:

   %reload_ext Kqlmagic
   

   

   Not

   Azure Data Studio'da her yeni not defteri oluşturduğunuzda Kqlmagic uzantısını yüklemeniz gerekir.

3. Bağlanın ve kimlik doğrulaması sağlayın.

   İlk olarak, Application Insights kaynağınız için bir API anahtarı oluşturmanız gerekir. Ardından, not defterinden Application Insights'a bağlanmak için Uygulama Kimliği ve API anahtarını kullanın:

   %kql appinsights://appid='DEMO_APP';appkey='DEMO_KEY'
   

Application Insights için sorgulama ve görselleştirme

İşleme işlecini kullanarak verileri sorgular ve çizim kitaplığını kullanarak verileri görselleştirir. Bu sorgu ve görselleştirme, yerel KQL kullanan tümleşik bir deneyim sağlar.

1. Sayfa Görünümlerini Göster:

   %%kql
   pageViews
   | limit 10
   

   

   Not

   Belirli tarihlere yakınlaştırmak için grafiğin bir alanına sürüklemek için farenizi kullanın.

2. Zaman çizelgesi grafiğinde Sayfa görünümlerini göster:

   %%kql
   pageViews
   | summarize event_count=count() by name, bin(timestamp, 1d)
   | render timechart title= 'Daily Page Views'
   

   

Azure İzleyici günlükleriyle Kqlmagic

Azure İzleyici günlükleri için Kqlmagic'i yükleme ve kimlik doğrulaması

1. Çekirdeğin Python3 olarak ayarlandığını doğrulayın.

   

2. Yük Kqlmagic:

   %reload_ext Kqlmagic
   

   

   Not

   Azure Data Studio'da her yeni not defteri oluşturduğunuzda Kqlmagic uzantısını yüklemeniz gerekir.

3. Bağlanın ve kimlik doğrulaması:

   %kql loganalytics://workspace='DEMO_WORKSPACE';appkey='DEMO_KEY';alias='myworkspace'
   

   

Azure İzleyici Günlüklerini sorgulama ve görselleştirme

İşleme işlecini kullanarak verileri sorgular ve çizim kitaplığını kullanarak verileri görselleştirir. Bu sorgu ve görselleştirme, yerel KQL kullanan tümleşik bir deneyim sağlar.

1. Zaman çizelgesi grafiğini görüntüleme:

   %%kql
   KubeNodeInventory
   | summarize event_count=count() by Status, bin(TimeGenerated, 1d)
   | render timechart title= 'Daily Kubernetes Nodes'
   

   

Sonraki adımlar

Not defterleri ve Kqlmagic hakkında daha fazla bilgi edinin:

• Azure Data Studio için Kusto (KQL) uzantısı (Önizleme)
• Kusto (KQL) not defteri oluşturma ve çalıştırma (Önizleme)
• Azure Veri Gezgini'de verileri analiz etmek için Jupyter Notebook ve Kqlmagic uzantısı kullanma
• Kusto Application Insights ve LogAnalytics verileriyle çalışma not defteri deneyimi sağlayan Jupyter Notebook ve Jupyter laboratuvarı uzantısı (Magic).
• Kqlmagic
• Azure Data Studio'da not defterlerini kullanma