Skip to content

Commit

Permalink
[DOC+][Troubleshooting] Kibana Server not Ready yet (#158379)
Browse files Browse the repository at this point in the history
## Summary

Expands [Kibana not Ready](https://www.elastic.co/guide/en/kibana/master/access.html#not-ready)
doc to
1. allow direct google search
2. expand on the expected troubleshooting steps for common situations seen in Support

### Checklist

### Risk Matrix

### For maintainers

- [X] This was checked for breaking API changes and was [labeled
appropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)

---------

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>
  • Loading branch information
stefnestor and KOTungseth committed May 27, 2023
1 parent 2568338 commit c726951
Showing 1 changed file with 16 additions and 9 deletions.
25 changes: 16 additions & 9 deletions docs/setup/access.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -39,19 +39,26 @@ 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 `{kib} 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/`
----
* 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.

0 comments on commit c726951

Please sign in to comment.