Yerleşik ölçümlere erişme

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

IoT Edge çalışma zamanı bileşenleri, IoT Edge hub'ı ve IoT Edge aracısı, Prometheus eksponent 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'ye veya Azure IoT Hub göndermeyi işleyen metrics-collector modülünü de kullanabilirsiniz. Daha fazla bilgi için bkz. Ölçümleri toplama ve taşıma.

1.0.10 sürümünden itibaren ölçümler edgeHub ve edgeAgent modüllerinin (http://edgeHub:9600/metrics ve http://edgeAgent:9600/metrics) 9600 numaralı bağlantı noktasında varsayılan olarak otomatik olarak kullanıma sunulur. Bunlar varsayılan olarak konağa eşlenen bağlantı noktası değildir.

Modülün ölçüm bağlantı noktasını açığa çı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şlerken 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 niteliğini 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 üretir:

Name	Boyutlar	Açıklama
edgehub_gettwin_total	source (işlem kaynağı) id (modül kimliği)	Tür: sayaç GetTwin aramalarının toplam 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 $upstream olduğunda to boş olur
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 bildirilmez gibi NaN bildirilebilir; tür için summary karşılık gelen _count ve _sum sayaçlar yayılacaktı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ışı çalışma sayısı
edgehub_offline_duration_seconds	id	Tür: özet Zaman kenarı 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 toplam bağlanamaması sayısı

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

Name	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, yeniden başlatma
edgeAgent_iothub_syncs_total		Tür: sayaç edgeAgent'ın ikizini iotHub ile eşitlemeyi deneme 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 sayısı.
edgeAgent_deployment_time_seconds		Tür: sayaç Değişiklik alındıktan sonra yeni bir dağıtımın tamamlanması 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'in 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 Cihazla ilgili genel meta veriler. Değer her zaman 0'dır, bilgiler etiketlerde kodlanır. not edin 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

• Ölçümleri toplama ve taşıma
• Azure IoT Edge çalışma zamanını ve mimarisini anlama
• IoT Edge aracısının ve IoT Edge hub modülü ikizlerinin özellikleri