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
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.
Yeni bir not defteri oluşturun ve Çekirdeği Python 3 olarak değiştirin.
Paketlerinizin güncelleştirilmesi gerektiğinde Python paketlerinizi yükseltmeniz istenebilir.
Kqlmagic'i yükleyin:
import sys !{sys.executable} -m pip install Kqlmagic --no-cache-dir --upgradeYüklendiğini doğrulayın:
import sys !{sys.executable} -m pip list
Yük Kqlmagic:
%reload_ext KqlmagicNot
Bu adım başarısız olursa dosyayı kapatıp yeniden açın.
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@helpParola 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ı
Not
Azure Data Studio'da her yeni not defteri oluşturduğunuzda Kqlmagic uzantısını yüklemeniz gerekir.
Çekirdeğin Python3 olarak ayarlandığını doğrulayın.
Yük Kqlmagic:
%reload_ext Kqlmagic
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.
İ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 10Kusto Sorgu Dili (KQL) hakkında bilginiz varsa, sorguyu sonra
%kqlyazabilirsiniz.
Zaman çizelgesi grafiğini görselleştirme:
%kql StormEvents \ | summarize event_count=count() by bin(StartTime, 1d) \ | render timechart title= 'Daily Storm Events'
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ı
Çekirdeğin Python3 olarak ayarlandığını doğrulayın.
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.
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.
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.
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ı
Çekirdeğin Python3 olarak ayarlandığını doğrulayın.
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.
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.
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