Skip to content

Commit b32ebca

Browse files
committed
adding more details. some TBDs for client versions
1 parent 056c553 commit b32ebca

File tree

1 file changed

+28
-3
lines changed

1 file changed

+28
-3
lines changed

articles/event-hubs/geo-replication.md

Lines changed: 28 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,11 @@ Some of the key aspects of Geo-data Replication feature are:
7171
- Customer-managed promotion from primary to secondary region, providing full ownership and visibility for outage resolution. Metrics are available, which can help to automate the promotion from customer side.
7272
Secondary regions can be added or removed at the customer's discretion.
7373
- Replication consistency - There are two replication consistency settings, synchronous and asynchronous.
74+
75+
| State | Diagram |
76+
| --- | ---|
77+
| Before failover (promotion of secondary) | :::image type="content" source="./media/geo-replication/a-as-primary.png" alt-text="Diagram showing when region A is primary, B is secondary."::: |
78+
| After failover (promotion of secondary) | :::image type="content" source="./media/geo-replication/b-as-primary.png" alt-text="Diagram showing when B is made the primary, that A becomes the new secondary."::: |
7479

7580
## Replication modes
7681
There are two replication consistency configurations, synchronous and asynchronous. It's important to know the differences between the two configurations as they have an impact on your applications and your data consistency.
@@ -169,6 +174,7 @@ Offsets are committed to Event Hubs directly and offsets are replicated across r
169174
Here are the list of Apache Kafka clients that are supported -
170175

171176
TBD add versions.
177+
172178
| Client name | Version |
173179
| ----------- | ------- |
174180
| Apache Kafka | |
@@ -177,6 +183,7 @@ TBD add versions.
177183
In the case of other libraries, these are supported based on the versioning of the specific definitions -
178184

179185
TBD add protocol versions.
186+
180187
| Operation name | Version supported |
181188
| -------------- | ----------------- |
182189
|||
@@ -198,9 +205,11 @@ TBD add other language package names
198205
| C# | [Microsoft.Azure.EventHubs](https://www.nuget.org/packages/Microsoft.Azure.EventHubs/) |
199206

200207
> [!WARNING]
201-
> If you use the legacy SDK, [Windows.Azure.ServiceBus](https://www.nuget.org/packages/WindowsAzure.ServiceBus/) you may encounter issues consuming from a geo-replication namespace after promotion of the secondary to primary.
208+
> As part of the implementation, the checkpoint format is adapted when geo-replication is enabled on a namespace. Subsequent checkpoints after the geo-replication is complete will be written with a new format. If you promote a secondary region to primary right after the geo-replication pairing is done but before a new checkpoint is stored (this may happen in the case of forced promotion/failover), then a new data published post promotion may be lost.
202209
>
203-
> It is recommended to upgrade to the [latest versions of the SDKs](sdks.md)
210+
> In such cases, it is preferred to start consuming from the last committed offset. Some data might have duplicate processing and must be handled on the client side.
211+
>
212+
> It is also recommended to upgrade to the [latest versions of the SDKs](sdks.md).
204213
>
205214
206215
## Considerations
@@ -211,7 +220,23 @@ Note the following considerations to keep in mind with this feature:
211220
- Promoting a complex distributed infrastructure should be [rehearsed](/azure/architecture/reliability/disaster-recovery#disaster-recovery-plan) at least once.
212221

213222
## Pricing
214-
Event Hubs dedicated clusters are priced independently of geo-replication. Use of geo-replication with Event Hubs dedicated requires you to have at least two dedicated clusters in separate regions. The dedicated clusters used as secondary instances for geo-replication can be used for other workloads. There's a charge for geo-replication based on the published bandwidth * the number of secondary regions. The geo-replication charge is waived in early public preview.
223+
224+
Geo-replication pricing has 2 parameters -
225+
226+
* The compute charge for the cluster or namespace.
227+
* The bandwidth charge for the data being replicated between the primary and secondary regions.
228+
229+
### Dedicated clusters
230+
231+
Use of geo-replication with Event Hubs dedicated requires you to have at least two dedicated clusters in separate regions, which can be used to host namespaces other than the one being geo-replicated. These dedicated clusters are billed separately based on the number of Capacity Units (CUs) allocated to each.
232+
233+
Bandwidth is charged based on the data transferred between the primary and secondary regions.
234+
235+
### Premium namespaces
236+
237+
For Premium namespaces, enabling geo-replication provisions the same number of processing units (PUs) in the secondary region. Thus, enabling geo-replication on a premium namespace doubles the Processing Units (PUs) billed.
238+
239+
Bandwidth is charged based on the data transferred between the primary and secondary regions.
215240

216241
## Related content
217242
To learn how to use the Geo-replication feature, see [Use Geo-replication](use-geo-replication.md).

0 commit comments

Comments
 (0)