Skip to content

Commit 025172d

Browse files
committed
Clarify AMQP multiplexing requirement for upstream connections
Surface the critical AMQP multiplexing constraint as a visible callout instead of buried prose.
1 parent e4f730e commit 025172d

1 file changed

Lines changed: 7 additions & 2 deletions

File tree

articles/iot-edge/iot-edge-runtime.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure IoT Edge runtime and architecture explained
33
description: Discover how Azure IoT Edge runtime manages modules, security, and communication with IoT Hub to optimize IoT solutions.
44
author: sethmanheim
55
ms.author: sethm
6-
ms.date: 02/25/2026
6+
ms.date: 02/26/2026
77
ms.topic: concept-article
88
ms.service: azure-iot-edge
99
services: iot-edge
@@ -72,7 +72,12 @@ The IoT Edge hub isn't a full local version of IoT Hub. It delegates some tasks
7272

7373
### Cloud communication
7474

75-
To reduce the bandwidth that your IoT Edge solution uses, the IoT Edge hub optimizes how many actual connections are made to the cloud. The IoT Edge hub takes logical connections from modules or downstream devices and combines them for a single physical connection to the cloud. The details of this process are transparent to the rest of the solution. Clients think they have their own connection to the cloud even though they're all sent over the same connection. The IoT Edge hub can either use the AMQP or the MQTT protocol to communicate upstream with the cloud, independently from protocols used by downstream devices. However, the IoT Edge hub currently only supports combining logical connections into a single physical connection by using AMQP as the upstream protocol and its multiplexing capabilities. AMQP is the default upstream protocol.
75+
To reduce the bandwidth that your IoT Edge solution uses, the IoT Edge hub optimizes how many actual connections are made to the cloud. The IoT Edge hub takes logical connections from modules or downstream devices and combines them for a single physical connection to the cloud. The details of this process are transparent to the rest of the solution. Clients think they have their own connection to the cloud even though they're all sent over the same connection. The IoT Edge hub can either use the AMQP or the MQTT protocol to communicate upstream with the cloud, independently from protocols used by downstream devices.
76+
77+
> [!IMPORTANT]
78+
> IoT Edge hub only supports connection multiplexing (combining multiple logical connections into a single physical connection) when using AMQP as the upstream protocol. If you configure MQTT as the upstream protocol, each module and downstream device uses its own connection to IoT Hub. AMQP is the default upstream protocol.
79+
>
80+
> For more information about configuring the upstream protocol, see [Choose upstream protocol](production-checklist.md#choose-upstream-protocol).
7681
7782
:::image type="content" source="./media/iot-edge-runtime/gateway-communication.png" alt-text="Screenshot showing relationships to IoT Edge hub as a gateway between physical devices and IoT Hub." lightbox="./media/iot-edge-runtime/gateway-communication.png":::
7883

0 commit comments

Comments
 (0)