K2Bridge açık kaynak bağlayıcısı ile Kibana'da Azure Veri Gezgini verilerini görselleştirme

K2Bridge (Kibana-Kusto Köprüsü), Veri kaynağı olarak Azure Veri Gezgini kullanmanıza ve bu verileri Kibana'da görselleştirmenize olanak tanır. K2Bridge açık kaynaklı, kapsayıcılı bir uygulamadır. Kibana örneğiyle Azure Veri Gezgini kümesi arasında ara sunucu işlevi görür. Bu makalede, bu bağlantıyı oluşturmak için K2Bridge'in nasıl kullanılacağı açıklanmaktadır.

K2Bridge, Kibana sorgularını Kusto Sorgu Dili (KQL) olarak çevirir ve Azure Veri Gezgini sonuçlarını Kibana'ya geri gönderir.

K2Bridge, Kibana'nın Keşif, Görselleştirme ve Pano sekmelerini destekler.

Keşfet sekmesiyle aşağıdakileri yapabilirsiniz:

• Verileri arayın ve keşfedin.
• Sonuçları filtreleyin.
• Sonuçlar kılavuzuna alan ekleyin veya kaldırın.
• Kayıt içeriğini görüntüleyin.
• Aramaları kaydedin ve paylaşın.

Görselleştir sekmesiyle aşağıdakileri yapabilirsiniz:

• Çubuk grafikler, pasta grafikler, veri tabloları, ısı haritaları ve daha fazlası gibi görselleştirmeler oluşturun.
• Görselleştirmeyi kaydetme

Pano sekmesiyle aşağıdakileri yapabilirsiniz:

• Yeni veya kaydedilmiş görselleştirmeleri kullanarak paneller oluşturun.
• Panoyu kaydedin.

Aşağıdaki görüntüde K2Bridge tarafından azure Veri Gezgini bağlı bir Kibana örneği gösterilmektedir. Kibana'daki kullanıcı deneyimi değişmemiştir.

Önkoşullar

Kibana'da Azure Veri Gezgini verilerini görselleştirmeden önce aşağıdakileri hazırlayın:

• Azure aboneliği. Ücretsiz bir Azure hesabı oluşturun.
• Azure Veri Gezgini kümesi ve veritabanı. Kümenin URL'sine ve veritabanı adına ihtiyacınız olacaktır.
• Helm v3, Kubernetes paket yöneticisi.
• Azure Kubernetes Service (AKS) kümesi veya başka bir Kubernetes kümesi. En az üç Azure Kubernetes Service düğümüyle 1.21.2 veya daha yeni bir sürümü kullanın. Sürüm 1.21.2 test edilmiş ve doğrulanmıştır. AKS kümesine ihtiyacınız varsa Bkz. Azure CLI kullanarak veya Azure portalını kullanarak AKS kümesi dağıtma.
• İstemci kimliği ve istemci gizli anahtarı dahil olmak üzere Azure Veri Gezgini'da verileri görüntüleme yetkisine sahip bir Microsoft Entra hizmet sorumlusu. Alternatif olarak, sistem tarafından atanan yönetilen kimliği kullanabilirsiniz.

Bir Microsoft Entra hizmet sorumlusu kullanmayı seçerseniz, bir Microsoft Entra hizmet sorumlusu oluşturmanız gerekir. Yükleme için ClientID ve gizli dizi gerekir. Görüntüleyici iznine sahip bir hizmet sorumlusu öneririz ve daha üst düzey izinleri kullanmanızı önermeyiz. İzinleri atamak için bkz. Azure portalında veritabanı izinlerini yönetme veya veritabanı güvenlik rollerini yönetmek için yönetim komutlarını kullanma.

Sistem tarafından atanan bir kimlik kullanmayı seçerseniz, aracı havuzu yönetilen kimliği ClientID'sini almanız gerekir (oluşturulan "[MC_xxxx]" kaynak grubunda bulunur)

Azure Kubernetes Service'te (AKS) K2Bridge'i çalıştırma

Varsayılan olarak, K2Bridge'in Helm grafiği Microsoft Container Registry'de (MCR) bulunan genel kullanıma açık bir görüntüye başvurur. MCR herhangi bir kimlik bilgisi gerektirmez.

1. Gerekli Helm grafiklerini indirin.

2. Elasticsearch bağımlılığını Helm'e ekleyin. K2Bridge küçük bir iç Elasticsearch örneği kullandığından bağımlılık gereklidir. Örnek, dizin desenleri sorguları ve kaydedilen sorgular gibi meta verilerle ilgili istekleri hizmet eder. Bu iç örnek hiçbir iş verisi kaydetmez. Örneği bir uygulama ayrıntısı olarak düşünebilirsiniz.

   1. Elasticsearch bağımlılığını Helm'e eklemek için şu komutları çalıştırın:

      helm repo add elastic https://helm.elastic.co
      helm repo update
      

   2. GitHub deposunun charts dizininden K2Bridge grafiğini almak için:

      1. GitHub'dan depoyu kopyalayın.

      2. K2Bridges kök deposu dizinine gidin.

      3. Şu komutu çalıştırın:

         helm dependency update charts/k2bridge
         

3. K2Bridge'i dağıtın.

   1. Değişkenleri ortamınız için doğru değerlere ayarlayın.

      ADX_URL=[YOUR_ADX_CLUSTER_URL] #For example, https://mycluster.westeurope.kusto.windows.net
      ADX_DATABASE=[YOUR_ADX_DATABASE_NAME]
      ADX_CLIENT_ID=[SERVICE_PRINCIPAL_CLIENT_ID]
      ADX_CLIENT_SECRET=[SERVICE_PRINCIPAL_CLIENT_SECRET]
      ADX_TENANT_ID=[SERVICE_PRINCIPAL_TENANT_ID]
      

      Not

      Yönetilen kimlik kullanılırken ADX_CLIENT_ID değeri, oluşturulan "[MC_xxxx]" kaynak grubunda bulunan yönetilen kimliğin istemci kimliğidir. Daha fazla bilgi için bkz . MC_ kaynak grubu. ADX_SECRET_ID yalnızca bir Microsoft Entra hizmet sorumlusu kullanıyorsanız gereklidir.

   2. İsteğe bağlı olarak Application Insights telemetrisini etkinleştirin. Application Insights'ı ilk kez kullanıyorsanız bir Application Insights kaynağı oluşturun. İzleme anahtarını bir değişkene kopyalayın.

      APPLICATION_INSIGHTS_KEY=[INSTRUMENTATION_KEY]
      COLLECT_TELEMETRY=true
      

   3. K2Bridge grafiğini yükleyin. Görselleştirmeler ve panolar yalnızca Kibana 7.10 sürümüyle desteklenir. En son görüntü etiketleri şunlardır: sırasıyla Kibana 6.8 ve Kibana 7.10'ı destekleyen 6.8_latest ve 7.16_latest. '7.16_latest' görüntüsü Kibana OSS 7.10.2'yi destekler ve iç Elasticsearch örneği 7.16.2'dir.

      Microsoft Entra hizmet sorumlusu kullanıldıysa:

      helm install k2bridge charts/k2bridge -n k2bridge --set settings.adxClusterUrl="$ADX_URL" --set settings.adxDefaultDatabaseName="$ADX_DATABASE" --set settings.aadClientId="$ADX_CLIENT_ID" --set settings.aadClientSecret="$ADX_CLIENT_SECRET" --set settings.aadTenantId="$ADX_TENANT_ID" [--set image.tag=6.8_latest/7.16_latest] 
      [--set image.repository=$REPOSITORY_NAME/$CONTAINER_NAME] 
      [--set privateRegistry="$IMAGE_PULL_SECRET_NAME"] [--set settings.collectTelemetry=$COLLECT_TELEMETRY]
      

      Veya yönetilen kimlik kullanıldıysa:

      helm install k2bridge charts/k2bridge -n k2bridge --set settings.adxClusterUrl="$ADX_URL" --set settings.adxDefaultDatabaseName="$ADX_DATABASE" --set       settings.aadClientId="$ADX_CLIENT_ID" --set settings.useManagedIdentity=true --set settings.aadTenantId="$ADX_TENANT_ID" [--set image.tag=7.16_latest] [--set  settings.collectTelemetry=$COLLECT_TELEMETRY]
      

      Yapılandırma'da, yapılandırma seçeneklerinin tamamını bulabilirsiniz.

   4. Önceki komutun çıktısı, Kibana'yı dağıtmak için sonraki Helm komutunu önerir. İsteğe bağlı olarak şu komutu çalıştırın:

      helm install kibana elastic/kibana --version 7.17.3 -n k2bridge --set image=docker.elastic.co/kibana/kibana-oss --set imageTag=7.10.2 --set elasticsearchHosts=http://k2bridge:8080
      

   5. Localhost üzerinde Kibana'ya erişmek için bağlantı noktası iletmeyi kullanın.

      kubectl port-forward service/kibana-kibana 5601 --namespace k2bridge
      

   6. adresine giderek Kibana'ya bağlanın http://127.0.0.1:5601.

   7. Kibana'yı kullanıcılara sunma. Bunu yapmak için birden çok yöntem vardır. Kullandığınız yöntem büyük ölçüde kullanım örneğinize bağlıdır.

      Örneğin, hizmeti Load Balancer hizmeti olarak kullanıma sunun. Bunu yapmak için önceki Kibana Helm yükleme komutuna --set service.type=LoadBalancer parametresini ekleyin.

      Ardından şu komutu çalıştırın:

      kubectl get service -w -n k2bridge
      

      Çıkış şu şekilde görünmelidir:

      NAME            TYPE           CLUSTER-IP     EXTERNAL-IP   PORT(S)          AGE
      kibana-kibana   LoadBalancer   xx.xx.xx.xx    <pending>     5601:30128/TCP   4m24s
      

      Ardından görüntülenen oluşturulan EXTERNAL-IP değerini kullanabilirsiniz. Tarayıcıyı açıp EXTERNAL-IP<:5601 adresine giderek Kibana'ya erişmek için >bunu kullanın.

4. Verilerinize erişmek için dizin desenlerini yapılandırın.

   Yeni bir Kibana örneğinde:

   1. Kibana'yı açın.
   2. Yönetim'e gidin.
   3. Dizin Desenleri'ne tıklayın.
   4. Dizin deseni oluşturun. Dizinin adı, yıldız işareti (*) olmadan tablo adı veya işlev adıyla tam olarak eşleşmelidir. listeden ilgili satırı kopyalayabilirsiniz.

Not

K2Bridge'i diğer Kubernetes sağlayıcılarında çalıştırmak için values.yaml dosyasındaki Elasticsearch storageClassName değerini sağlayıcı tarafından önerilen değerle eşleşecek şekilde değiştirin.

Verileri keşfetme

Azure Veri Gezgini Kibana için bir veri kaynağı olarak yapılandırıldığında, verileri keşfetmek için Kibana'yı kullanabilirsiniz.

1. Kibana'da Keşfet sekmesini seçin.

2. Dizin deseni listesinden, keşfedilecek veri kaynağını tanımlayan bir dizin deseni seçin. Burada dizin deseni bir Azure Veri Gezgini tablosudur.

   

3. Verilerinizin zaman filtresi alanı varsa zaman aralığını belirtebilirsiniz. Bul sayfasının sağ üst kısmında bir zaman filtresi seçin. Varsayılan olarak, sayfa son 15 dakikaya ilişkin verileri gösterir.

   

4. Sonuçlar tablosunda ilk 500 kayıt gösterilir. Alan verilerini JSON veya tablo biçiminde incelemek için belgeyi genişletebilirsiniz.

   

5. Alan adının yanındaki ekle'yi seçerek sonuçlar tablosuna belirli sütunlar ekleyebilirsiniz . Varsayılan olarak, sonuç tablosu _source sütununu ve zaman alanı varsa saatsütununu içerir.

   

6. Sorgu çubuğunda verileri şu şekilde arayabilirsiniz:

   • Arama terimi girilir.
   • Lucene sorgu söz dizimini kullanma. Örneğin:
     • Bu değeri içeren tüm kayıtları bulmak için "hata" araması yapın.
     • Durum değeri 200 olan tüm kayıtları almak için "durum: 200" araması yapın.
   • VE, VEYA ve DEĞİl mantıksal işleçlerini kullanma.
   • Yıldız (*) ve soru işareti (?) joker karakterlerini kullanma. Örneğin, "destination_city: L*" sorgusu, hedef şehir değerinin "L" veya "l" ile başladığı kayıtlarla eşleşir. (K2Bridge büyük/küçük harfe duyarlı değildir.)

   

Not

Yalnızca Kibana'nın Lucene sorgu söz dizimi desteklenir. Kibana Sorgu Dili anlamına gelen KQL seçeneğini kullanmayın.

İpucu

Arama bölümünde daha fazla arama kuralı ve mantık bulabilirsiniz.

1. Arama sonuçlarınızı filtrelemek için Kullanılabilir alan listesini kullanın. Alan listesi, aşağıdakileri görebileceğiniz yerdir:

   • Alan için ilk beş değer.
   • Alanı içeren kayıtların sayısı.
   • Her değeri içeren kayıtların yüzdesi.

   İpucu

   Belirli bir değere sahip tüm kayıtları bulmak için büyüteç kullanın.

   

   Sonuçları filtrelemek ve sonuçlar tablosundaki her kaydın sonuç tablo biçimi görünümünü görmek için büyüteci de kullanabilirsiniz.

   

2. Aramanızı korumak için Kaydet veya Paylaş'ı seçin.

   

Verileri görselleştirme

Azure Veri Gezgini verilerinin bir bakışta görünümlerini almak için Kibana görselleştirmelerini kullanın.

Bul sekmesinden görselleştirme oluşturma

1. Dikey çubuk görselleştirmesi oluşturmak için, Bul sekmesinde Kullanılabilir alanlar yan çubuğunu bulun.

   

2. Bir alan adı seçin ve ardından Görselleştir'e tıklayın.

   

3. Görselleştir sekmesi açılır ve görselleştirme görüntülenir. Görselleştirmenin verilerini ve ölçümlerini düzenlemek için görselleştir sekmesinden görselleştirme oluşturma bölümüne de bakın.

   

Görselleştir sekmesinden görselleştirme oluşturma

1. Görselleştir sekmesini seçin ve Görselleştirme oluştur'a tıklayın.

   

2. Yeni Görselleştirme penceresinde bir görselleştirme türü seçin.

   

3. Görselleştirme oluşturduktan sonra ölçümleri düzenleyebilir ve en fazla bir demet ekleyebilirsiniz.

   

Not

K2Bridge bir demet toplamayı destekler. Bazı toplamalar arama seçeneklerini destekler. Kibana Sorgu Dili söz diziminin kısaltması olan KQL seçeneğini değil Lucene söz dizimini kullanın.

Önemli

• Aşağıdaki görselleştirmeler desteklenir: , , , , , Vertical bar, , Area chart, Line chartHorizontal barPie chartve .GaugeData tableHeat mapGoal chartMetric chart
• Aşağıdaki ölçümler desteklenir: , , , , , Average, Count, Max, MedianMin ve Percentiles. Standard deviationSumTop hitsUnique count
• Ölçüm Percentiles ranks desteklenmez.
• Demet toplamalarını kullanmak isteğe bağlıdır, demet toplama olmadan verileri görselleştirebilirsiniz.
• Aşağıdaki demetler desteklenir: , , , , , No bucket aggregation, Date histogramve Filters. RangeDate rangeHistogramTerms
• ve demetleri IPv4 rangeSignificant terms desteklenmez.

Panoları oluşturma

Azure Veri Gezgini verilerinin bir bakışta görünümlerini özetlemek, karşılaştırmak ve karşıtlık sağlamak için Kibana görselleştirmeleriyle panolar oluşturabilirsiniz.

1. Pano oluşturmak için Pano sekmesini seçin ve ardından Yeni pano oluştur'a tıklayın.

   

   Yeni pano düzenleme modunda açılır.

2. Yeni görselleştirme paneli eklemek için Yeni oluştur'a tıklayın.

   

3. Önceden oluşturduğunuz bir görselleştirmeyi eklemek için Var olanı ekle'ye tıklayın ve bir görselleştirme seçin.

4. Panelleri düzenlemek için, panelleri önceliğe göre düzenleyin, panelleri yeniden boyutlandırın ve daha fazlasını yapın, Düzenle'ye tıklayın ve aşağıdaki seçenekleri kullanın:

   • Bir paneli taşımak için panel üst bilgisine tıklayıp basılı tutun, ardından yeni konuma sürükleyin.
   • Bir paneli yeniden boyutlandırmak için yeniden boyutlandırma denetimine tıklayın ve ardından yeni boyutlara sürükleyin.