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

improved docs #6870

Merged
merged 4 commits into from
Oct 31, 2024
Merged
Show file tree
Hide file tree
Changes from 2 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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added servicepulse/images/retry/retry-all.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 29 additions & 0 deletions servicepulse/intro-failed-message-retries.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,32 @@ If a message was retried and came back to ServiceControl as failed it might mean
There are two ways to deal with this scenario. If the issue in the sender can be fixed, there will be no new malformed messages coming. The ones already sent can be redirected to an endpoint that specifically addresses the malformed messages. [This sample](/samples/servicecontrol/fix-messages/) shows how this can be done using the ServiceControl redirects feature.

If the sender cannot be fixed it is better to use a pipeline behavior to repair the messages at the receiver endpoint before they are passed to the handler. [This sample](/samples/pipeline/fix-messages-using-behavior/) demonstrates this scenario.


## ServicePulse interface

ServicePulse allows you to see failed messages and retry them. The UI groups these messages based on the endpoint that failed to process them. You can see the source, and the number of failed messages.
irinascurtu marked this conversation as resolved.
Show resolved Hide resolved

![Failed Messages ](/servicepulse/images/retry/failed-mesage-groups-annotated.png)
irinascurtu marked this conversation as resolved.
Show resolved Hide resolved

### Retrying failed messages

The messages can be retried in different ways:
-
irinascurtu marked this conversation as resolved.
Show resolved Hide resolved
- [One by one](#the-messages-can-be-retried-in-different-ways-one-by-one)
- [By the an entire group](#the-messages-can-be-retried-in-different-ways-by-the-an-entire-group)

#### 1. One by one

![Individual message retry](/servicepulse/images/retry/failed-mesage-groups-annotated.png)
irinascurtu marked this conversation as resolved.
Show resolved Hide resolved

In this case, you will see the a notification showing that a retry has been been requested, and it is in progress.
![Individual message retry in progress](/servicepulse/images/retry/one-retry-in-progress.png)
irinascurtu marked this conversation as resolved.
Show resolved Hide resolved

#### 2. By the an entire group

![Retry all](/servicepulse/images/retry/retry-all.png)
irinascurtu marked this conversation as resolved.
Show resolved Hide resolved

You will see a retry in progress notification for all the messages, as well as the number of messages failed decreased.

![All retried in progress](/servicepulse/images/retry/all-retry-in-progress.png)
irinascurtu marked this conversation as resolved.
Show resolved Hide resolved