You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/reference/ilm/error-handling.asciidoc
+14-2Lines changed: 14 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,9 @@ When this happens, {ilm-init} moves the index to an `ERROR` step.
8
8
If {ilm-init} cannot resolve the error automatically, execution is halted
9
9
until you resolve the underlying issues with the policy, index, or cluster.
10
10
11
+
See this https://www.youtube.com/watch?v=VCIqkji3IwY[{ilm-init} health video]
12
+
for example troubleshooting walkthrough.
13
+
11
14
For example, you might have a `shrink-index` policy that shrinks an index to four shards once it
12
15
is at least five days old:
13
16
@@ -183,6 +186,8 @@ The rollover action then manages setting and updating the alias to
183
186
184
187
Do not explicitly configure this same alias in the aliases section of an index template.
185
188
189
+
See this https://www.youtube.com/watch?v=Ww5POq4zZtY[resolving `duplicate alias` video] for an example troubleshooting walkthrough.
190
+
186
191
[discrete]
187
192
==== index.lifecycle.rollover_alias [x] does not point to index [y]
188
193
@@ -191,20 +196,26 @@ Either the index is using the wrong alias or the alias does not exist.
191
196
Check the `index.lifecycle.rollover_alias` <<indices-get-settings, index setting>>.
192
197
To see what aliases are configured, use <<cat-alias, _cat/aliases>>.
193
198
199
+
See this https://www.youtube.com/watch?v=NKSe67x7aw8[resolving `not point to index` video] for an example troubleshooting walkthrough.
200
+
194
201
[discrete]
195
202
==== Setting [index.lifecycle.rollover_alias] for index [y] is empty or not defined
196
203
197
204
The `index.lifecycle.rollover_alias` setting must be configured for the rollover action to work.
198
205
199
206
Update the index settings to set `index.lifecycle.rollover_alias`.
200
207
208
+
See this https://www.youtube.com/watch?v=LRpMC2GS_FQ[resolving `empty or not defined` video] for an example troubleshooting walkthrough.
209
+
201
210
[discrete]
202
211
==== Alias [x] has more than one write index [y,z]
203
212
204
213
Only one index can be designated as the write index for a particular alias.
205
214
206
215
Use the <<indices-aliases, aliases>> API to set `is_write_index:false` for all but one index.
207
216
217
+
See this https://www.youtube.com/watch?v=jCUvZCT5Hm4[resolving `more than one write index` video] for an example troubleshooting walkthrough.
218
+
208
219
[discrete]
209
220
==== index name [x] does not match pattern ^.*-\d+
210
221
@@ -214,6 +225,8 @@ For example, `my-index` does not match the pattern requirement.
214
225
215
226
Append a numeric value to the index name, for example `my-index-000001`.
216
227
228
+
See this https://www.youtube.com/watch?v=9sp1zF6iL00[resolving `does not match pattern` video] for an example troubleshooting walkthrough.
229
+
217
230
[discrete]
218
231
==== CircuitBreakingException: [x] data too large, data for [y]
219
232
@@ -227,8 +240,7 @@ For more information, see <<circuit-breaker-errors>>.
227
240
228
241
This indicates that the cluster is running out of disk space.
229
242
This can happen when you don't have {ilm} set up to roll over from hot to warm nodes.
230
-
231
-
Consider adding nodes, upgrading your hardware, or deleting unneeded indices.
243
+
For more information, see <<fix-watermark-errors,Fix watermark errors>>.
232
244
233
245
[discrete]
234
246
==== security_exception: action [<action-name>] is unauthorized for user [<user-name>] with roles [<role-name>], this action is granted by the index privileges [manage_follow_index,manage,all]
0 commit comments