Skip to content

Commit 6d9b493

Browse files
committed
(Doc+) troubleshoot ILM videos (#114528)
This links to our 6 newest [Support Troubleshooting](https://www.youtube.com/playlist?list=PL_mJOmq4zsHbQlfEMEh_30_LuV_hZp-3d) videos which are about resolving general ILM Health & the top five ILM rollover errors to the existing [Troubleshooting ILM errors](https://www.elastic.co/guide/en/elasticsearch/reference/master/index-lifecycle-error-handling.html). It side quests to link the watermark error to [its troubleshooting doc](https://www.elastic.co/guide/en/elasticsearch/reference/master/fix-watermark-errors.html). (cherry picked from commit 9770ab7)
1 parent b84e990 commit 6d9b493

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

docs/reference/ilm/error-handling.asciidoc

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@ When this happens, {ilm-init} moves the index to an `ERROR` step.
88
If {ilm-init} cannot resolve the error automatically, execution is halted
99
until you resolve the underlying issues with the policy, index, or cluster.
1010

11+
See this https://www.youtube.com/watch?v=VCIqkji3IwY[{ilm-init} health video]
12+
for example troubleshooting walkthrough.
13+
1114
For example, you might have a `shrink-index` policy that shrinks an index to four shards once it
1215
is at least five days old:
1316

@@ -183,6 +186,8 @@ The rollover action then manages setting and updating the alias to
183186

184187
Do not explicitly configure this same alias in the aliases section of an index template.
185188

189+
See this https://www.youtube.com/watch?v=Ww5POq4zZtY[resolving `duplicate alias` video] for an example troubleshooting walkthrough.
190+
186191
[discrete]
187192
==== index.lifecycle.rollover_alias [x] does not point to index [y]
188193

@@ -191,20 +196,26 @@ Either the index is using the wrong alias or the alias does not exist.
191196
Check the `index.lifecycle.rollover_alias` <<indices-get-settings, index setting>>.
192197
To see what aliases are configured, use <<cat-alias, _cat/aliases>>.
193198

199+
See this https://www.youtube.com/watch?v=NKSe67x7aw8[resolving `not point to index` video] for an example troubleshooting walkthrough.
200+
194201
[discrete]
195202
==== Setting [index.lifecycle.rollover_alias] for index [y] is empty or not defined
196203

197204
The `index.lifecycle.rollover_alias` setting must be configured for the rollover action to work.
198205

199206
Update the index settings to set `index.lifecycle.rollover_alias`.
200207

208+
See this https://www.youtube.com/watch?v=LRpMC2GS_FQ[resolving `empty or not defined` video] for an example troubleshooting walkthrough.
209+
201210
[discrete]
202211
==== Alias [x] has more than one write index [y,z]
203212

204213
Only one index can be designated as the write index for a particular alias.
205214

206215
Use the <<indices-aliases, aliases>> API to set `is_write_index:false` for all but one index.
207216

217+
See this https://www.youtube.com/watch?v=jCUvZCT5Hm4[resolving `more than one write index` video] for an example troubleshooting walkthrough.
218+
208219
[discrete]
209220
==== index name [x] does not match pattern ^.*-\d+
210221

@@ -214,6 +225,8 @@ For example, `my-index` does not match the pattern requirement.
214225

215226
Append a numeric value to the index name, for example `my-index-000001`.
216227

228+
See this https://www.youtube.com/watch?v=9sp1zF6iL00[resolving `does not match pattern` video] for an example troubleshooting walkthrough.
229+
217230
[discrete]
218231
==== CircuitBreakingException: [x] data too large, data for [y]
219232

@@ -227,8 +240,7 @@ For more information, see <<circuit-breaker-errors>>.
227240

228241
This indicates that the cluster is running out of disk space.
229242
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>>.
232244

233245
[discrete]
234246
==== 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

Comments
 (0)