Dela via

Få åtkomst till inbyggda mått i Azure IoT Edge

Gäller för:Bockmarkering för IoT Edge 1.5 IoT Edge 1.5

Viktigt!

IoT Edge 1.5 LTS är den version som stöds. IoT Edge 1.4 LTS upphör från och med den 12 november 2024. Om du har en tidigare version läser du Uppdatera IoT Edge.

IoT Edge-körningskomponenterna, IoT Edge-hubben och IoT Edge-agenten, skapar inbyggda mått i Prometheus-expositionsformatet. Fjärranslut till dessa mått för att övervaka och förstå hälsotillståndet för en IoT Edge-enhet.

Använd din egen lösning för att komma åt dessa mått eller använda modulen metrics-collector, som samlar in de inbyggda måtten och skickar dem till Azure Monitor eller Azure IoT Hub. Mer information finns i Samla in och transportera mått.

Mått exponeras som standard på port 9600 för modulerna edgeHub och edgeAgent (http://edgeHub:9600/metrics och http://edgeAgent:9600/metrics). De mappas inte till värden som standard.

Få åtkomst till mätvärden från värddatorn genom att exponera och kartlägga mätvärdesporten i modulens createOptions. I följande exempel kartläggs standardporten för mätdata till port 9601 på värden.

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

Välj olika och unika värdportnummer vid mappning av både edgeHub- och edgeAgent-måttslutpunkterna.

Kommentar

Miljövariabeln httpSettings__enabled får inte anges till false för att inbyggda mått ska vara tillgängliga för insamling.

Miljövariabler som kan användas för att inaktivera mått visas i dokumentet azure/iotedge-lagringsplats.

Tillgängliga mått

Mått innehåller taggar som identifierar typen av mått som samlas in. Alla mått innehåller följande taggar:

Tagg beskrivning
iothub Hubben som enheten kommunicerar med
edge-enhet ID för den aktuella enheten
instance_number Ett GUID som representerar den aktuella körningen. Vid omstart återställs alla mått. Detta GUID gör det enklare att stämma av omstarter.

Prometheus-expositionsformatet innehåller fyra viktiga måtttyper: räknare, mätare, histogram och sammanfattning. Mer information om de olika måtttyperna finns i dokumentationen om Prometheus-måtttyper.

Kvantilerna för det inbyggda histogrammet och de sammanfattande måtten är 0,1, 0,5, 0,9 och 0,99.

EdgeHub-modulen genererar följande mått:

Namn Dimensioner beskrivning
edgehub_gettwin_total source (åtgärdskälla)
id (modul-ID)		 Typ: räknare
Totalt antal GetTwin-samtal
edgehub_messages_received_total route_output (utdata som skickade meddelandet)
id		 Typ: räknare
Totalt antal meddelanden som tagits emot från klienter
edgehub_messages_sent_total from (meddelandekälla)
to (meddelandemål)
from_route_output
to_route_input (meddelandemålsindata)
priority (meddelandeprioritet till mål)		 Typ: räknare
Totalt antal meddelanden som skickas till klienter eller uppströms
to_route_input är tom när to är $upstream
edgehub_reported_properties_total target(uppdateringsmål)
id		 Typ: räknare
Totalt antal rapporterade egenskapsuppdateringar
edgehub_message_size_bytes id
 Typ: sammanfattning
Meddelandestorlek från klienter
Värden kan rapporteras som NaN om inga nya mått rapporteras under 10 minuter. För typen summary genereras motsvarande _count och _sum räknare.
edgehub_gettwin_duration_seconds source
id		 Typ: sammanfattning
Tidsåtgång för att hämta tvillingåtgärder
edgehub_message_send_duration_seconds from
to
from_route_output
to_route_input		 Typ: sammanfattning
Tiden det tar att skicka ett meddelande
edgehub_message_process_duration_seconds from
to
priority		 Typ: sammanfattning
Tiden det tar att bearbeta ett meddelande från kön
edgehub_reported_properties_update_duration_seconds target
id		 Typ: sammanfattning
Tiden det tar att uppdatera rapporterade egenskaper
edgehub_direct_method_duration_seconds from (uppringare)
to (mottagare)		 Typ: sammanfattning
Tiden det tar att lösa ett direktmeddelande
edgehub_direct_methods_total from
to		 Typ: räknare
Totalt antal skickade direktmeddelanden
edgehub_queue_length endpoint (meddelandekälla)
priority (köprioritet)		 Typ: mätare
Aktuell längd på edgeHub-kön för en viss prioritet
edgehub_messages_dropped_total reason (ingen_ rutt, ttl_utgång)
from
from_route_output		 Typ: räknare
Totalt antal borttagna meddelanden på grund av orsak
edgehub_messages_unack_total reason (lagringsfel)
from
from_route_output		 Typ: räknare
Totalt antal meddelanden som inte har anträffats på grund av lagringsfel
edgehub_offline_count_total id Typ: räknare
Totalt antal gånger edgeHub gick offline
edgehub_offline_duration_seconds id Typ: sammanfattning
Tidsgränshubben var offline
edgehub_operation_retry_total id
operation (åtgärdsnamn)		 Typ: räknare
Totalt antal gånger som edgeHub-åtgärder gjordes på nytt
edgehub_client_connect_failed_total id
reason (ej autentiserad)
 Typ: räknare
Totalt antal gånger klienter inte kunde ansluta till edgeHub

EdgeAgent-modulen genererar följande mått:

Namn Dimensioner beskrivning
edgeAgent_total_time_running_correctly_seconds module_name Typ: mätare
Hur lång tid modulen angavs i distributionen och var i körningstillstånd
edgeAgent_total_time_expected_running_seconds module_name Typ: mätare
Hur lång tid modulen angavs i distributionen
edgeAgent_module_start_total module_name, module_version Typ: räknare
Antal gånger edgeAgent bad docker att starta modulen
edgeAgent_module_stop_total module_name, module_version Typ: räknare
Antal gånger edgeAgent bad docker att stoppa modulen
edgeAgent_command_latency_seconds command Typ: mätare
Hur lång tid det tog för Docker att köra det angivna kommandot. Möjliga kommandon är: skapa, uppdatera, ta bort, starta, stoppa och starta om
edgeAgent_iothub_syncs_total Typ: räknare
Antal gånger edgeAgent försökte synkronisera sin tvilling med iotHub, både lyckad och misslyckad. Det här numret inkluderar både Agent som begär en tvilling och hubb som meddelar om en tvillinguppdatering
edgeAgent_unsuccessful_iothub_syncs_total Typ: räknare
Antal gånger edgeAgent inte kunde synkronisera sin tvilling med iotHub.
edgeAgent_deployment_time_seconds Typ: räknare
Hur lång tid det tog att slutföra en ny distribution efter att ha fått en ändring.
edgeagent_direct_method_invocations_count method_name Typ: räknare
Antal gånger som en inbyggd edgeAgent-direktmetod anropas, till exempel Ping eller Omstart.
edgeAgent_host_uptime_seconds Typ: mätare
Hur länge värden har varit på
edgeAgent_iotedged_uptime_seconds Typ: mätare
Hur länge iotedged har körts
edgeAgent_available_disk_space_bytes disk_name, , disk_filesystemdisk_filetype Typ: mätare
Mängden utrymme kvar på disken
edgeAgent_total_disk_space_bytes disk_name, , disk_filesystemdisk_filetype Typ: mätare
Diskens storlek
edgeAgent_used_memory_bytes module_name Typ: mätare
Mängden RAM-minne som används av alla processer
edgeAgent_total_memory_bytes module_name Typ: mätare
TILLGÄNGLIGT RAM-minne
edgeAgent_used_cpu_percent module_name Typ: histogram
Procent av processorn som används av alla processer
edgeAgent_created_pids_total module_name Typ: mätare
Antalet processer eller trådar som containern har skapat
edgeAgent_total_network_in_bytes module_name Typ: mätare
Antalet byte som tagits emot från nätverket
edgeAgent_total_network_out_bytes module_name Typ: mätare
Antalet byte som skickas till nätverket
edgeAgent_total_disk_read_bytes module_name Typ: mätare
Antalet byte som lästs från disken
edgeAgent_total_disk_write_bytes module_name Typ: mätare
Antalet byte som skrivits till disken
edgeAgent_metadata edge_agent_version, , experimental_featureshost_information Typ: mätare
Allmänna metadata om enheten. Värdet är alltid 0 och informationen kodas i taggarna. Observera att experimental_features och host_information är JSON-objekt. host_information ser ut som {"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"}. Observera ServerVersion att är Docker-versionen och Version är IoT Edge-säkerhetsdaemonversionen.

Nästa steg