Aracılığıyla paylaş

Azure IoT Edge'de yerleşik ölçümlere erişme

  • Makale

Şunlar için geçerlidir:IoT Edge 1.5 onay işareti IoT Edge 1.5

Önemli

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

IoT Edge çalışma zamanı bileşenleri, IoT Edge hub'ı ve IoT Edge aracısı, Prometheus ekspozisyon biçiminde yerleşik ölçümler üretir. Bir IoT Edge cihazının durumunu izlemek ve anlamak için bu ölçümlere uzaktan erişin.

Bu ölçümlere erişmek için kendi çözümünüzü kullanabilirsiniz. Alternatif olarak, yerleşik ölçümleri toplamayı ve Bunları Azure İzleyici veya Azure IoT Hub'a göndermeyi işleyen ölçüm toplayıcı modülünü de kullanabilirsiniz. Daha fazla bilgi için bkz . Ölçümleri toplama ve taşıma.

EdgeHub ve edgeAgent modüllerinin (http://edgeHub:9600/metrics ve http://edgeAgent:9600/metrics) 9600 numaralı bağlantı noktasında ölçümler varsayılan olarak otomatik olarak kullanıma sunulur. Bunlar varsayılan olarak ana bilgisayara eşlenen bağlantı noktası değildir.

Modülün ölçüm bağlantı noktasını ortaya çıkararak ve eşleyerek konaktan ölçümlere erişin createOptions. Aşağıdaki örnek, varsayılan ölçüm bağlantı noktasını konakta 9601 numaralı bağlantı noktasına eşler:

{
  "ExposedPorts": {
    "9600/tcp": {}
  },
  "HostConfig": {
    "PortBindings": {
      "9600/tcp": [
        {
          "HostPort": "9601"
        }
      ]
    }
  }
}

Hem edgeHub hem de edgeAgent'ın ölçüm uç noktalarını eşlediyseniz farklı ve benzersiz konak bağlantı noktası numaraları seçin.

Not

Yerleşik ölçümlerin koleksiyon için kullanılabilir olması için ortam değişkeni httpSettings__enabled olarak ayarlanmamalıdır false .

Ölçümleri devre dışı bırakmak için kullanılabilecek ortam değişkenleri azure/iotedge depo belgesinde listelenir.

Mevcut ölçümler

Ölçümler, toplanan ölçümün doğasını tanımlamaya yardımcı olacak etiketler içerir. Tüm ölçümler aşağıdaki etiketleri içerir:

Etiket Açıklama
iothub Cihazın konuştuğu hub
edge_device Geçerli cihazın kimliği
instance_number Geçerli çalışma zamanını temsil eden BIR GUID. Yeniden başlatıldığında tüm ölçümler sıfırlanır. Bu GUID, yeniden başlatmaları uzlaştırmayı kolaylaştırır.

Prometheus edat biçiminde dört temel ölçüm türü vardır: sayaç, ölçer, histogram ve özet. Farklı ölçüm türleri hakkında daha fazla bilgi için Prometheus ölçüm türleri belgelerine bakın.

Yerleşik histogram ve özet ölçümleri için sağlanan niceller 0,1, 0,5, 0,9 ve 0,99'dır.

edgeHub modülü aşağıdaki ölçümleri oluşturur:

Veri Akışı Adı Boyutlar Açıklama
edgehub_gettwin_total source (işlem kaynağı)
id (modül kimliği)		 Tür: sayaç
Toplam GetTwin araması sayısı
edgehub_messages_received_total route_output (ileti gönderen çıkış)
id		 Tür: sayaç
İstemcilerden alınan toplam ileti sayısı
edgehub_messages_sent_total from (ileti kaynağı)
to (ileti hedefi)
from_route_output
to_route_input (ileti hedef girişi)
priority (hedefe ileti önceliği)		 Tür: sayaç
İstemcilere veya yukarı akışa gönderilen toplam ileti sayısı
to_route_input to boş olduğunda $upstream
edgehub_reported_properties_total target(hedefi güncelleştir)
id		 Tür: sayaç
Bildirilen özellik güncelleştirme çağrılarının toplamı
edgehub_message_size_bytes id
 Tür: özet
İstemcilerden ileti boyutu
Değerler, belirli bir süre boyunca (şu anda 10 dakika) yeni ölçüm bildirilmemiş gibi NaN bildirilebilir; tür için summary karşılık gelen _count ve _sum sayaçlar yayılır.
edgehub_gettwin_duration_seconds source
id		 Tür: özet
İkiz alma işlemleri için geçen süre
edgehub_message_send_duration_seconds from
to
from_route_output
to_route_input		 Tür: özet
İleti göndermek için geçen süre
edgehub_message_process_duration_seconds from
to
priority		 Tür: özet
Kuyruktan bir iletiyi işlemek için geçen süre
edgehub_reported_properties_update_duration_seconds target
id		 Tür: özet
Bildirilen özellikleri güncelleştirmek için geçen süre
edgehub_direct_method_duration_seconds from (arayan)
to (alıcı)		 Tür: özet
Doğrudan iletiyi çözümlemek için geçen süre
edgehub_direct_methods_total from
to		 Tür: sayaç
Gönderilen toplam doğrudan ileti sayısı
edgehub_queue_length endpoint (ileti kaynağı)
priority (kuyruk önceliği)		 Tür: ölçer
Belirli bir öncelik için edgeHub kuyruğunun geçerli uzunluğu
edgehub_messages_dropped_total reason (no_route, ttl_expiry)
from
from_route_output		 Tür: sayaç
Nedenden dolayı kaldırılan toplam ileti sayısı
edgehub_messages_unack_total reason (storage_failure)
from
from_route_output		 Tür: sayaç
Depolama hatası nedeniyle tanınmayan toplam ileti sayısı
edgehub_offline_count_total id Tür: sayaç
EdgeHub'ın toplam çevrimdışı kaç kez çevrimdışı olduğu
edgehub_offline_duration_seconds id Tür: özet
Zaman sınırı hub'ı çevrimdışı
edgehub_operation_retry_total id
operation (işlem adı)		 Tür: sayaç
EdgeHub işlemlerinin yeniden denenen toplam sayısı
edgehub_client_connect_failed_total id
reason (kimliği doğrulanmamış)
 Tür: sayaç
İstemcilerin edgeHub'a bağlanamamasının toplam sayısı

edgeAgent modülü aşağıdaki ölçümleri oluşturur:

Veri Akışı Adı Boyutlar Açıklama
edgeAgent_total_time_running_correctly_seconds module_name Tür: ölçer
Modülün dağıtımda belirtildiği ve çalışır durumda olduğu süre
edgeAgent_total_time_expected_running_seconds module_name Tür: ölçer
Modülün dağıtımda belirtildiği süre
edgeAgent_module_start_total module_name, module_version Tür: sayaç
edgeAgent'ın docker'dan modülü başlatmasını isteme sayısı
edgeAgent_module_stop_total module_name, module_version Tür: sayaç
edgeAgent'ın docker'dan modülü durdurmasını isteme sayısı
edgeAgent_command_latency_seconds command Tür: ölçer
Docker'ın verilen komutu yürütmesi ne kadar sürdü? Olası komutlar şunlardır: oluşturma, güncelleştirme, kaldırma, başlatma, durdurma ve yeniden başlatma
edgeAgent_iothub_syncs_total Tür: sayaç
edgeAgent'ın ikizini iotHub ile eşitlemeye çalışma sayısı (hem başarılı hem de başarısız). Bu sayı hem ikiz isteyen Aracıyı hem de ikiz güncelleştirmesini Hub'a bildirmeyi içerir
edgeAgent_unsuccessful_iothub_syncs_total Tür: sayaç
edgeAgent'ın ikizini iotHub ile eşitleyemediği süre.
edgeAgent_deployment_time_seconds Tür: sayaç
Değişiklik alındıktan sonra yeni dağıtımı tamamlamak için geçen süre.
edgeagent_direct_method_invocations_count method_name Tür: sayaç
Ping veya Yeniden Başlatma gibi yerleşik edgeAgent doğrudan yönteminin çağrılma sayısı.
edgeAgent_host_uptime_seconds Tür: ölçer
Konağın ne kadar süredir açık olduğu
edgeAgent_iotedged_uptime_seconds Tür: ölçer
Iotedged'ın ne kadar süredir çalıştığı
edgeAgent_available_disk_space_bytes disk_name, disk_filesystem, disk_filetype Tür: ölçer
Diskte kalan alan miktarı
edgeAgent_total_disk_space_bytes disk_name, disk_filesystem, disk_filetype Tür: ölçer
Diskin boyutu
edgeAgent_used_memory_bytes module_name Tür: ölçer
Tüm işlemler tarafından kullanılan RAM miktarı
edgeAgent_total_memory_bytes module_name Tür: ölçer
RAM kullanılabilir
edgeAgent_used_cpu_percent module_name Tür: histogram
Tüm işlemler tarafından kullanılan cpu yüzdesi
edgeAgent_created_pids_total module_name Tür: ölçer
Kapsayıcının oluşturduğu işlem veya iş parçacığı sayısı
edgeAgent_total_network_in_bytes module_name Tür: ölçer
Ağdan alınan bayt sayısı
edgeAgent_total_network_out_bytes module_name Tür: ölçer
Ağa gönderilen bayt sayısı
edgeAgent_total_disk_read_bytes module_name Tür: ölçer
Diskten okunan bayt sayısı
edgeAgent_total_disk_write_bytes module_name Tür: ölçer
Diske yazılan bayt sayısı
edgeAgent_metadata edge_agent_version, experimental_features, host_information Tür: ölçer
Cihaz hakkındaki genel meta veriler. Değer her zaman 0'dır, bilgiler etiketlerde kodlanır. Not experimental_features ve host_information json nesneleridir. host_information gibi {"OperatingSystemType": "linux", "Architecture": "x86_64", "Version": "1.2.7", "Provisioning": {"Type": "dps.tpm", "DynamicReprovisioning": false, "AlwaysReprovisionOnStartup": false}, "ServerVersion": "20.10.11+azure-3", "KernelVersion": "5.11.0-1027-azure", "OperatingSystem": "Ubuntu 20.04.4 LTS", "NumCpus": 2, "Virtualized": "yes"}görünür. Not ServerVersion Docker sürümüdür ve Version IoT Edge güvenlik daemon sürümüdür.

Sonraki adımlar