Skip to content

Commit 8ec1a89

Browse files
committed
add docs for manage-elasticsearch-cluster
Signed-off-by: seven <[email protected]>
1 parent db1dde3 commit 8ec1a89

File tree

12 files changed

+190
-100
lines changed

12 files changed

+190
-100
lines changed

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ dist
121121

122122
# Stores VSCode versions used for testing VSCode extensions
123123
.vscode-test
124-
124+
.DS_Store
125125
# yarn v2
126126
.yarn/cache
127127
.yarn/unplugged

docs/.vitepress/config.mts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@ export default defineConfig({
4646
{text: 'Installation', link: '/docs/installation'},
4747
{text: 'Connect to Server', link: '/docs/connect-to-server'},
4848
{text: 'Shortcuts', link: '/docs/shortcut'},
49+
{text: 'Manage and Monitor Cluster', link: '/docs/manage-elasticsearch-cluster'},
4950
]
5051
},
5152
{

docs/docs.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,25 @@
11
# Document
2-
DocKit as a NoSQL/NewSQL GUI client Elasticsearch, OpenSearch, and more to come. This document outlines how to use DocKit.
2+
3+
DocKit as a NoSQL/NewSQL GUI client Elasticsearch, OpenSearch, and more to come. This document outlines how to use
4+
DocKit.
5+
36
## [Installation Guide](/docs/installation.md)
7+
48
Thanks for trying out DocKit! :rocket::rocket::rocket: This guide will help you get started with DocKit.
59

610
## [Connect to Server](/docs/connect-to-server.md)
7-
DocKit as a NoSQL GUI client, it supports multiple databases, including Elasticsearch, OpenSearch, and more to come. This document outlines how to connect to a ElasticSearch server using DocKit.
11+
12+
DocKit as a NoSQL GUI client, it supports multiple databases, including Elasticsearch, OpenSearch, and more to come.
13+
This document outlines how to connect to a ElasticSearch server using DocKit.
814

915
## [Shortcuts Introduction](/docs/shortcut.md)
10-
As a Desktop Application, DocKit provides a set of shortcuts to help users use DocKit more efficiently. This document outlines the available shortcuts and corresponding actions.
16+
17+
As a Desktop Application, DocKit provides a set of shortcuts to help users use DocKit more efficiently. This document
18+
outlines the available shortcuts and corresponding actions.
19+
20+
## [Manage Elasticsearch Cluster](/docs/manage-elasticsearch-cluster.md)
21+
22+
DocKit as a NoSQL GUI client, it supports to monitor and manage Elasticsearch including indices and alias management,
23+
nodes management, shards management, and templates management. This document outlines how to monitor and manage
24+
Elasticsearch in DocKit.
1125

docs/docs/connect-to-server.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,16 @@ Notice:
2828
1. the host requires a comprehensive domain include protocol `http` or `https`
2929
2. if you try to connect to a self-signed Elasticsearch server, you can disable the certificate validation by unblock
3030
the :lock:
31+
3. if your Elasticsearch server requires authentication, you can input the username and password to connect to it
3132

3233
## Test connection
3334

3435
once all your input finish, simply click the `Test Connection` button to verify if DocKit can connect to the configured
3536
Elasticsearch server
3637

38+
Notice: Test and Save the connection requires permission `view_index_metadata` at least, and specify the index name if
39+
your user's role has no permission to access all indices.
40+
3741
## Save Connection
3842

3943
Simply Click `Confirm` to save Connections so you can always access target Elasticsearch server with DocKit.
Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: DocKit Monitor and Manage Elasticsearch Cluster
3+
description: Use DocKit to monitor and manage Elasticsearch including indices and alias management,
4+
nodes management, shards management, and templates management. This document outlines how to monitor and manage Elasticsearch in DocKit.
5+
head:
6+
- - meta
7+
- name: keywords
8+
content: DocKit, Elasticsearch GUI client, connect Elasticsearch server, Elasticsearch connection guide, Elasticsearch management tool, Elasticsearch desktop client, Elasticsearch data management, Elasticsearch data analysis, Elasticsearch data visualization, Elasticsearch query tool, Elasticsearch cross-platform client, Elasticsearch open-source client, Elasticsearch Mac client, Elasticsearch Windows client, Elasticsearch Linux client, Elasticsearch AI-powered search, Elasticsearch multiple server support
9+
---
10+
11+
# DocKit Monitor and Manage Elasticsearch Cluster
12+
13+
DocKit as a NoSQL GUI client, it supports to monitor and manage Elasticsearch including indices and alias management,
14+
nodes management, shards management, and templates management. This document outlines how to monitor and manage
15+
Elasticsearch in DocKit.
16+
17+
## Install and Open DocKit
18+
19+
You can find detailed instructions on how to install and open DocKit in
20+
the [installation guide](../docs/installation.md).
21+
22+
## Connect to Elasticsearch Server
23+
24+
You can find detailed instructions on how to connect to Elasticsearch
25+
Server [connection guide](../docs/connect-to-server.md).
26+
27+
## Monitor & Manage Elasticsearch Cluster
28+
29+
### Cluster Management & Monitor
30+
31+
Click the `Manage` panel to monitor and manage the Elasticsearch cluster, you can view the cluster health, indices,
32+
nodes, and shards information as below:
33+
![DocKit manage panel](/manage-cluster.png)
34+
In Cluster page, you can view the cluster health, nodes number, indices number, shards number, and other cluster
35+
overview information.
36+
37+
### Nodes Management & Monitor
38+
39+
Click the `Nodes` tab to view the nodes list, you can see the list of nodes, click a node, you can view the node name,
40+
IP, disk information, memory usage and other useful node information.
41+
![DocKit Nodes manage UI](/manage-nodes.png)
42+
43+
### Shards Management & Monitor
44+
45+
Click the `Shards` tab to view the shards list, you can view the shard name, index name, state, and other shards related
46+
information. click the shard item, DocKit will show the selected shard detail information like docs count, size, memory
47+
and etc.
48+
49+
![DocKit Shards manage UI](/manage-shards.png)
50+
51+
### Indices Management & Monitor
52+
53+
Click the `Indices` tab to view the indices list, you can view the index name, document count, state, health and other
54+
index
55+
information, you can also:
56+
57+
- Create the index by clicking the `New Index` button on the right top,
58+
- Delete the index by clicking the `...` in the `Actions` column and select the `Delete` option,
59+
- Close/open the index by clicking the `...` in the `Actions` column and select the `Close`/`Open` option,
60+
- Refresh the index by clicking the `Refresh` button on the right top.
61+
- Remove the alias by clicking the icon in the `Aliases` column and select the `Remove Alias` option.
62+
- Switch the alias by clicking the icon in the `Aliases` column and select the `Switch Alias` option.
63+
64+
![DocKit Indices manage UI](/manage-indices.png)
65+
66+
### Templates Management & Monitor
67+
68+
Click the `Templates` tab to view the templates list, you can view the template name, type, version and other template
69+
related information. You can also click `Create Template` button on the right top to create a new template.
70+
71+
![DocKit Templates manage UI](/manage-template.png)

docs/public/manage-cluster.png

758 KB
Loading

docs/public/manage-indices.png

893 KB
Loading

docs/public/manage-nodes.png

764 KB
Loading

docs/public/manage-shards.png

1.11 MB
Loading

docs/public/manage-template.png

841 KB
Loading

0 commit comments

Comments
 (0)