Skip to content

Commit 5128eea

Browse files
tsullivangchaps
andauthored
[Reporting/Docs] Add section to troubleshooting guide to explain the StatusCodeError logs (elastic#102278) (elastic#102414)
* [Reporting/Docs] Add section to troubleshooting guide to explain the StatusCodeError logs * Update docs/user/reporting/reporting-troubleshooting.asciidoc Co-authored-by: gchaps <[email protected]> * use script formatting around error message block Co-authored-by: gchaps <[email protected]> Co-authored-by: gchaps <[email protected]>
1 parent 4e991d2 commit 5128eea

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

docs/user/reporting/reporting-troubleshooting.asciidoc

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,32 @@ the first time Kibana starts when verbose logging is enabled.
9191
Whenever possible, a Reporting error message tries to be as self-explanatory as possible. Here are some error messages you might encounter,
9292
along with the solution.
9393

94+
[float]
95+
==== `StatusCodeError: [version_conflict_engine_exception]`
96+
If you are running multiple instances of {kib} in a cluster, the instances share the work of executing report jobs to evenly distribute
97+
the work load. Each instance searches the reporting index for "pending" jobs that the user has requested. It is possible for
98+
multiple instances to find the same job in these searches. Only the instance that successfully updated the job status to
99+
"processing" will actually execute the report job. The other instances that unsuccessfully tried to make the same update will log
100+
something similar to this:
101+
102+
[source]
103+
--------------------------------------------------------------------------------
104+
StatusCodeError: [version_conflict_engine_exception] [...]: version conflict, required seqNo [6124], primary term [1]. current document has seqNo [6125] and primary term [1], with { ... }
105+
status: 409,
106+
displayName: 'Conflict',
107+
path: '/.reporting-...',
108+
body: {
109+
error: {
110+
type: 'version_conflict_engine_exception',
111+
reason: '[...]: version conflict, required seqNo [6124], primary term [1]. current document has seqNo [6125] and primary term [1]',
112+
},
113+
},
114+
statusCode: 409
115+
}
116+
--------------------------------------------------------------------------------
117+
118+
These messages alone don't indicate a problem. They show normal events that happen in a healthy system.
119+
94120
[float]
95121
==== Max attempts reached
96122
There are two primary causes of this error:

0 commit comments

Comments
 (0)