Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion architecture/azure/messaging.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,14 +19,14 @@ Azure Service Bus has two pricing tiers: [Standard and Premium](https://learn.mi
- Up to 100 MB message size on the Premium tier
- Scripted infrastructure deployment using the [NServiceBus ASB CLI](/transports/azure-service-bus/operational-scripting.md)
- Supports the AMQP 1.0 protocol over TCP and WebSockets
- Emulator for local development and testing, [albeit with limitations](/transports/azure-service-bus/#azure-service-bus-emulator-known-emulator-limitations)

:heavy_minus_sign: Cons:

- Some features are only available on the Premium tier
- The maximum message size is 256 KB on the Standard tier
- Cross-entity transactions are limited to 100 messages
- No cross-namespace communication
- Emulator for local development and testing [does not have required features](/transports/azure-service-bus/#transport-at-a-glance) to work with the Particular Service Platform.

[**Try the Azure Service Bus Tutorial →**](https://learn.microsoft.com/en-us/azure/service-bus-messaging/build-message-driven-apps-nservicebus?tabs=Sender)

Expand Down
15 changes: 14 additions & 1 deletion transports/azure-service-bus/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,17 @@ The Azure Service Bus transport leverages the [Azure.Messaging.ServiceBus](https
> [!NOTE]
> The Azure Service Bus transport only supports the Standard and Premium tiers of the Microsoft Azure Service Bus service. Premium tier is recommended for production environments.
>
> The Azure Service Bus transport is not compatible with the [Azure Service Bus emulator](https://learn.microsoft.com/en-us/azure/service-bus-messaging/overview-emulator) because the emulator [doesn't support on-the-fly management operations](https://learn.microsoft.com/en-us/azure/service-bus-messaging/overview-emulator#known-limitations) through the client-side SDK, which prevents operations like creating queues or subscribing to events.

## Azure Service Bus Emulator

The Azure Service Bus transport works with the [Azure Service Bus emulator](https://learn.microsoft.com/en-us/azure/service-bus-messaging/overview-emulator). To use the emulator, your [connection string](https://learn.microsoft.com/en-us/azure/service-bus-messaging/test-locally-with-service-bus-emulator?tabs=automated-script#choosing-the-right-connection-string) must include `UseDevelopmentEmulator=true;`

### Known Emulator Limitations

The emulator is only suitable for small systems, since it contains limitations on connections and queue size. For anything larger, a full Azure Service Bus instance will be required.

The current [known limitations](https://learn.microsoft.com/en-us/azure/service-bus-messaging/overview-emulator#known-limitations) that affect functionality with the Particular Service Platform are:

- A limit of 10 connections. Each NServiceBus endpoint will use a connection for sending and a connection for receiving, effectively using 2 connections for a full endpoint.
- `MaxDeliveryCount` is fixed at 10.

Loading