github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-04-24 01:38:56 -04:00
Code Issues Projects Releases Packages Wiki Activity

[8.8] [DOCS] Fixes errors in Troubleshoot Kibana UI error (#158855) (#161139)

Browse source 
# Backport

This will backport the following commits from `main` to `8.8`:
- [[DOCS] Fixes errors in Troubleshoot Kibana UI error
(#158855)](https://github.com/elastic/kibana/pull/158855)

<!--- Backport version: 8.9.7 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Kaarina
Tungseth","email":"kaarina.tungseth@elastic.co"},"sourceCommit":{"committedDate":"2023-06-01T18:28:09Z","message":"[DOCS]
Fixes errors in Troubleshoot Kibana UI error (#158855)\n\n##
Summary\r\n\r\nUpdates `Troubleshoot Kibana UI error` with the following
fixes:\r\n\r\n- {kib} in error code should Kibana\r\n- code shouldn’t
have “`” tick marks wrapping commands\r\n- the bullet list under Step#5
didn’t
format","sha":"c5f85b739369e4326d1518b4ab1458f39115fb74","branchLabelMapping":{"^v8.9.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","backport:skip","v8.9.0","v8.10.0","v8.8.3"],"number":158855,"url":"https://github.com/elastic/kibana/pull/158855","mergeCommit":{"message":"[DOCS]
Fixes errors in Troubleshoot Kibana UI error (#158855)\n\n##
Summary\r\n\r\nUpdates `Troubleshoot Kibana UI error` with the following
fixes:\r\n\r\n- {kib} in error code should Kibana\r\n- code shouldn’t
have “`” tick marks wrapping commands\r\n- the bullet list under Step#5
didn’t
format","sha":"c5f85b739369e4326d1518b4ab1458f39115fb74"}},"sourceBranch":"main","suggestedTargetBranches":["8.8"],"targetPullRequestStates":[{"branch":"main","label":"v8.9.0","labelRegex":"^v8.9.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/158855","number":158855,"mergeCommit":{"message":"[DOCS]
Fixes errors in Troubleshoot Kibana UI error (#158855)\n\n##
Summary\r\n\r\nUpdates `Troubleshoot Kibana UI error` with the following
fixes:\r\n\r\n- {kib} in error code should Kibana\r\n- code shouldn’t
have “`” tick marks wrapping commands\r\n- the bullet list under Step#5
didn’t
format","sha":"c5f85b739369e4326d1518b4ab1458f39115fb74"}},{"branch":"8.10","label":"v8.10.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.8","label":"v8.8.3","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>
This commit is contained in:
James Rodewig 2023-07-04 08:38:12 -04:00 • committed by GitHub
parent 7766ce0591
commit c1f10d8f4f
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

26
docs/setup/access.asciidoc
View file

@ -39,19 +39,27 @@ For JSON-formatted server status details, use the `localhost:5601/api/status` AP
[float]
[[not-ready]]
=== {kib} not ready
=== Troubleshoot {kib} UI error
If you receive an error that the {kib} `server is not ready`, check the following:
Troubleshoot the `Kibana Server is not Ready yet` error.
* The {es} connectivity:
. From within a {kib} node, confirm the connection to {es}:
+
[source,sh]
----
`curl -XGET elasticsearch_ip_or_hostname:9200/`
curl -XGET elasticsearch_ip_or_hostname:9200/
----
* The {kib} logs:
** Linux, DEB or RPM package: `/var/log/kibana/kibana.log`
** Linux, tar.gz package: `$KIBANA_HOME/log/kibana.log`
** Windows: `$KIBANA_HOME\log\kibana.log`
* The health status of `.kibana*` indices
. Guarantee the health of the three {kib}-backing indices. All indices must appear and display `status:green` and `status:open`:
+
[source,sh]
----
curl -XGET elasticsearch_ip_or_hostname:9200/_cat/indices/.kibana,.kibana_task_manager,.kibana_security_session?v=true
----
. <<start-stop,Shut down all {kib} nodes>>.
. Choose any {kib} node, then update the config to set the <<change-overall-log-level,debug logging>>.
. <<start-stop,Start the node>>, then check the start-up debug logs for `ERROR` messages or other start-up issues.
+
For example:
* When {kib} is unable to connect to a healthy {es} cluster, the `master_not_discovered_exception` or `Unable to revive connection` errors appear.
* When one or more {kib}-backing indices are unhealthy, the `index_not_green_timeout` error appears.