Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Pub/sub resiliency] clarify built-in retries vs Dapr's retry policies #4325

Merged
merged 2 commits into from
Aug 22, 2024
Merged
Changes from 1 commit
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
Next Next commit
add note about implicit retries
Signed-off-by: Hannah Hunter <hannahhunter@microsoft.com>
hhunter-ms committed Aug 20, 2024
commit b8b877a9a160d51fc7fa6f0567580d93549b6041
8 changes: 7 additions & 1 deletion daprdocs/content/en/operations/resiliency/policies.md
Original file line number Diff line number Diff line change
@@ -35,7 +35,13 @@ If you don't specify a timeout value, the policy does not enforce a time and def

## Retries

With `retries`, you can define a retry strategy for failed operations, including requests failed due to triggering a defined timeout or circuit breaker policy. The following retry options are configurable:
With `retries`, you can define a retry strategy for failed operations, including requests failed due to triggering a defined timeout or circuit breaker policy.

{{% alert title="Pub/sub component retries vs inbound resiliency" color="warning" %}}
Each [pub/sub component]({{< ref supported-pubsub >}}) has its own built-in retry behaviors. Explicity applying a Dapr resiliency policy doesn't override these implicit retry policies. Rather, the resiliency policy augments the built-in retry, which can cause repetitive clustering of messages.
{{% /alert %}}

The following retry options are configurable:

| Retry option | Description |
| ------------ | ----------- |
Original file line number Diff line number Diff line change
@@ -11,6 +11,11 @@ no_list: true

The following table lists publish and subscribe brokers supported by the Dapr pub/sub building block. [Learn how to set up different brokers for Dapr publish and subscribe.]({{< ref setup-pubsub.md >}})

{{% alert title="Pub/sub component retries vs inbound resiliency" color="warning" %}}
Each pub/sub component has its own built-in retry behaviors. Before explicity applying a [Dapr resiliency policy]({{< ref "policies.md" >}}), make sure you understand the implicit retry policy of the pub/sub component you're using. Instead of overriding these built-in retries, Dapr resiliency augments them, which can cause repetitive clustering of messages.
{{% /alert %}}


{{< partial "components/description.html" >}}

{{< partial "components/pubsub.html" >}}