Mått för MQTT-koordinator
MQTT Broker tillhandahåller en uppsättning observerbarhetsmått som du kan använda för att övervaka och analysera hälsotillståndet för din lösning. Den här artikeln beskriver tillgängliga mått för MQTT-koordinatorn.
Information om hur du konfigurerar alternativ för dessa mått finns i Konfigurera diagnostikinställningar för MQTT-koordinator.
MQTT Connect-användaregenskap metriccategory
När en klient ansluter till asynkron meddelandekö kan den innehålla en användaregenskap som anropas metriccategory i anslutningspaketet. Asynkron meddelandekö taggar sedan alla sessionsdrivna mått (t.ex. publicerar och prenumererar) med detta metriccategory som category.
Om självkontrollavsökningen till exempel ansluter till metriccategory=broker_selftesttaggar asynkron meddelandekö alla mått från dessa sessioner med category=broker_selftest.
Den här funktionen hjälper instrumentpaneler att visa trafikkällor utan problem med hög kardinalitet vid taggning av mått med ämnen.
Sessioner utan en metriccategory taggas som category=uncategorized.
Meddelandemått
Alla mått innehåller taggen hostname för att identifiera podden som genererade måtten. Taggarna som anges i de enskilda måttbeskrivningarna läggs till i den här taggen.
| Mätvärde | Beskrivning | Taggar |
|---|---|---|
| aio_broker_publishes_received | På klientdelen representerar det här måttet hur många inkommande publiceringspaket som tas emot från klienter. För serverdelen representerar det här måttet hur många interna meddelanden som skickas från klientdelsnoderna. | category |
| aio_broker_publishes_sent | På klientdelen representerar det här måttet hur många utgående publiceringspaket som skickas till klienter. Om flera klienter prenumererar på samma ämne räknar det här måttet varje meddelande som skickas, även om de har samma nyttolast. Det här antalet räknar inte ack-paket. För serverdelen representerar det här måttet hur många interna meddelanden som skickas till klientdelsnoderna. | category |
| aio_broker_payload_bytes_received | Summan av nyttolasten för alla mottagna publiceringar. Den här summan inkluderar inte storleken på egenskaperna eller själva publiceringspaketen. | category |
| aio_broker_payload_bytes_sent | Summan av nyttolasten för alla publiceringar som skickas. Den här summan inkluderar inte storleken på egenskaperna eller själva publiceringspaketen. | category |
| aio_broker_authentication_successes | Det här måttet räknar antalet lyckade autentiseringsbegäranden. | category |
| aio_broker_authentication_failures | Det här måttet räknar antalet misslyckade autentiseringsbegäranden. För en felfri autentiseringsserver, aio_broker_authentication_successes + aio_broker_authentication_failures = aio_broker_publishes_received = publishes_sent |
category |
| aio_broker_authentication_deny | Det här måttet räknar antalet nekade autentiseringsbegäranden. | category |
| aio_broker_authorization_allow | Det här måttet räknar auktoriseringsbegäranden. Det här måttet bör alltid vara mindre än eller lika med aio_broker_authentication_successes. |
category |
| aio_broker_authorization_deny | Det här måttet räknar nekade auktoriseringsbegäranden. Det här måttet bör alltid vara mindre än eller lika med aio_broker_authentication_successes. |
category |
| aio_broker_qos0_messages_dropped | Det här måttet räknar antalet borttagna QoS0-meddelanden av någon anledning. Kategorin direction är antingen incoming eller outgoing. |
category, direction |
| aio_broker_backpressure_packets_rejected | Det här måttet räknar antalet avvisade paket på grund av ryggtryck. Ett paket avvisas om systemet har en kapacitet på 97 %. | |
| aio_broker_store_retained_messages | Det här måttet räknar hur många kvarhållna meddelanden som lagras i asynkron meddelandekö. | |
| aio_broker_store_retained_bytes | Det här måttet räknar hur många byte som lagras via behållna meddelanden i asynkron meddelandekö. | |
| aio_broker_store_will_messages | Det här måttet räknar hur många will-meddelanden som lagras i asynkron meddelandekö. | |
| aio_broker_store_will_bytes | Det här måttet räknar hur många byte som lagras via will-meddelanden i asynkron meddelandekö. | |
| aio_broker_number_of_routes | Räknar antalet vägar. | |
| aio_broker_connect_route_replication_correctness | Beskriver om en anslutningsbegäran från en självtestklient replikeras korrekt längs en specifik väg. | |
| aio_broker_connect_latency_route_ms | Beskriver tidsintervallet mellan en självtestklient som skickar ett CONNECT-paket och tar emot ett CONNACK-paket. Det här måttet genereras per väg. Måttet genereras endast om en CONNECT lyckas. | |
| aio_broker_connect_latency_last_value_ms | En uppskattad p99 av connect_latency_route_ms. |
|
| aio_broker_connect_latency_mu_ms | Medelvärdet för connect_latency_route_ms. |
|
| aio_broker_connect_latency_sigma_ms | Standardavvikelsen för connect_latency_route_ms. |
|
| aio_broker_subscribe_route_replication_correctness | Beskriver om en prenumerationsbegäran från en självtestklient replikeras korrekt längs en specifik väg. | |
| aio_broker_subscribe_latency_route_ms | Beskriver tidsintervallet mellan en självtestklient som skickar ett SUBSCRIBE-paket och tar emot ett SUBACK-paket. Det här måttet genereras per väg. Måttet genereras endast om en SUBSCRIBE lyckas. | |
| aio_broker_subscribe_latency_last_value_ms | En uppskattad p99 av subscribe_latency_route_ms. |
|
| aio_broker_subscribe_latency_mu_ms | Medelvärdet för subscribe_latency_route_ms. |
|
| aio_broker_subscribe_latency_sigma_ms | Standardavvikelsen för subscribe_latency_route_ms. |
|
| aio_broker_unsubscribe_route_replication_correctness | Beskriver om en begäran om att avbryta prenumerationen från en självtestklient replikeras korrekt längs en specifik väg. | |
| aio_broker_unsubscribe_latency_route_ms | Beskriver tidsintervallet mellan en självtestklient som skickar ett UNSUBSCRIBE-paket och tar emot ett UNSUBACK-paket. Det här måttet genereras per väg. Måttet genereras endast om en UNSUBSCRIBE lyckas. | |
| aio_broker_unsubscribe_latency_last_value_ms | En uppskattad p99 av unsubscribe_latency_route_ms. |
|
| aio_broker_unsubscribe_latency_mu_ms | Medelvärdet för unsubscribe_latency_route_ms. |
|
| aio_broker_unsubscribe_latency_sigma_ms | Standardavvikelsen för subscribe_latency_route_ms. |
|
| aio_broker_publish_route_replication_correctness | Beskriver om en begäran om att avbryta prenumerationen från en självtestklient replikeras korrekt längs en specifik väg. | |
| aio_broker_publish_latency_route_ms | Beskriver tidsintervallet mellan en självtestklient som skickar ett PUBLISH-paket och tar emot ett PUBACK-paket. Det här måttet genereras per väg. Måttet genereras endast om en PUBLISH lyckas. | |
| aio_broker_publish_latency_last_value_ms | En uppskattad p99 av publish_latency_route_ms. |
|
| aio_broker_publish_latency_mu_ms | Medelvärdet för publish_latency_route_ms. |
|
| aio_broker_publish_latency_sigma_ms | Standardavvikelsen för publish_latency_route_ms. |
|
| aio_broker_payload_check_latency_last_value_ms | En uppskattad p99-svarstidskontroll av det senaste värdet. | |
| aio_broker_payload_check_latency_mu_ms | Medelvärdet för svarstidskontroll. | |
| aio_broker_payload_check_latency_sigma_ms | Standardavvikelsen för svarstiden för nyttolasten. | |
| aio_broker_payload_check_total_messages_lost | Antalet förlorade nyttolastmeddelanden. | |
| aio_broker_payload_check_total_messages_received | Antalet mottagna meddelanden. | |
| aio_broker_payload_check_total_messages_sent | Antalet skickade meddelanden. | |
| aio_broker_ping_correctness | Beskriver om ping från självtestklienten fungerar korrekt. | |
| aio_broker_ping_latency_last_value_ms | En uppskattad p99 av ping-åtgärden för det senaste värdet. | |
| aio_broker_ping_latency_mu_ms | Medelvärdet för ping-kontrollen. | |
| aio_broker_ping_latency_route_ms | Pingsvarstiden i millisekunder för en specifik väg. | |
| aio_broker_ping_latency_sigma_ms | Standardavvikelsen för svarstiden för ping-åtgärden. | |
| aio_broker_publishes_processed_count | Beskriver det bearbetade antalet publicerade meddelanden. | |
| aio_broker_publishes_received_per_second | Räknar antalet publicerade meddelanden som tas emot per sekund. | |
| aio_broker_publishes_sent_per_second | Räknar antalet skickade meddelanden som tas emot per sekund. |
Hälsomått för koordinatoroperator
Den här uppsättningen mått spårar kardinalitetstillståndet för asynkron meddelandekö. Varje önskat mått paras ihop med ett rapporterat mått för att visa det aktuella tillståndet. Dessa mått anger antalet felfria poddar från koordinatorns perspektiv, vilket kan skilja sig från Kubernetes rapporter.
Om en serverdelsnod till exempel startas om men inte återansluter till sin kedja kan det finnas en avvikelse i hälsorapporterna. Kubernetes kan rapportera podden som felfri, medan koordinatorn rapporterar den som ned eftersom den inte fungerar korrekt.
| Önskat mått | Rapporterat mått |
|---|---|
| aio_broker_backend_replicas | aio_broker_backend_replicas_current |
| aio_broker_backend_vertical_chain | aio_broker_backend_vertical_chain_current |
| aio_broker_frontend_replicas | aio_broker_frontend_replicas_current |
Kommentar
backend_vertical_chain_current rapporterar antalet felfria noder i den minst felfria kedjan. Om den förväntade kedjelängden till exempel är 4 och tre kedjor har 4 felfria noder medan en kedja bara har två felfria noder, backend_vertical_chain_current skulle det rapportera 2.
Anslutnings- och prenumerationsmått
Dessa mått ger observerbarhet för anslutningar och prenumerationer på asynkron meddelandekö.
| Mätvärde | Beskrivning | Taggar |
|---|---|---|
| aio_broker_total_sessions | På klientdels- och ennodskoordinatorn representerar det här måttet hur många klientsessioner det finns. Det här antalet inkluderar inte frånkopplade beständiga sessioner, eftersom en klient kan återansluta till en annan klientdelsnod. För serverdelen representerar det här måttet dess anslutningar till de andra noderna i dess kedja. På operatorn representerar det här måttet hur många front- och serverdelsnoder som är anslutna. För autentiseringsservern representerar det här måttet hur många klientdelsarbetare som är anslutna (1 per klientdel per tråd). | mqtt_version: [v3/v5] Taggar för endast serverdelsnoder: is_tail: [sant/falskt] chain_id: [n] |
| aio_broker_store_total_sessions | Det här måttet representerar hur många sessioner som finns i serverdelskedjan. Serverdelsnoder i samma kedja bör rapportera samma antal sessioner och summan av varje kedja ska vara lika med summan av klientdelens total_sessions. | is_persistent: [sant/falskt] is_tail: [sant/falskt] chain_id: [n] |
| aio_broker_connected_sessions | Samma som aio_broker_total_sessions, förutom endast sessioner som har en aktiv anslutning. |
|
| aio_broker_store_connected_sessions | Samma som aio_broker_store_total_sessions, förutom endast sessioner som har en aktiv anslutning. Om is_persistent är falskt ska det här antalet vara lika med totalt antal sessioner. |
|
| aio_broker_total_subscriptions | På klientdelen representerar det här måttet hur många prenumerationer de för närvarande anslutna sessionerna har. Det här antalet inkluderar inte frånkopplade beständiga sessioner, eftersom en klient kan återansluta till en annan klientdelsnod. På operatorn representerar det här måttet klientdels- och serverdelsnoderna. För autentiseringsservern representerar det här måttet hur många klientdelsarbetare som är anslutna (1 per klientdel per tråd). | |
| aio_broker_store_total_subscriptions | Det här måttet representerar hur många prenumerationer som finns i serverdelskedjan. Serverdelsnoder i samma kedja bör rapportera samma antal prenumerationer. Det här antalet matchar inte nödvändigtvis klientdelens total_subscriptions, eftersom det här måttet även spårar frånkopplade beständiga sessioner. |
Tillståndslagermått
Den här uppsättningen mått spårar tillståndsarkivets övergripande tillstånd.
| Mätvärde | Beskrivning | Taggar |
|---|---|---|
| aio_broker_state_store_deletions | Det här måttet räknar antalet borttagna nyckelbegäranden som tagits emot, inklusive både lyckade borttagningar och fel. | |
| aio_broker_state_store_insertions | Det här måttet räknar antalet nya inkommande nyckelinfogningsbegäranden, inklusive både lyckade infogningar och fel. | |
| aio_broker_state_store_keynotify_requests | Det här måttet räknar antalet begäranden om att övervaka nyckeländringar (KEYNOTIFY) som tagits emot, inklusive både lyckade ändringar och fel. | |
| aio_broker_state_store_modifications | Det här måttet räknar antalet mottagna ändringsnyckelbegäranden, inklusive både lyckade ändringar och fel. | |
| aio_broker_state_store_notifications_sent | Det här måttet räknar antalet meddelanden som tillståndsarkivet skickar när ett nyckelvärde ändras och en klient registreras via KEYNOTIFY. | |
| aio_broker_state_store_retrievals | Det här måttet räknar antalet begäranden om nyckelvärdehämtning som tagits emot, inklusive både lyckade hämtningar och fel. |
Mått för diskstödd meddelandebuffert
Dessa mått ger observerbarhet för den diskstödda meddelandebufferten.
| Mätvärde | Beskrivning | Taggar |
|---|---|---|
| aio_broker_buffer_pool_used_percent | Rapporterar procentandelen använd buffert för en enda klientdels- eller serverdelsbuffertpool. | name |
| aio_broker_disk_transfers_completed | Rapporterar antalet disköverföringar som har slutförts på en viss serverdelspodd. Spårar det totala antalet publiceringar som överförs från en buffertpool till disk. | |
| aio_broker_disk_transfers_failed | Rapporterar antalet disköverföringar som misslyckades på en viss serverdelspodd. |
Kommentar
Endast vissa serverdelsbuffertpooler, särskilt de dynamiska som heter "läsare", använder den diskstödda meddelandebuffertfunktionen. Dessa pooler lagrar meddelandeköer för prenumeranter och överför element till disk när användningen överskrider 75 %.
Återställningsmått för fel
| Mätvärde | Beskrivning |
|---|---|
| aio_broker_store_transfer_batch_receiver_message_count | Det här måttet rapporterar antalet meddelanden som tas emot av butiksöverföringsmottagaren. Det här antalet ska vara lika med antalet meddelanden som skickas av butiksöverföringssändaren. |
| aio_broker_store_transfer_batch_sender_transfer_bytes | Det här måttet rapporterar antalet byte som skickas av butiksöverföringssändaren. |
| aio_broker_store_transfer_batch_sender_message_count | Det här måttet rapporterar antalet meddelanden som skickas av butiksöverföringssändaren. |
| aio_broker_store_transfer_ack_event_receiver_message_count | Det här måttet rapporterar antalet ack-händelsemeddelanden som tas emot av butiksöverföringsmottagaren. Det här antalet ska vara lika med antalet ack-händelsemeddelanden som skickas av butiksöverföringssändaren. |
| aio_broker_store_transfer_ack_event_sender_message_count | Det här måttet rapporterar antalet ack-händelsemeddelanden som skickas av butiksöverföringssändaren. |
| aio_broker_store_transfer_ack_event_sender_transfer_bytes | Det här måttet rapporterar antalet byte som skickas av butiksöverföringssändaren för ack-händelser. |
| aio_broker_store_transfer_patch_tracker_receiver_message_count | Det här måttet rapporterar antalet patch tracker-meddelanden som tagits emot av mottagaren för lagringsöverföring. Det här antalet ska vara lika med antalet patch tracker-meddelanden som skickas av butiksöverföringssändaren. |
| aio_broker_store_transfer_patch_tracker_sender_message_count | Det här måttet rapporterar antalet patch tracker-meddelanden som skickas av butiksöverföringssändaren. |
Utvecklarmått
Dessa mått är användbara för felsökning av utvecklare.
| Mätvärde | Beskrivning |
|---|---|
| aio_broker_patch_tracker_held_patches | Det här måttet rapporterar hur många korrigeringar som för närvarande finns inom en nod i en kedja. |
| aio_broker_ack_handler_pending_transactions | Det här måttet rapporterar hur många transaktioner som väntar i ack-hanteraren. |
| aio_broker_client_connected | Det här måttet rapporterar hur många klienter som är anslutna. |
| aio_broker_client_disconnected | Det här måttet rapporterar hur många klienter som är frånkopplade. |
| aio_broker_client_removed | Det här måttet rapporterar hur många klienter som tas bort. |
Relaterat innehåll
- Konfigurera diagnostikinställningar för MQTT-koordinator.
- Konfigurera observerbarhet