From a59b04a96870b5e9bdc8802e7af0fde937bf2a50 Mon Sep 17 00:00:00 2001 From: kissmydb Date: Sun, 24 May 2020 21:06:45 +0800 Subject: [PATCH 1/3] Update post-installation-check.md --- post-installation-check.md | 129 +++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) diff --git a/post-installation-check.md b/post-installation-check.md index e69de29bb2d1..b1adeaeb66f7 100644 --- a/post-installation-check.md +++ b/post-installation-check.md @@ -0,0 +1,129 @@ +--- +title: 测试集群状态 +category: how-to +--- + +# 通过 TiDB Dashboard 和 Grafana 检查集群状态 + +## 查看 TiDB Dashboard 检查 TiDB 集群状态 + +- 通过 `{pd-ip}:{pd-port}/dashboard` 登录 TiDB Dashboard，登录用户和口令为 TiDB 数据库 root 用户和口令，如果你修改过数据库的 root 密码，则以修改后的密码为准，默认密码为空。 + + ![TiDB-Dashboard](/media/tiup/tidb-dashboard.png) + +- 主页面显示 TiDB 集群中节点信息 + + ![TiDB-Dashboard-status](/media/tiup/tidb-dashboard-status.png) + +## 查看 Grafana 监控 Overview 页面检查 TiDB 集群状态 + +- 通过 `{Grafana-ip}:3000` 登录 Grafana 监控，默认用户名及密码为 admin/admin + + ![Grafana-login](/media/tiup/grafana-login.png) + +- 点击 Overview 监控页面检查 TiDB 端口和负载监控信息 + + ![Grafana-overview](/media/tiup/grafana-overview.png) + +# 登录数据库执行简单 DML、DDL 操作和查询 SQL 语句 + +> **注意：** +> +> 登录数据库前，你需要安装 MySQL 客户端。 + +执行如下命令登录数据库： + +{{< copyable "shell-regular" >}} + +```shell +mysql -u root -h 10.0.1.4 -P 4000 +``` + +数据库操作： + +```sql +-- +-- 登录成功 +-- +-- Welcome to the MariaDB monitor. Commands end with ; or \g. +-- Your MySQL connection id is 1 +-- Server version: 5.7.25-TiDB-v4.0.0-beta-446-g5268094af TiDB Server (Apache License 2.0), MySQL 5.7 compatible +-- +-- Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. +-- +-- Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. + +-- +-- 检查 TiDB 版本 +-- +select tidb_version()\G +-- 预期结果输出 +-- *************************** 1. row *************************** +-- tidb_version(): Release Version: v4.0.0-beta-446-g5268094af +-- Git Commit Hash: 5268094afe05c7efef0d91d2deeec428cc85abe6 +-- Git Branch: master +-- UTC Build Time: 2020-03-17 02:22:07 +-- GoVersion: go1.13 +-- Race Enabled: false +-- TiKV Min Version: v3.0.0-60965b006877ca7234adaced7890d7b029ed1306 +-- Check Table Before Drop: false +-- 1 row in set (0.00 sec) +-- MySQL [tidb]> create database pingcap; +-- Query OK, 0 rows affected (0.10 sec) + +-- +-- 创建 PingCAP database +-- +create database pingcap; +-- Query OK, 0 rows affected (0.10 sec) + +use pingcap; +-- 预期输出 +-- Database changed +-- +-- 创建 tab_tidb 表 +-- +CREATE TABLE `tab_tidb` ( +`id` int(11) NOT NULL AUTO_INCREMENT, + `name` varchar(20) NOT NULL DEFAULT '', + `age` int(11) NOT NULL DEFAULT 0, + `version` varchar(20) NOT NULL DEFAULT '', + PRIMARY KEY (`id`), + KEY `idx_age` (`age`)); +-- 预期输出 +-- Query OK, 0 rows affected (0.11 sec) +-- +-- 插入数据 +-- +insert into `tab_tidb` values (1,'TiDB',5,'TiDB-v4.0.0'); +-- 预期输出 +-- Query OK, 1 row affected (0.03 sec) +-- +-- 查看 tab_tidb 结果 +-- +select * from tab_tidb; +-- 预期输出 +-- +----+------+-----+-------------+ +-- | id | name | age | version | +-- +----+------+-----+-------------+ +-- | 1 | TiDB | 5 | TiDB-v4.0.0 | +-- +----+------+-----+-------------+ +-- 1 row in set (0.00 sec) +-- +-- 查看 TiKV store 状态、store_id、存储情况以及启动时间 +-- +select STORE_ID,ADDRESS,STORE_STATE,STORE_STATE_NAME,CAPACITY,AVAILABLE,UPTIME from INFORMATION_SCHEMA.TIKV_STORE_STATUS; +-- 预期输出 +-- +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ +-- | STORE_ID | ADDRESS | STORE_STATE | STORE_STATE_NAME | CAPACITY | AVAILABLE | UPTIME | +-- +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ +-- | 1 | 10.0.1.1:20160 | 0 | Up | 49.98GiB | 46.3GiB | 5h21m52.474864026s | +-- | 4 | 10.0.1.2:20160 | 0 | Up | 49.98GiB | 46.32GiB | 5h21m52.522669177s | +-- | 5 | 10.0.1.3:20160 | 0 | Up | 49.98GiB | 45.44GiB | 5h21m52.713660541s | +-- +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ +-- 3 rows in set (0.00 sec) + +exit +-- 预期输出 +-- Bye +``` From 434a095384832811ba08015e86d333d668ed2acb Mon Sep 17 00:00:00 2001 From: kissmydb Date: Sun, 24 May 2020 21:11:30 +0800 Subject: [PATCH 2/3] Update post-installation-check.md --- post-installation-check.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/post-installation-check.md b/post-installation-check.md index b1adeaeb66f7..a3177aa3a387 100644 --- a/post-installation-check.md +++ b/post-installation-check.md @@ -1,5 +1,5 @@ --- -title: 测试集群状态 +title: 验证集群运行状态 category: how-to --- From 89328a2c6e51993bc449cf962f6288404ee05e7d Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Tue, 26 May 2020 11:09:28 +0800 Subject: [PATCH 3/3] refine format --- post-installation-check.md | 263 +++++++++++++++++++++++-------------- 1 file changed, 167 insertions(+), 96 deletions(-) diff --git a/post-installation-check.md b/post-installation-check.md index a3177aa3a387..f3df647de124 100644 --- a/post-installation-check.md +++ b/post-installation-check.md @@ -1,31 +1,38 @@ --- title: 验证集群运行状态 +summary: 介绍如何验证集群运行状态。 category: how-to --- -# 通过 TiDB Dashboard 和 Grafana 检查集群状态 +# 验证集群运行状态 -## 查看 TiDB Dashboard 检查 TiDB 集群状态 +本文档介绍如何通过 TiDB Dashboard 和 Grafana 检查集群状态，以及登录数据库执行简单 DML、DDL 操作和查询 SQL 语句。 -- 通过 `{pd-ip}:{pd-port}/dashboard` 登录 TiDB Dashboard，登录用户和口令为 TiDB 数据库 root 用户和口令，如果你修改过数据库的 root 密码，则以修改后的密码为准，默认密码为空。 +## 通过 TiDB Dashboard 和 Grafana 检查集群状态 + +本节介绍如何通过 TiDB Dashboard 和 Grafana 检查集群状态。 + +### 查看 TiDB Dashboard 检查 TiDB 集群状态 + +1. 通过 `{pd-ip}:{pd-port}/dashboard` 登录 TiDB Dashboard，登录用户和口令为 TiDB 数据库 `root` 用户和口令。如果你修改过数据库的 `root` 密码，则以修改后的密码为准，默认密码为空。 ![TiDB-Dashboard](/media/tiup/tidb-dashboard.png) -- 主页面显示 TiDB 集群中节点信息 +2. 主页面显示 TiDB 集群中节点信息 ![TiDB-Dashboard-status](/media/tiup/tidb-dashboard-status.png) -## 查看 Grafana 监控 Overview 页面检查 TiDB 集群状态 +### 查看 Grafana 监控 Overview 页面检查 TiDB 集群状态 -- 通过 `{Grafana-ip}:3000` 登录 Grafana 监控，默认用户名及密码为 admin/admin +- 通过 `{Grafana-ip}:3000` 登录 Grafana 监控，默认用户名及密码为 `admin`/`admin`。 ![Grafana-login](/media/tiup/grafana-login.png) -- 点击 Overview 监控页面检查 TiDB 端口和负载监控信息 +- 点击 **Overview** 监控页面检查 TiDB 端口和负载监控信息。 ![Grafana-overview](/media/tiup/grafana-overview.png) -# 登录数据库执行简单 DML、DDL 操作和查询 SQL 语句 +## 登录数据库执行简单 DML/DDL 操作和查询 SQL 语句 > **注意：** > @@ -39,91 +46,155 @@ category: how-to mysql -u root -h 10.0.1.4 -P 4000 ``` -数据库操作： - -```sql --- --- 登录成功 --- --- Welcome to the MariaDB monitor. Commands end with ; or \g. --- Your MySQL connection id is 1 --- Server version: 5.7.25-TiDB-v4.0.0-beta-446-g5268094af TiDB Server (Apache License 2.0), MySQL 5.7 compatible --- --- Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. --- --- Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. - --- --- 检查 TiDB 版本 --- -select tidb_version()\G --- 预期结果输出 --- *************************** 1. row *************************** --- tidb_version(): Release Version: v4.0.0-beta-446-g5268094af --- Git Commit Hash: 5268094afe05c7efef0d91d2deeec428cc85abe6 --- Git Branch: master --- UTC Build Time: 2020-03-17 02:22:07 --- GoVersion: go1.13 --- Race Enabled: false --- TiKV Min Version: v3.0.0-60965b006877ca7234adaced7890d7b029ed1306 --- Check Table Before Drop: false --- 1 row in set (0.00 sec) --- MySQL [tidb]> create database pingcap; --- Query OK, 0 rows affected (0.10 sec) - --- --- 创建 PingCAP database --- -create database pingcap; --- Query OK, 0 rows affected (0.10 sec) - -use pingcap; --- 预期输出 --- Database changed --- --- 创建 tab_tidb 表 --- -CREATE TABLE `tab_tidb` ( -`id` int(11) NOT NULL AUTO_INCREMENT, - `name` varchar(20) NOT NULL DEFAULT '', - `age` int(11) NOT NULL DEFAULT 0, - `version` varchar(20) NOT NULL DEFAULT '', - PRIMARY KEY (`id`), - KEY `idx_age` (`age`)); --- 预期输出 --- Query OK, 0 rows affected (0.11 sec) --- --- 插入数据 --- -insert into `tab_tidb` values (1,'TiDB',5,'TiDB-v4.0.0'); --- 预期输出 --- Query OK, 1 row affected (0.03 sec) --- --- 查看 tab_tidb 结果 --- -select * from tab_tidb; --- 预期输出 --- +----+------+-----+-------------+ --- | id | name | age | version | --- +----+------+-----+-------------+ --- | 1 | TiDB | 5 | TiDB-v4.0.0 | --- +----+------+-----+-------------+ --- 1 row in set (0.00 sec) --- --- 查看 TiKV store 状态、store_id、存储情况以及启动时间 --- -select STORE_ID,ADDRESS,STORE_STATE,STORE_STATE_NAME,CAPACITY,AVAILABLE,UPTIME from INFORMATION_SCHEMA.TIKV_STORE_STATUS; --- 预期输出 --- +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ --- | STORE_ID | ADDRESS | STORE_STATE | STORE_STATE_NAME | CAPACITY | AVAILABLE | UPTIME | --- +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ --- | 1 | 10.0.1.1:20160 | 0 | Up | 49.98GiB | 46.3GiB | 5h21m52.474864026s | --- | 4 | 10.0.1.2:20160 | 0 | Up | 49.98GiB | 46.32GiB | 5h21m52.522669177s | --- | 5 | 10.0.1.3:20160 | 0 | Up | 49.98GiB | 45.44GiB | 5h21m52.713660541s | --- +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ --- 3 rows in set (0.00 sec) - -exit --- 预期输出 --- Bye -``` +### 数据库操作 + ++ 登录成功 + + {{< copyable "sql" >}} + + ```sql + Welcome to the MariaDB monitor. Commands end with ; or \g. + Your MySQL connection id is 1 + Server version: 5.7.25-TiDB-v4.0.0-beta-446-g5268094af TiDB Server (Apache License 2.0), MySQL 5.7 compatible + + Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. + + Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. + ``` + ++ 检查 TiDB 版本 + + {{< copyable "sql" >}} + + ```sql + select tidb_version()\G + ``` + + 预期结果输出： + + ```sql + *************************** 1. row *************************** + tidb_version(): Release Version: v4.0.0-beta-446-g5268094af + Git Commit Hash: 5268094afe05c7efef0d91d2deeec428cc85abe6 + Git Branch: master + UTC Build Time: 2020-03-17 02:22:07 + GoVersion: go1.13 + Race Enabled: false + TiKV Min Version: v3.0.0-60965b006877ca7234adaced7890d7b029ed1306 + Check Table Before Drop: false + 1 row in set (0.00 sec) + MySQL [tidb]> create database pingcap; + Query OK, 0 rows affected (0.10 sec) + ``` + ++ 创建 PingCAP database + + {{< copyable "sql" >}} + + ```sql + create database pingcap; + ``` + + ```sql + Query OK, 0 rows affected (0.10 sec) + ``` + + {{< copyable "sql" >}} + + ```sql + use pingcap; + ``` + + 预期输出 + + ```sql + Database changed + ``` + ++ 创建 `tab_tidb` 表 + + {{< copyable "sql" >}} + + ```sql + CREATE TABLE `tab_tidb` ( + `id` int(11) NOT NULL AUTO_INCREMENT, + `name` varchar(20) NOT NULL DEFAULT '', + `age` int(11) NOT NULL DEFAULT 0, + `version` varchar(20) NOT NULL DEFAULT '', + PRIMARY KEY (`id`), + KEY `idx_age` (`age`)); + ``` + + 预期输出 + + ```sql + Query OK, 0 rows affected (0.11 sec) + ``` + ++ 插入数据 + + {{< copyable "sql" >}} + + ```sql + insert into `tab_tidb` values (1,'TiDB',5,'TiDB-v4.0.0'); + ``` + + 预期输出 + + ```sql + Query OK, 1 row affected (0.03 sec) + ``` + ++ 查看 `tab_tidb` 结果 + + {{< copyable "sql" >}} + + ```sql + select * from tab_tidb; + ``` + + 预期输出 + + ```sql + +----+------+-----+-------------+ + | id | name | age | version | + +----+------+-----+-------------+ + | 1 | TiDB | 5 | TiDB-v4.0.0 | + +----+------+-----+-------------+ + 1 row in set (0.00 sec) + ``` + ++ 查看 TiKV store 状态、`store_id`、存储情况以及启动时间 + + {{< copyable "sql" >}} + + ```sql + select STORE_ID,ADDRESS,STORE_STATE,STORE_STATE_NAME,CAPACITY,AVAILABLE,UPTIME from INFORMATION_SCHEMA.TIKV_STORE_STATUS; + ``` + + 预期输出 + + ```sql + +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ + | STORE_ID | ADDRESS | STORE_STATE | STORE_STATE_NAME | CAPACITY | AVAILABLE | UPTIME | + +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ + | 1 | 10.0.1.1:20160 | 0 | Up | 49.98GiB | 46.3GiB | 5h21m52.474864026s | + | 4 | 10.0.1.2:20160 | 0 | Up | 49.98GiB | 46.32GiB | 5h21m52.522669177s | + | 5 | 10.0.1.3:20160 | 0 | Up | 49.98GiB | 45.44GiB | 5h21m52.713660541s | + +----------+--------------------+-------------+------------------+----------+-----------+--------------------+ + 3 rows in set (0.00 sec) + ``` + ++ 退出 + + {{< copyable "sql" >}} + + ```sql + exit + ``` + + 预期输出 + + ```sql + Bye + ```