docs(Grafana): update to simplify Grafana installtion
Ref: [TD-16627](https://jira.taosdata.com:18080/browse/TD-16627)
This commit is contained in:
parent
ffd69aa32d
commit
4dc5625882
|
@ -31,38 +31,41 @@ TDengine currently supports Grafana versions 7.5 and above. Users can go to the
|
||||||
### Install Grafana Plugin and Configure Data Source
|
### Install Grafana Plugin and Configure Data Source
|
||||||
|
|
||||||
<Tabs defaultValue="script">
|
<Tabs defaultValue="script">
|
||||||
<TabItem value="script" label="Using Script">
|
<TabItem value="gui" label="With GUI">
|
||||||
|
|
||||||
Set the url and authorization environment variables by `export` or a [`.env`(dotenv) file](https://hexdocs.pm/dotenvy/dotenv-file-format.html):
|
Under Grafana 8, plugin catalog allows you to [browse and manage plugins within Grafana](https://grafana.com/docs/grafana/next/administration/plugin-management/#plugin-catalog) (but for Grafana 7.x, use **With Script** or **Install & Configure Manually**). Find the page at **Configurations > Plugins**, search **TDengine** and click it to install.
|
||||||
|
|
||||||
```sh
|

|
||||||
export TDENGINE_API=http://tdengine.local:6041
|
|
||||||
# user + password
|
|
||||||
export TDENGINE_USER=user
|
|
||||||
export TDENGINE_PASSWORD=password
|
|
||||||
|
|
||||||
# Other useful variables
|
Installation may cost some minutes, then you can **Create a TDengine data source**:
|
||||||
# - If to install TDengine data source, default is true
|
|
||||||
export TDENGINE_DS_ENABLED=false
|
|
||||||
# - Data source name to be created, default is TDengine
|
|
||||||
export TDENGINE_DS_NAME=TDengine
|
|
||||||
# - Data source organization id, default is 1
|
|
||||||
export GF_ORG_ID=1
|
|
||||||
# - Data source is editable in admin ui or not, default is 0 (false)
|
|
||||||
export TDENGINE_EDITABLE=1
|
|
||||||
```
|
|
||||||
|
|
||||||
Run `install.sh`:
|

|
||||||
|
|
||||||
```sh
|
Then you can add a TDengine data source by filling up the configuration options.
|
||||||
bash -c "$(curl -fsSL https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)"
|
|
||||||
```
|
|
||||||
|
|
||||||
With this script, TDengine data source plugin and the Grafana data source will be installed and created automatically with Grafana provisioning configurations. Save the script and type `./install.sh --help` for the full usage of the script.
|

|
||||||
|
|
||||||
And then, restart Grafana service and open Grafana in web-browser, usually <http://localhost:3000>.
|
You can create dashboards with TDengine now.
|
||||||
|
|
||||||
</TabItem>
|
</TabItem>
|
||||||
|
<TabItem value="script" label="With Script">
|
||||||
|
|
||||||
|
In Grafana server, run `install.sh` with TDengine url and username/passwords will install TDengine data source plugin and add a data source named TDengine. This is the recommended way for Grafana 7.x or [Grafana provisioning](https://grafana.com/docs/grafana/latest/administration/provisioning/) users.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
bash -c "$(curl -fsSL \
|
||||||
|
https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)" -- \
|
||||||
|
-a http://localhost:6041 \
|
||||||
|
-u root \
|
||||||
|
-p taosdata
|
||||||
|
```
|
||||||
|
|
||||||
|
Restart Grafana service and open Grafana in web-browser, usually <http://localhost:3000>.
|
||||||
|
|
||||||
|
Save the script and type `./install.sh --help` for the full usage of the script.
|
||||||
|
|
||||||
|
</TabItem>
|
||||||
|
|
||||||
<TabItem value="manual" label="Install & Configure Manually">
|
<TabItem value="manual" label="Install & Configure Manually">
|
||||||
|
|
||||||
Follow the installation steps in [Grafana](https://grafana.com/grafana/plugins/tdengine-datasource/?tab=installation) with the [``grafana-cli`` command-line tool](https://grafana.com/docs/grafana/latest/administration/cli/) for plugin installation.
|
Follow the installation steps in [Grafana](https://grafana.com/grafana/plugins/tdengine-datasource/?tab=installation) with the [``grafana-cli`` command-line tool](https://grafana.com/docs/grafana/latest/administration/cli/) for plugin installation.
|
||||||
|
@ -115,6 +118,73 @@ Click `Save & Test` to test. You should see a success message if the test worked
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
</TabItem>
|
||||||
|
<TabItem value="container" label="Container">
|
||||||
|
|
||||||
|
Please refer to [Install plugins in the Docker container](https://grafana.com/docs/grafana/next/setup-grafana/installation/docker/#install-plugins-in-the-docker-container). This will install `tdengine-datasource` plugin when Grafana container starts:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker run -d \
|
||||||
|
-p 3000:3000 \
|
||||||
|
--name=grafana \
|
||||||
|
-e "GF_INSTALL_PLUGINS=tdengine-datasource" \
|
||||||
|
grafana/grafana
|
||||||
|
```
|
||||||
|
|
||||||
|
You can setup a zero-configuration stack for TDengine + Grafana by [docker-compose](https://docs.docker.com/compose/) and [Grafana provisioning](https://grafana.com/docs/grafana/latest/administration/provisioning/) file:
|
||||||
|
|
||||||
|
1. Save the provisioning configuration file to `tdengine.yml`.
|
||||||
|
|
||||||
|
```yml
|
||||||
|
apiVersion: 1
|
||||||
|
datasources:
|
||||||
|
- name: TDengine
|
||||||
|
type: tdengine-datasource
|
||||||
|
orgId: 1
|
||||||
|
url: "$TDENGINE_API"
|
||||||
|
isDefault: true
|
||||||
|
secureJsonData:
|
||||||
|
url: "$TDENGINE_URL"
|
||||||
|
basicAuth: "$TDENGINE_BASIC_AUTH"
|
||||||
|
token: "$TDENGINE_CLOUD_TOKEN"
|
||||||
|
version: 1
|
||||||
|
editable: true
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Write `docker-compose.yml` with [TDengine](https://hub.docker.com/r/tdengine/tdengine) and [Grafana](https://hub.docker.com/r/grafana/grafana) image.
|
||||||
|
|
||||||
|
```yml
|
||||||
|
version: "3.7"
|
||||||
|
|
||||||
|
services:
|
||||||
|
tdengine:
|
||||||
|
image: tdengine/tdengine:2.6.0.2
|
||||||
|
environment:
|
||||||
|
TAOS_FQDN: tdengine
|
||||||
|
volumes:
|
||||||
|
- tdengine-data:/var/lib/taos/
|
||||||
|
grafana:
|
||||||
|
image: grafana/grafana:8.5.6
|
||||||
|
volumes:
|
||||||
|
- ./tdengine.yml/:/etc/grafana/provisioning/tdengine.yml
|
||||||
|
- grafana-data:/var/lib/grafana
|
||||||
|
environment:
|
||||||
|
# install tdengine plugin at start
|
||||||
|
GF_INSTALL_PLUGINS: "tdengine-datasource"
|
||||||
|
TDENGINE_URL: "http://tdengine:6041"
|
||||||
|
#printf "$TDENGINE_USER:$TDENGINE_PASSWORD" | base64
|
||||||
|
TDENGINE_BASIC_AUTH: "cm9vdDp0YmFzZTEyNQ=="
|
||||||
|
ports:
|
||||||
|
- 3000:3000
|
||||||
|
volumes:
|
||||||
|
grafana-data:
|
||||||
|
tdengine-data:
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Start TDengine and Grafana services: `docker-compose up -d`.
|
||||||
|
|
||||||
|
Open Grafana <http://localhost:3000>, and you can add dashboard with TDengine now.
|
||||||
|
|
||||||
</TabItem>
|
</TabItem>
|
||||||
</Tabs>
|
</Tabs>
|
||||||
|
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 28 KiB |
Binary file not shown.
After Width: | Height: | Size: 87 KiB |
Binary file not shown.
After Width: | Height: | Size: 34 KiB |
|
@ -29,39 +29,41 @@ TDengine 能够与开源数据可视化系统 [Grafana](https://www.grafana.com/
|
||||||
### 安装 Grafana Plugin 并配置数据源
|
### 安装 Grafana Plugin 并配置数据源
|
||||||
|
|
||||||
<Tabs defaultValue="script">
|
<Tabs defaultValue="script">
|
||||||
|
<TabItem value="gui" label="图形化界面安装">
|
||||||
|
|
||||||
|
使用 Grafana 最新版本(8.5+),您可以在 Grafana 中[浏览和管理插件](https://grafana.com/docs/grafana/next/administration/plugin-management/#plugin-catalog)(对于 7.x 版本,请使用 **安装脚本** 或 **手动安装并配置** 方式)。在 Grafana 管理界面中的 **Configurations > Plugins** 页面直接搜索并按照提示安装 TDengine。
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
如图示即安装完毕,按照指示 **Create a TDengine data source** 添加数据源。
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
输入 TDengine 相关配置,完成数据源配置。
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
配置完毕,现在可以使用 TDengine 创建 Dashboard 了。
|
||||||
|
|
||||||
|
</TabItem>
|
||||||
<TabItem value="script" label="使用安装脚本">
|
<TabItem value="script" label="使用安装脚本">
|
||||||
|
|
||||||
将集群信息设置为环境变量;也可以使用 `.env` 文件,请参考 [dotenv](https://hexdocs.pm/dotenvy/dotenv-file-format.html):
|
对于使用 Grafana 7.x 版本或使用 [Grafana Provisioning](https://grafana.com/docs/grafana/latest/administration/provisioning/) 配置的用户,可以在 Grafana 服务器上使用安装脚本自动安装插件即添加数据源 Provisioning 配置文件。
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
export TDENGINE_API=http://tdengine.local:6041
|
bash -c "$(curl -fsSL \
|
||||||
# user + password
|
https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)" -- \
|
||||||
export TDENGINE_USER=user
|
-a http://localhost:6041 \
|
||||||
export TDENGINE_PASSWORD=password
|
-u root \
|
||||||
|
-p taosdata
|
||||||
# 其他环境变量:
|
|
||||||
# - 是否安装数据源,默认为 true,表示安装
|
|
||||||
export TDENGINE_DS_ENABLED=false
|
|
||||||
# - 数据源名称,默认为 TDengine
|
|
||||||
export TDENGINE_DS_NAME=TDengine
|
|
||||||
# - 数据源所属组织 ID,默认为 1
|
|
||||||
export GF_ORG_ID=1
|
|
||||||
# - 数据源是否可通过管理面板编辑,默认为 0,表示不可编辑
|
|
||||||
export TDENGINE_EDITABLE=1
|
|
||||||
```
|
```
|
||||||
|
|
||||||
运行安装脚本:
|
安装完毕后,需要重启 Grafana 服务后方可生效。
|
||||||
|
|
||||||
```sh
|
|
||||||
bash -c "$(curl -fsSL https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)"
|
|
||||||
```
|
|
||||||
|
|
||||||
该脚本将自动安装 Grafana 插件并配置数据源。安装完毕后,需要重启 Grafana 服务后生效。
|
|
||||||
|
|
||||||
保存该脚本并执行 `./install.sh --help` 可查看详细帮助文档。
|
保存该脚本并执行 `./install.sh --help` 可查看详细帮助文档。
|
||||||
|
|
||||||
</TabItem>
|
</TabItem>
|
||||||
<TabItem value="manual" label="手动安装并配置">
|
<TabItem value="manual" label="手动安装">
|
||||||
|
|
||||||
使用 [`grafana-cli` 命令行工具](https://grafana.com/docs/grafana/latest/administration/cli/) 进行插件[安装](https://grafana.com/grafana/plugins/tdengine-datasource/?tab=installation)。
|
使用 [`grafana-cli` 命令行工具](https://grafana.com/docs/grafana/latest/administration/cli/) 进行插件[安装](https://grafana.com/grafana/plugins/tdengine-datasource/?tab=installation)。
|
||||||
|
|
||||||
|
@ -113,6 +115,73 @@ GF_INSTALL_PLUGINS=tdengine-datasource
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
</TabItem>
|
||||||
|
<TabItem value="manual" label="K8s/Docker 容器">
|
||||||
|
|
||||||
|
参考 [Grafana 容器化安装说明](https://grafana.com/docs/grafana/next/setup-grafana/installation/docker/#install-plugins-in-the-docker-container)。使用如下命令启动一个容器,并自动安装 TDengine 插件:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker run -d \
|
||||||
|
-p 3000:3000 \
|
||||||
|
--name=grafana \
|
||||||
|
-e "GF_INSTALL_PLUGINS=tdengine-datasource" \
|
||||||
|
grafana/grafana
|
||||||
|
```
|
||||||
|
|
||||||
|
使用 docker-compose,配置 Grafana Provisioning 自动化配置,体验 TDengine + Grafana 组合的零配置启动:
|
||||||
|
|
||||||
|
1. 保存该文件为 `tdengine.yml`。
|
||||||
|
|
||||||
|
```yml
|
||||||
|
apiVersion: 1
|
||||||
|
datasources:
|
||||||
|
- name: TDengine
|
||||||
|
type: tdengine-datasource
|
||||||
|
orgId: 1
|
||||||
|
url: "$TDENGINE_API"
|
||||||
|
isDefault: true
|
||||||
|
secureJsonData:
|
||||||
|
url: "$TDENGINE_URL"
|
||||||
|
basicAuth: "$TDENGINE_BASIC_AUTH"
|
||||||
|
token: "$TDENGINE_CLOUD_TOKEN"
|
||||||
|
version: 1
|
||||||
|
editable: true
|
||||||
|
```
|
||||||
|
|
||||||
|
2. 保存该文件为 `docker-compose.yml`。
|
||||||
|
|
||||||
|
```yml
|
||||||
|
version: "3.7"
|
||||||
|
|
||||||
|
services:
|
||||||
|
tdengine:
|
||||||
|
image: tdengine/tdengine:2.6.0.2
|
||||||
|
environment:
|
||||||
|
TAOS_FQDN: tdengine
|
||||||
|
volumes:
|
||||||
|
- tdengine-data:/var/lib/taos/
|
||||||
|
grafana:
|
||||||
|
image: grafana/grafana:8.5.6
|
||||||
|
volumes:
|
||||||
|
- ./tdengine.yml/:/etc/grafana/provisioning/tdengine.yml
|
||||||
|
- grafana-data:/var/lib/grafana
|
||||||
|
environment:
|
||||||
|
# install tdengine plugin at start
|
||||||
|
GF_INSTALL_PLUGINS: "tdengine-datasource"
|
||||||
|
TDENGINE_URL: "http://tdengine:6041"
|
||||||
|
#printf "$TDENGINE_USER:$TDENGINE_PASSWORD" | base64
|
||||||
|
TDENGINE_BASIC_AUTH: "cm9vdDp0YmFzZTEyNQ=="
|
||||||
|
ports:
|
||||||
|
- 3000:3000
|
||||||
|
volumes:
|
||||||
|
grafana-data:
|
||||||
|
tdengine-data:
|
||||||
|
```
|
||||||
|
|
||||||
|
3. 使用 docker-compose 命令启动 TDengine + Grafana :`docker-compose up -d`。
|
||||||
|
|
||||||
|
打开 Grafana <http://localhost:3000>,现在可以添加 Dashboard 了。
|
||||||
|
|
||||||
</TabItem>
|
</TabItem>
|
||||||
</Tabs>
|
</Tabs>
|
||||||
|
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 28 KiB |
Binary file not shown.
After Width: | Height: | Size: 87 KiB |
Binary file not shown.
After Width: | Height: | Size: 34 KiB |
Loading…
Reference in New Issue