Přístup k integrovaným metrikám v Azure IoT Edge

Platí pro: IoT Edge 1.5

Důležité

Podporovanou verzí je IoT Edge 1.5 LTS. IoT Edge 1.4 LTS je konec životnosti od 12. listopadu 2024. Pokud používáte starší verzi, podívejte se na článek Aktualizace IoT Edge.

Komponenty modulu runtime IoT Edge, Centrum IoT Edge a agent IoT Edge vytvářejí integrované metriky ve formátu expozice Prometheus. K těmto metrikám můžete přistupovat vzdáleně za účelem monitorování a porozumění stavu zařízení IoT Edge.

Použijte vlastní řešení pro přístup k těmto metrikám nebo použijte modul kolektoru metrik, který shromažďuje předdefinované metriky a odesílá je do služby Azure Monitor nebo Azure IoT Hub. Další informace najdete v tématu Shromažďování a přenos metrik.

Metriky se ve výchozím nastavení zveřejňují na portu 9600 modulů edgeHub a edgeAgent (http://edgeHub:9600/metrics a http://edgeAgent:9600/metrics). Ve výchozím nastavení nejsou přiřazené hostiteli.

Získejte přístup k metrikám z hostitele tím, že odhalíte a přiřadíte port metrik v modulu createOptions. Následující příklad mapuje výchozí port metrik na port 9601 na hostiteli:

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

Při mapování koncových bodů metrik edgeHubu i edgeAgent zvolte různá a jedinečná čísla portů hostitele.

Poznámka:

Proměnná prostředí httpSettings__enabled nesmí být nastavená na false, aby byly předdefinované metriky k dispozici pro sběr.

Proměnné prostředí, které je možné použít k zakázání metrik, jsou uvedené v dokumentaci k úložišti Azure/iotedge.

Dostupné metriky

Metriky zahrnují značky, které identifikují povahu shromažďované metriky. Všechny metriky zahrnují následující značky:

Značka	Popis
iothub	Centrum, se kterým zařízení komunikuje
edge_device	ID aktuálního zařízení
instance_number	Identifikátor GUID představující aktuální modul runtime. Při restartování se resetují všechny metriky. Tento identifikátor GUID usnadňuje odsouhlasení restartování.

Formát expozice Prometheus zahrnuje čtyři základní typy metrik: čítač, měřidlo, histogram a souhrn. Další informace o různých typech metrik najdete v dokumentaci k typům metrik Prometheus.

Quantily pro předdefinovaný histogram a souhrnné metriky jsou 0,1, 0,5, 0,9 a 0,99.

Modul EdgeHub generuje následující metriky:

Název	Dimenze	Popis
edgehub_gettwin_total	source (zdroj operace) id (ID modulu)	Typ: čítač Celkový počet volání GetTwin
edgehub_messages_received_total	route_output (výstup odeslané zprávy) id	Typ: čítač Celkový počet zpráv přijatých od klientů
edgehub_messages_sent_total	from (zdroj zprávy) to (cíl zprávy) from_route_output to_route_input (cílový vstup zprávy) priority (priorita zprávy do cíle)	Typ: čítač Celkový počet zpráv odeslaných klientům nebo upstream to_route_input je prázdná, když to je $upstream
edgehub_reported_properties_total	target(aktualizovat cíl) id	Typ: čítač Celkový počet volání aktualizací ohlášených vlastností
edgehub_message_size_bytes	id	Typ: souhrn Velikost zprávy od klientů Hodnoty mohou být uvedeny jako NaN, pokud se po dobu 10 minut nehlásí žádná nová měření. Pro typ summary jsou vyprodukovány odpovídající čítače _count a _sum.
edgehub_gettwin_duration_seconds	source id	Typ: souhrn Doba potřebná k získání operací dvojčete
edgehub_message_send_duration_seconds	from to from_route_output to_route_input	Typ: souhrn Čas potřebný k odeslání zprávy
edgehub_message_process_duration_seconds	from to priority	Typ: souhrn Doba potřebná ke zpracování zprávy z fronty
edgehub_reported_properties_update_duration_seconds	target id	Typ: souhrn Doba potřebná k aktualizaci ohlášených vlastností
edgehub_direct_method_duration_seconds	from (volající) to (přijímač)	Typ: souhrn Doba potřebná k vyřešení přímé zprávy
edgehub_direct_methods_total	from to	Typ: čítač Celkový počet odeslaných přímých zpráv
edgehub_queue_length	endpoint (zdroj zprávy) priority (priorita fronty)	Typ: měřidlo Aktuální délka fronty edgeHubu pro danou prioritu
edgehub_messages_dropped_total	reason (bez_trasy, vypršení_životnosti) from from_route_output	Typ: čítač Celkový počet odebraných zpráv z důvodu důvodu
edgehub_messages_unack_total	reason (chyba úložiště) from from_route_output	Typ: čítač Celkový počet nepřiznaných zpráv, protože selhání úložiště
edgehub_offline_count_total	id	Typ: čítač Celkový počet, kolikrát edgeHub přešel do offline režimu
edgehub_offline_duration_seconds	id	Typ: souhrn Časové hraniční centrum bylo offline
edgehub_operation_retry_total	id operation (název operace)	Typ: čítač Celkový počet opakování operací EdgeHubu
edgehub_client_connect_failed_total	id reason (není ověřeno)	Typ: čítač Celkový počet neúspěšných připojení klientů k EdgeHubu

Modul edgeAgent generuje následující metriky:

Název	Dimenze	Popis
edgeAgent_total_time_running_correctly_seconds	module_name	Typ: měřidlo Doba, po kterou byl modul zadán v nasazení a byl ve spuštěném stavu
edgeAgent_total_time_expected_running_seconds	module_name	Typ: měřidlo Doba, po kterou byl modul zadán v nasazení
edgeAgent_module_start_total	module_name, module_version	Typ: čítač Počet, kolikrát agent edgeAgent požádal docker o spuštění modulu
edgeAgent_module_stop_total	module_name, module_version	Typ: čítač Kolikrát agent edgeAgent požádal docker o zastavení modulu
edgeAgent_command_latency_seconds	command	Typ: měřidlo Jak dlouho trvalo spuštění daného příkazu dockeru. Možné příkazy: vytvoření, aktualizace, odebrání, spuštění, zastavení a restartování
edgeAgent_iothub_syncs_total		Typ: čítač Kolikrát se agent edge pokusil synchronizovat své dvojče s iotHubem, a to jak úspěšně, tak neúspěšně. Toto číslo zahrnuje agenta, který žádá o dvojčete, i centrum s oznámením o aktualizaci dvojčete.
edgeAgent_unsuccessful_iothub_syncs_total		Typ: čítač Kolikrát se agent edgeAgent nepodařilo synchronizovat jeho dvojče s iotHubem.
edgeAgent_deployment_time_seconds		Typ: čítač Doba, kterou trvalo dokončení nového nasazení po přijetí změny
edgeagent_direct_method_invocations_count	method_name	Typ: čítač Kolikrát se volá integrovaná přímá metoda edgeAgent, například Ping nebo Restart.
edgeAgent_host_uptime_seconds		Typ: měřidlo Jak dlouho je hostitel zapnutý
edgeAgent_iotedged_uptime_seconds		Typ: měřidlo Jak dlouho iotedged běží
edgeAgent_available_disk_space_bytes	disk_name, , disk_filesystemdisk_filetype	Typ: měřidlo Množství volného místa na disku
edgeAgent_total_disk_space_bytes	disk_name, , disk_filesystemdisk_filetype	Typ: měřidlo Velikost disku
edgeAgent_used_memory_bytes	module_name	Typ: měřidlo Množství paměti RAM používané všemi procesy
edgeAgent_total_memory_bytes	module_name	Typ: měřidlo K dispozici je paměť RAM
edgeAgent_used_cpu_percent	module_name	Typ: histogram Procento procesoru používaného všemi procesy
edgeAgent_created_pids_total	module_name	Typ: měřidlo Počet procesů nebo vláken, které kontejner vytvořil
edgeAgent_total_network_in_bytes	module_name	Typ: měřidlo Počet bajtů přijatých ze sítě
edgeAgent_total_network_out_bytes	module_name	Typ: měřidlo Počet bajtů odeslaných do sítě
edgeAgent_total_disk_read_bytes	module_name	Typ: měřidlo Počet bajtů přečtených z disku
edgeAgent_total_disk_write_bytes	module_name	Typ: měřidlo Počet bajtů zapsaných na disk
edgeAgent_metadata	edge_agent_version, , experimental_featureshost_information	Typ: měřidlo Obecná metadata o zařízení Hodnota je vždy 0 a informace se zakódují do značek. Všimněte si, že experimental_features a host_information jsou to objekty JSON. host_information vypadá jako {"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"}. Poznámka ServerVersion : Jedná se o verzi Dockeru a Version jedná se o verzi démona zabezpečení IoT Edge.

Další kroky

• Shromažďování a přenos metrik
• Principy modulu runtime Azure IoT Edge a jeho architektury
• Vlastnosti dvojčat modulů ioT Edge a agenta IoT Edge