Özel ölçümler ekleme

Şunlar için geçerlidir: IoT Edge 1.5 IoT Edge 1.4

Önemli

IoT Edge 1.5 LTS ve IoT Edge 1.4 LTS desteklenen sürümlerdir. IoT Edge 1.4 LTS, 12 Kasım 2024'te kullanım ömrü sona erer. Önceki bir sürümdeyseniz bkz. IoT Edge’i güncelleştirme.

Sistem modüllerinin sağladığı yerleşik ölçümlere ek olarak IoT Edge modüllerinizden özel ölçümler toplayın. Yerleşik ölçümler, dağıtım durumunuz için harika bir temel görünürlük sağlar. Ancak, resmi tamamlamak için özel modüllerden ek bilgilere ihtiyacınız olabilir. Özel modüller, ölçümleri yaymak için uygun Prometheus istemci kitaplığı kullanılarak izleme çözümünüzle tümleştirilebilir. Bu ek bilgiler, gereksinimlerinize göre özelleştirilmiş yeni görünümleri veya uyarıları etkinleştirebilir.

Örnek modül deposu

Ölçümleri yaymak için izlenen özel modül örnekleri için bkz. azure-samples deposu. Seçtiğiniz dilde bir örnek henüz mevcut olmasa bile genel yaklaşım size yardımcı olabilir.

Adlandırma kuralları

Genel rehberlik için Prometheus belgelerinden en iyi yöntemlere başvurun. Aşağıdaki ek öneriler IoT Edge senaryoları için yararlı olabilir.

• Ölçümü hangi modülün yaydığını net bir şekilde ifade etmek için ölçüm adının başına modül adını ekleyin.

• IoT hub'ı adını veya IoT Central uygulama adını, IoT Edge cihaz kimliğini ve modül kimliğini her ölçüme etiket (etiket/boyutları olarak da adlandırılır) olarak ekleyin. Bu bilgiler, IoT Edge aracısı tarafından başlatılan her modülde ortam değişkenleri olarak kullanılabilir. Yaklaşım, örnek deposundaki örnek tarafından gösterilmiştir . Bu bağlam olmadan, belirli bir ölçüm değerini belirli bir cihazla ilişkilendirmek mümkün değildir.

• Etiketlere bir örnek kimliği ekleyin. Örnek kimliği, modül başlatma sırasında oluşturulan GUID gibi herhangi bir benzersiz kimlik olabilir. Örnek kimliği bilgileri, bir modülün ölçümlerini arka uçta işlerken modül yeniden başlatmalarını uzlaştırmaya yardımcı olabilir.

Ölçüm toplayıcısını özel ölçümleri toplayacak şekilde yapılandırma

Bir özel modül ölçümleri yaydıktan sonra, sonraki adım ölçüm toplayıcı modülünü özel ölçümleri toplamak ve taşımak üzere yapılandırmaktır.

Ortam değişkeni MetricsEndpointsCSV , özel modülün ölçüm uç noktasının URL'sini içerecek şekilde güncelleştirilmelidir. Ortam değişkenini güncelleştirirken, ölçüm toplayıcı yapılandırma örneğinde gösterildiği gibi sistem modülü uç noktalarını eklediğinizden emin olun.

Not

Varsayılan olarak, ölçüm toplayıcısının buna erişmesine izin vermek için özel modülün ölçüm uç noktasının bir konak bağlantı noktasına eşlenmesi gerekmez. Açıkça geçersiz kılınmadığı sürece, Linux'ta her iki modül de azure-iot-edge adlı kullanıcı tanımlı bir Docker köprüsü ağında başlatılır.

Kullanıcı tanımlı Docker ağları, modül (kapsayıcı) adlarını kullanarak modüller arası iletişime izin veren varsayılan bir DNS çözümleyicisi içerir. Örneğin module1 adlı özel bir modül http bağlantı noktası 9600'de /metrics yolunda ölçümler yayıyorsa, toplayıcı uç noktasından http://module1:9600/metricstoplanacak şekilde yapılandırılmalıdır.

IoT Edge cihazında aşağıdaki komutu çalıştırarak http bağlantı noktası 9600'de /metrics yolundaki özel bir modül tarafından yayılan ölçümlerin erişilebilir olup olmadığını test edin:

sudo docker exec replace-with-metrics-collector-module-name curl http://replace-with-custom-module-name:9600/metrics

Özel görselleştirmeler ekleme

Log Analytics'te özel ölçümler aldıktan sonra özel görselleştirmeler ve uyarılar oluşturabilirsiniz. İzleme çalışma kitapları, sorgu destekli görselleştirmeler eklemek için artırılabilir.

Her ölçüm IoT hub'ının veya IoT Central uygulamasının kaynak kimliğiyle ilişkilendirilir. Bu nedenle, özel ölçümlerinizin doğru şekilde alınıp alınmadığını log analytics çalışma alanı yerine ilişkili IoT hub'ının Veya IoT Central uygulamasının Günlükler sayfasından kontrol edebilirsiniz. Doğrulamak için bu temel KQL sorgusunu kullanın:

InsightsMetrics
| where Name == 'replace-with-custom-metric-name'

Alımı onayladıktan sonra yeni bir çalışma kitabı oluşturabilir veya var olan bir çalışma kitabını genişletebilirsiniz. Kılavuz olarak seçilen IoT Edge çalışma kitaplarından çalışma kitabı belgelerini ve sorgularını kullanın.

Sonuçlardan memnun olduğunuzda, çalışma kitabını ekibinizle paylaşabilir veya kuruluşunuzun kaynak dağıtımlarının bir parçası olarak program aracılığıyla dağıtabilirsiniz.

Sonraki adımlar

Seçilen çalışma kitaplarıyla ek ölçüm görselleştirme seçeneklerini keşfedin.