Skip to content

Commit 88a4540

Browse files
authored
Remove some troubleshooting content from Deploy and manage (#450)
As part of changing 3 dupes into 3 distinct pages, this PR removes some Kibana troubleshooting content from the Deploy and manage section so it can live in the new consolidated Troubleshoot section. [Preview](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/450/deploy-manage/deploy/self-managed/access) (Corresponding TS files [no. 1](https://github.com/elastic/docs-content/pull/452/files#diff-eb1480bc728b8d2a24e29dec4bd920b4ac0d473de5f6336048a55e50b37a0ada) and [no. 2](https://github.com/elastic/docs-content/pull/452/files#diff-d20506a7eb9d312fdd12e1426962fb7eed47b12184e8af23b000bc1cb9acc679) are currently in limbo, but titles are correct here!)
1 parent 03461a8 commit 88a4540

File tree

5 files changed

+7
-49
lines changed

5 files changed

+7
-49
lines changed

deploy-manage/deploy/cloud-on-k8s/kibana-instance-quickstart.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ To deploy a simple [{{kib}}](https://www.elastic.co/guide/en/kibana/current/intr
3737
kubectl get pod --selector='kibana.k8s.elastic.co/name=quickstart'
3838
```
3939

40-
{{kib}} will be status `available` once [`get`](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_get/) reports `green`. If it experiences issues starting up, use [`logs`](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_logs/) against the pod in order to [Troubleshoot {{kib}} start-up](https://www.elastic.co/guide/en/kibana/current/access.html#not-ready).
40+
{{kib}} will be status `available` once [`get`](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_get/) reports `green`. If it experiences issues starting up, use [`logs`](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_logs/) against the pod in order to make sure the {{kib}} server is [ready](/troubleshoot/kibana/error-server-not-ready.md).
4141

4242
3. Access {{kib}}.
4343

deploy-manage/deploy/self-managed/access.md

Lines changed: 3 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -33,48 +33,6 @@ If you are using a self-managed deployment, access {{kib}} through the web appli
3333
3. Go to the home page, then click **{{kib}}**.
3434
4. To make the {{kib}} page your landing page, click **Make this my landing page**.
3535

36-
37-
## Check the {{kib}} status [status]
38-
39-
The status page displays information about the server resource usage and installed plugins.
40-
41-
To view the {{kib}} status page, use the status endpoint. For example, `localhost:5601/status`.
42-
43-
:::{image} ../../../images/kibana-kibana-status-page-7_14_0.png
44-
:alt: Kibana server status page
45-
:class: screenshot
46-
:::
47-
48-
For JSON-formatted server status details, use the `localhost:5601/api/status` API endpoint.
49-
50-
51-
## Troubleshoot {{kib}} UI error [not-ready]
52-
53-
Troubleshoot the `Kibana Server is not Ready yet` error.
54-
55-
1. From within a {{kib}} node, confirm the connection to {{es}}:
56-
57-
```sh
58-
curl -XGET elasticsearch_ip_or_hostname:9200/
59-
```
60-
61-
2. Guarantee the health of the three {{kib}}-backing indices. All indices must appear and display `status:green` and `status:open`:
62-
63-
```sh
64-
curl -XGET elasticsearch_ip_or_hostname:9200/_cat/indices/.kibana,.kibana_task_manager,.kibana_security_session?v=true
65-
```
66-
67-
These {{kib}}-backing indices must also not have [index settings](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-settings) flagging `read_only_allow_delete` or `write` [index blocks](https://www.elastic.co/guide/en/elasticsearch/reference/current/index-modules-blocks.html).
68-
69-
3. [Shut down all {{kib}} nodes](../../maintenance/start-stop-services/start-stop-kibana.md).
70-
4. Choose any {{kib}} node, then update the config to set the [debug logging](../../monitor/logging-configuration/kibana-log-settings-examples.md#change-overall-log-level).
71-
5. [Start the node](../../maintenance/start-stop-services/start-stop-kibana.md), then check the start-up debug logs for `ERROR` messages or other start-up issues.
72-
73-
For example:
74-
75-
* When {{kib}} is unable to connect to a healthy {{es}} cluster, errors like `master_not_discovered_exception` or `unable to revive connection` or `license is not available` errors appear.
76-
* When one or more {{kib}}-backing indices are unhealthy, the `index_not_green_timeout` error appears.
77-
78-
79-
You can find a Kibana health troubleshooting walkthrough in [this blog](https://www.elastic.co/blog/troubleshooting-kibana-health) or in [this video](https://www.youtube.com/watch?v=AlgGYcpGvOA).
80-
36+
## Resources
37+
* [Troubleshoot: Check {{kib}} server status](/troubleshoot/kibana/access.md)
38+
* [Troubleshoot: Error: {{kib}} server is not ready yet](/troubleshoot/kibana/error-server-not-ready.md)

troubleshoot/elasticsearch/fix-watermark-errors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ mapped_pages:
1111

1212
When a data node is critically low on disk space and has reached the [flood-stage disk usage watermark](https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-cluster.html#cluster-routing-flood-stage), the following error is logged: `Error: disk usage exceeded flood-stage watermark, index has read-only-allow-delete block`.
1313

14-
To prevent a full disk, when a node reaches this watermark, {{es}} [blocks writes](https://www.elastic.co/guide/en/elasticsearch/reference/current/index-modules-blocks.html#index-block-settings) to any index with a shard on the node. If the block affects related system indices, {{kib}} and other {{stack}} features may become unavailable. For example, this could induce {{kib}}'s `Kibana Server is not Ready yet` [error message](../../deploy-manage/deploy/self-managed/access.md#not-ready).
14+
To prevent a full disk, when a node reaches this watermark, {{es}} [blocks writes](https://www.elastic.co/guide/en/elasticsearch/reference/current/index-modules-blocks.html#index-block-settings) to any index with a shard on the node. If the block affects related system indices, {{kib}} and other {{stack}} features may become unavailable. For example, this could induce {{kib}}'s `Kibana Server is not Ready yet` [error message](/troubleshoot/kibana/error-server-not-ready.md).
1515

1616
{{es}} will automatically remove the write block when the affected node’s disk usage falls below the [high disk watermark](https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-cluster.html#cluster-routing-watermark-high). To achieve this, {{es}} attempts to rebalance some of the affected node’s shards to other nodes in the same data tier.
1717

troubleshoot/elasticsearch/monitoring-troubleshooting.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ For issues that you cannot fix yourself … we’re here to help. If you are an
2727
In some cases, you can also retrieve this information via APIs:
2828

2929
* For Beat instances, use the HTTP endpoint to retrieve the `uuid` property. For example, refer to [Configure an HTTP endpoint for {{filebeat}} metrics](https://www.elastic.co/guide/en/beats/filebeat/current/http-endpoint.html).
30-
* For {{kib}} instances, use the [status endpoint](../../deploy-manage/deploy/self-managed/access.md#status) to retrieve the `uuid` property.
30+
* For {{kib}} instances, use the [status endpoint](/troubleshoot/kibana/access.md) to retrieve the `uuid` property.
3131
* For {{ls}} nodes, use the [monitoring APIs root resource](https://www.elastic.co/guide/en/logstash/current/monitoring-logstash.html) to retrieve the `id` property.
3232

3333
::::{tip}

troubleshoot/kibana/capturing-diagnostics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,4 +109,4 @@ The following are common errors that you might encounter when running the diagno
109109
110110
* `{{kib}} Server is not Ready yet`
111111
112-
This indicates issues with {{kib}}'s dependencies blocking full start-up. To investigate, check [Troubleshoot {{kib}} UI error](../../deploy-manage/deploy/self-managed/access.md#not-ready).
112+
This indicates issues with {{kib}}'s dependencies blocking full start-up. To investigate, check [Error: {{kib}}} server is not ready yet](/troubleshoot/kibana/error-server-not-ready.md).

0 commit comments

Comments
 (0)