RDoc-3843_taskErrors - document new task errors views and functionality#2450
Open
reebhub wants to merge 7 commits into
Open
RDoc-3843_taskErrors - document new task errors views and functionality#2450reebhub wants to merge 7 commits into
reebhub wants to merge 7 commits into
Conversation
…nerating embeddings)
Lwiel
reviewed
May 20, 2026
Comment on lines
+113
to
+115
| * **Persistence** (AI tasks only) | ||
| The task could not save its results back to the database. Typical causes include write | ||
| conflicts or storage errors. |
Contributor
There was a problem hiding this comment.
It also occurs when we fail to update process state, so it's not AI tasks only
| The retention is per task and per table, so a single noisy task cannot push errors out of an | ||
| unrelated task. The cap is not configurable. | ||
|
|
||
| Errors are also included in the server's debug package as `etl.errors.json`, so support |
Contributor
There was a problem hiding this comment.
AI task errors are stored separately
|
|
||
| A task recovers automatically as new batches complete. The health state transitions from | ||
| `Failed` back to `Impaired`, and from `Impaired` back to `Healthy`, as the running error rate | ||
| falls below each threshold. There is no manual "reset" action. |
Contributor
There was a problem hiding this comment.
Maybe it's worth noting we reset health state back to Healthy on task configuration update
Comment on lines
+222
to
+229
| `GET /databases/*/tasks/errors` returns errors across all ETL and AI tasks. | ||
| `GET /databases/*/etl/errors` and `GET /databases/*/ai/errors` return errors per category. | ||
| `DELETE` variants of each path remove errors in bulk, optionally filtered by task name or | ||
| category. For example, `DELETE /databases/*/etl/errors?name=<task-name>` clears the errors | ||
| of one specific ETL task. | ||
| `POST /databases/*/etl/retry-batch` forces an immediate retry of an ETL task currently in | ||
| fallback mode. | ||
| See [Debug Endpoints](../../server/troubleshooting/debug-routes.mdx#debug-endpoints) for the full reference. |
|
|
||
| <ContentFrame> | ||
|
|
||
| ### Task health indicators |
Contributor
There was a problem hiding this comment.
Maybe let's mention that only node the task is currently on and nodes that contain any errors are displayed here
…ing-tasks/general-info) to use it as a reference from task errors pages
Lwiel
reviewed
May 22, 2026
| * Retention is per task and per table, so a single noisy task cannot push errors out of | ||
| an unrelated task. | ||
|
|
||
| * Errors are also included in the server's debug package as `etl.errors.json`, so |
Contributor
There was a problem hiding this comment.
There's separate json file with AI tasks errors
Lwiel
approved these changes
May 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue link
RDoc-3843
RDoc-3844
RDoc-3845
RDoc-3849
RDoc-3775
RDoc-3854
RDoc-3861
RDoc-3851
RDoc-3811
Type of change
/templatesor readme)Changes in docs URLs
/scripts/redirects.jsonfile, setDocuments MovedPR label)Changes in UX/UI