Grafana'da Azure Veri Gezgini verilerini görselleştirme

Grafana, verileri sorgulamanıza ve görselleştirmenize, ardından görselleştirmelerinize göre pano oluşturup paylaşmanıza olanak tanıyan bir analiz platformudur. Grafana, Azure Veri Gezgini'a bağlanmanızı ve verileri görselleştirmenizi sağlayan bir Azure Veri Gezgini eklentisi sağlar. Bu makalede Azure Veri Gezgini'ı Grafana için veri kaynağı olarak ayarlamayı ve ardından örnek bir kümedeki verileri görselleştirmeyi öğreneceksiniz.

Grafana'nın Azure Veri Gezgini eklentisini kullanmayı, Azure Veri Gezgini Grafana için veri kaynağı olarak ayarlamayı ve ardından verileri görselleştirmeyi öğrenmek için aşağıdaki videoyu kullanın.

Bunun yerine , veri kaynağını yapılandırabilir ve verileri aşağıdaki makalede ayrıntılı olarak açıklandığı gibi görselleştirebilirsiniz .

Önkoşullar

StormEvents örnek veri kümesi, Ulusal Çevre Bilgileri Merkezleri'nden gelen hava durumu verilerini içerir.

Veri kaynağını yapılandırma

Azure Veri Gezgini'ı pano aracınız için veri kaynağı olarak yapılandırmak için aşağıdaki adımları gerçekleştirin. Bu bölümde bu adımları daha ayrıntılı olarak ele alacağız:

  1. Azure Active Directory (Azure AD) hizmet sorumlusu oluşturun. Hizmet sorumlusu, pano aracınız tarafından Azure Veri Gezgini hizmetine erişmek için kullanılır.

  2. Azure AD hizmet sorumlusunu Azure Veri Gezgini veritabanındaki görüntüleyici rolüne ekleyin.

  3. Azure AD hizmet sorumlusundan alınan bilgilere göre pano aracı bağlantı özelliklerinizi belirtin ve bağlantıyı test edin.

Hizmet sorumlusu oluşturma

hizmet sorumlusunu Azure portal veya Azure CLI komut satırı deneyimini kullanarak oluşturabilirsiniz. Hangi yöntemi kullanırsanız kullanın, oluşturulduktan sonra sonraki adımlarda kullanacağınız dört bağlantı özelliği için değerler alırsınız.

Azure portal

  1. Hizmet sorumlusunu oluşturmak için Azure portal belgelerindeki yönergeleri izleyin.

    1. Uygulamayı bir role atama bölümünde, Azure Veri Gezgini kümenize Bir Okuyucu rol türü atayın.

    2. Oturum açma için değerleri alma bölümünde, adımlarda ele alınan üç özellik değerini kopyalayın: Dizin Kimliği (kiracı kimliği), Uygulama Kimliği ve Parola.

  2. Azure portal Abonelikler'i seçin ve hizmet sorumlusunu oluşturduğunuz aboneliğin kimliğini kopyalayın.

    Subscription ID - portal.

Azure CLI

  1. Hizmet sorumlusu oluşturma. Uygun kapsamı ve rol türünü readerayarlayın.

    az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                             --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
    

    Daha fazla bilgi için bkz. Azure CLI ile Azure hizmet sorumlusu oluşturma.

  2. komutu aşağıdakine benzer bir sonuç kümesi döndürür. Üç özellik değerini kopyalayın: appID, parola ve kiracı.

    {
      "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "displayName": "{UrlToYourDashboard}:{PortNumber}",
      "name": "https://{UrlToYourDashboard}:{PortNumber}",
      "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
    
  3. Aboneliklerinizin listesini alın.

    az account list --output table
    

    Uygun abonelik kimliğini kopyalayın.

    Subscription ID - CLI.

Hizmet sorumlusunu görüntüleyici rolüne ekleme

Artık bir hizmet sorumlunuz olduğuna göre, bunu Azure Veri Gezgini veritabanındaki görüntüleyici rolüne eklersiniz. Bu görevi Azure portal İzinler altında veya bir yönetim komutu kullanarak sorgula altında gerçekleştirebilirsiniz.

Azure portal - İzinler

  1. Azure portal Azure Veri Gezgini kümenize gidin.

  2. Genel Bakış bölümünde StormEvents örnek verilerini içeren veritabanını seçin.

    Select database.

  3. İzinler'i ve ardından Ekle'yi seçin.

    Database permissions.

  4. Veritabanı izinleri ekle'nin altında Görüntüleyici rolünü ve ardından Sorumluları seçin'i seçin.

    Add database permissions.

  5. Oluşturduğunuz hizmet sorumlusunu arayın. Sorumluyu ve ardından Seç'i seçin.

    Screenshot of the Azure portal New Principals pane. The Select button and two fields with indecipherable service principal properties are highlighted.

  6. Kaydet’i seçin.

    Screenshot of the Add Database Permissions pane in the Azure portal. The Save button is highlighted.

Yönetim komutu - Sorgu

  1. Azure portal Azure Veri Gezgini kümenize gidin ve Sorgu'yu seçin.

    Screenshot of an Azure Data Explorer cluster in the Azure portal. The Query item is highlighted.

  2. Sorgu penceresinde aşağıdaki komutu çalıştırın. Azure portal veya CLI'dan uygulama kimliğini ve kiracı kimliğini kullanın.

    .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
    

    komutu aşağıdakine benzer bir sonuç kümesi döndürür. Bu örnekte, ilk satır veritabanındaki mevcut bir kullanıcıya, ikinci satır ise yeni eklenen hizmet sorumlusuna yöneliktir.

    Result set.

Özellikleri belirtme ve bağlantıyı test etme

Hizmet sorumlusu görüntüleyici rolüne atandıktan sonra Grafana örneğinizde özellikleri belirtir ve Azure Veri Gezgini bağlantısını test edebilirsiniz.

  1. Grafana'da, soldaki menüde dişli simgesini ve ardından Veri Kaynakları'nı seçin.

    Data sources.

  2. Veri kaynağı ekle'yi seçin.

  3. Veri Kaynakları / Yeni sayfasında, veri kaynağı için bir ad girin, ardından Azure Veri Gezgini Veri Kaynağı türünü seçin.

    Connection name and type.

  4. Ayarlar>Bağlantı ayrıntıları bölümünde, kümenizin adını https://{ClusterName}{ biçiminde girin.{ Region}.kusto.windows.net. Azure portal veya CLI'dan diğer değerleri girin. Eşleme için aşağıdaki görüntünün altındaki tabloya bakın.

    Connection properties.

    Grafana Kullanıcı Arabirimi Azure portal Azure CLI
    Abonelik Kimliği ABONELİK KİMLİĞİ kaynak grubundaki
    Kiracı Kimliği Dizin Kimliği tenant
    İstemci Kimliği Uygulama Kimliği appId
    Gizli anahtar Parola password
  5. Testi Kaydet'i &seçin.

    Test başarılı olursa sonraki bölüme gidin. Herhangi bir sorunla karşılaşırsanız Grafana'da belirttiğiniz değerleri denetleyin ve önceki adımları gözden geçirin.

Sorguları iyileştirme

Sorgu iyileştirme için kullanılabilecek iki özellik vardır:

İyileştirmeyi gerçekleştirmek için Veri Kaynakları>Ayarlar>Query İyileştirmeleri bölümünde gerekli değişiklikleri yapın.

Query optimization pane.

Sorgu sonuçlarını önbelleğe alma özelliğini kullanarak pano sorgusu işleme performansını iyileştirme

Bir pano veya görsel bir veya daha fazla kullanıcı tarafından birden çok kez işlendiğinde, Grafana varsayılan olarak Azure Veri Gezgini'e en az bir sorgu gönderir. Pano işleme performansını geliştirmek ve Azure Veri Gezgini kümesindeki yükü azaltmak için Sorgu sonuçlarını önbelleğe almayı etkinleştirin. Belirtilen zaman aralığı boyunca Azure Veri Gezgini önceki sonuçları almak için sonuç önbelleğini kullanır ve gereksiz bir sorgu çalıştırmaz. Bu özellik, özellikle birden çok kullanıcı aynı panoyu kullanırken kaynaklar üzerindeki yükü azaltma ve performansı geliştirme açısından etkilidir.

Sonuçların önbelleğe alınmasını etkinleştirmek için Sorgu İyileştirmeleri bölmesinde aşağıdakileri yapın:

  1. Dinamik önbelleğe alma kullan'ı devre dışı bırakın.
  2. Önbellek En Fazla Yaş alanına, önbelleğe alınmış sonuçları kullanmak istediğiniz dakika sayısını girin.

Zayıf tutarlılığı etkinleştirme

Kümeler güçlü tutarlılık ile yapılandırılır. Bu, sorgu sonuçlarının kümedeki tüm değişikliklerle güncel olmasını garanti eder. Zayıf tutarlılığı etkinleştirirken, sorgu sonuçları küme değişikliklerinden sonra 1-2 dakika gecikmeye sahip olabilir. Öte yandan, zayıf tutarlılık görsel işleme süresini artırabilir. Bu nedenle, anında tutarlılık kritik değilse ve performans marjinalse, performansı geliştirmek için zayıf tutarlılığı etkinleştirin. Sorgu tutarlılığı hakkında daha fazla bilgi için bkz. Sorgu tutarlılığı.

Zayıf tutarlılığı etkinleştirmek için Sorgu İyileştirmeleri bölmesinde >Veri tutarlılığı bölümünde Zayıf'ı seçin.

Verileri görselleştirme

Azure Veri Gezgini'ı Grafana için veri kaynağı olarak yapılandırmayı tamamladınız. Şimdi verileri görselleştirme zamanı. Hem sorgu oluşturucu modunu hem de sorgu düzenleyicisinin ham modunu kullanarak temel bir örnek göstereceğiz. Örnek veri kümesinde çalıştırılacak diğer sorguların örnekleri için Azure Veri Gezgini için yazma sorguları'na bakmanızı öneririz.

  1. Grafana'da, soldaki menüde artı simgesini ve ardından Pano'yu seçin.

    Create dashboard.

  2. Ekle sekmesinin altında Yeni panel ekle'yi seçin.

    Add graph.

  3. Grafik panelinde Panel Başlığı'nı ve ardından Düzenle'yi seçin.

    Edit panel.

  4. Panelin alt kısmında Veri Kaynağı'nı ve ardından yapılandırdığınız veri kaynağını seçin.

    Select data source.

Sorgu oluşturucu modu

Sorgu düzenleyicisinin iki modu vardır. Sorgu oluşturucu modu ve ham mod. Sorgunuzu tanımlamak için sorgu oluşturucu modunu kullanın.

  1. Veri kaynağının altında Veritabanı'nı seçin ve açılan listeden veritabanınızı seçin.

  2. Kimden'i seçin ve açılan listeden tablonuzu seçin.

    Select table in query builder.

  3. Tablo tanımlandıktan sonra verileri filtreleyin, sunmayı istediğiniz değerleri seçin ve bu değerlerin gruplandırma işlemini tanımlayın.

    Filtrele

    1. Tablonuzdaki bir veya daha fazla sütun açılan listesinden seçim yapmak için Where (filter) öğesinin sağındaki öğesine tıklayın+.
    2. Her filtre için, geçerli işlecini kullanarak değerleri tanımlayın. Bu seçim, Kusto sorgu dilinde where işlecini kullanmaya benzer.

    Değer seçimi

    1. Panelde görüntülenecek değer sütunlarını açılan listeden seçmek için değer sütunlarının sağında tıklayın+.
    2. Her değer sütunu için toplama türünü ayarlayın. Bir veya daha fazla değer sütunu ayarlanabilir. Bu seçim, summarize işlecini kullanmaya eşdeğerdir.

    Değer gruplandırma
    Değerleri gruplar halinde düzenlemek için kullanılacak bir veya daha fazla sütun açılan listesinden seçmek için Gruplandırma ölçütü (özetleme) öğesinin sağındaki öğesine tıklayın+. Bu, özetleme işlecindeki grup ifadesiyle eşdeğerdir.

  4. Sorguyu yürütmek için Sorguyu çalıştır'ı seçin.

    Query builder with all values complete.

    İpucu

    Sorgu oluşturucusunda ayarlar sonlandırılırken bir Kusto sorgu dili sorgusu oluşturulur. Bu sorgu, grafik sorgu düzenleyicisiyle oluşturduğunuz mantığı gösterir.

  5. Ham moda geçmek ve Kusto sorgu dilinin esnekliğini ve gücünü kullanarak sorgunuzu düzenlemek için KQL Düzenle'yi seçin.

Query builder with raw query.

Ham mod

Sorgunuzu düzenlemek için ham modu kullanın.

  1. Sorgu bölmesinde, aşağıdaki sorguyu kopyalayın ve sorguyu çalıştır'ı seçin. Sorgu, örnek veri kümesi için günlük olay sayısını demetler.

    StormEvents
    | summarize event_count=count() by bin(StartTime, 1d)
    

    Run query.

  2. Grafın kapsamı varsayılan olarak son altı saate ait verilere göre belirlenmiş olduğundan herhangi bir sonuç gösterilmez. Üstteki menüde Son 6 saat'i seçin.

    Last six hours.

  3. StormEvents örnek veri kümemize dahil edilen yıl olan 2007'yi kapsayan özel bir aralık belirtin. Uygula’yı seçin.

    Custom date range.

    Şimdi grafikte 2007'ye ait veriler günlere göre demetlenmiş olarak gösterilir.

    Finished graph.

  4. Üstteki menüde kaydet simgesini seçin: Save icon..

Önemli

Sorgu oluşturucu moduna geçmek için Oluşturucuya geç'i seçin. Grafana sorguyu Sorgu Oluşturucusu'ndaki kullanılabilir mantığa dönüştürür. Sorgu oluşturucu mantığı sınırlıdır ve bu nedenle sorguda el ile yapılan değişiklikleri kaybedebilirsiniz.

Move to builder from raw mode.

Uyarı Oluşturma

  1. Yeni bir bildirim kanalı oluşturmak için Giriş Panosu'nda AlertingNotification>channels öğesini seçin

    create notification channel.

  2. Yeni bir Bildirim kanalı oluşturun, ardından Kaydet'i seçin.

    Create new notification channel.

  3. Pano'da, açılan listeden Düzenle'yi seçin.

    select edit in dashboard.

  4. Uyarı bölmesini açmak için uyarı zili simgesini seçin. Uyarı Oluştur'u seçin. Uyarı bölmesinde aşağıdaki özellikleri tamamlayın.

    alert properties.

  5. Değişikliklerinizi kaydetmek için Panoyu kaydet simgesini seçin.

Sonraki adımlar