# 对接Grafana插件（Windows）
**Grafana**是一个跨平台的开源的度量分析和可视化工具，可将通过将采集的数据查询进行可视化的展示，并及时通知。
**LTS-Grafana**是Grafana服务中的一个插件，它可以使用LTS的数据，并对数据进行可视化分析和展示。
#### 前提条件
- [安装Grafana](https://grafana.com/docs/grafana/latest/installation/?spm=a2c4g.11186623.2.9.38f53e0ajghBAk)。
  - Grafana版本要求使用9.0.0及以上版本。
  
  - 在Windows中，建议Grafana安装在非系统盘，否则可能会出现没有权限打开[Grafana配置文件]的情况。
  
  - 本机上安装Grafana后，在浏览器中输入localhost:3000进行访问，初始账号密码是**admin/admin**。
   
- 下载[LTS-Grafana插件压缩包](https://lts-grafana-new-cn-north-4.obs.cn-north-4.myhuaweicloud.com/LTS-Grafana-OBS-Static.1.0.12.zip/1730710561870/LTS-Grafana-OBS-Static.1.0.12.zip)。
- 需要在云日志服务控制台开通可视化功能才能使用LTS-Grafana插件。详细请参考[日志可视化](https://support.huaweicloud.com/usermanual-lts/lts_04_0002.html)。
 
#### 安装云日志服务（LTS-Grafana）插件
1. 安装日志服务插件。 
   1. 进入Grafana的安装目录。例如：GrafanaLabs\\grafana\\data\\plugins。
   
   2. 下载的LTS-Grafana插件压缩包解压到**当前位置** ，这样成功提取文件（文件名为**lts-grafana-plugin**）。
   
   3. 将提取到的文件（文件名为**lts-grafana-plugin**）拷贝到GrafanaLabs\\grafana\\plugins-bundled\\internal\\input-datasource目录中。
   
   4. 完成后，重启Grafana服务。 进入任务管理器选择**服务** 页签，选中**Grafana** 右击鼠标单击**重新启动**，可重启Grafana服务。
      ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000002177869825.png "点击放大")
      
   
   
   
   
2. 修改Grafana配置文件。
   
   1. 打开配置文件**defaults.ini** 。
      配置文件位置：安装目录\\GrafanaLabs\\grafana\\conf\\defaults.ini
      
   
   2. 配置allow_loading_unsigned_plugins参数。
      ```
      allow_loading_unsigned_plugins = hw-hws-lts-grafana-datasource-plugin
      ```
      
   
   3. 完成后，重启Grafana服务。
   
   
   
   
 
#### 添加数据源
1. 在浏览器中输入localhost:3000进行访问，登录Grafana服务。初始账号密码是**admin/admin**。
2. 在左侧菜单栏中，单击 ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001591201877.png "点击放大") 选择**Data Sources** ，进入Data Sources页面，单击**Add data source** ，添加数据源。
   
   ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001591307165.png "点击放大")
   
   
3. 配置数据源。 
   表1参数说明表 
   | 参数                          | 说明                                                                                                                                                                              | 示例                                |
   |:---|:---|:---|
   | Name                        | 插件名称，可自定义。                                                                                                                                                                      | hws-lts-grafana-datasource-plugin |
   | Endpoint                    | 终端节点，根据自己的区域选择不同的终端节点。可参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/LTS)。                                                                                 | -                                 |
   | projectId                   | 账户的projectId。 登录LTS控制台，单击**账号名称\>我的凭证\>** **API凭证**，在API凭证页面中，可直接复制所属区域对应的项目ID。                                                                      | -                                 |
   | Log StreamId                | 已配置结构化的日志流Id。 登录LTS控制台，在日志管理页面，单击日志组名称对应的![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000002142708816.png)按钮，将鼠标悬浮在日志流名称上**，**即可复制日志流ID。 | -                                 |
   | AccesskeyId/SecretAccessKey | 用户访问凭证。登录LTS控制台，单击**账号名称\>我的凭证\>访问密钥**，在访问密钥页面中，可直接复制访问密钥ID。                                                                                                                    | -                                 |
      
   ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001540482080.png "点击放大")
   
   
4. 完成后，单击**Save \& Test**。
 
#### 添加仪表盘
1. 在左侧菜单栏中，单击 ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001540642032.png) 选择**Dashboards** ，在New dashboard页面中，单击**add an empty panel**。
2. 在New dashboards页面中，选择hws-lts-grafana-datasource-plugin插件和填写对应的sql语句。
3. 在右上角选择对应时间，并单击 ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001540322352.png) 按钮，可刷新请求最新的数据并展示。
   
   ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000002246775665.png "点击放大")
   LTS-Grafana插件相关参数配置规则如下：
   - 表格类型数据，需要将x-column参数的值给为"table"。若需要固定表格字段顺序，可通过Grafana的"Transformations \> Organize fields by name"功能实现自定义字段顺序（即固定表格字段顺序）。
     图1固定表格   
     ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000002535686136.png "点击放大") 
   
   - 单值类型数据，例如数字图，需要将x-column参数值给成"single"。
   
   - 包含维度列图表：x-column配置为时间列字段，y-column配置为col1:col2。其中col1为聚合列，col2为数据列。
   
   - 时序图类型图表：有普通时序图和包含维度列时序图。
     - 普通时序图：x-column配置为时间列字段，y-column配置为需要展示的y轴字段，如有多个使用逗号分隔，例如：col1,col2,col3。
     
     - 包含维度列时序图：x-column配置为时间列字段，y-column配置为col1:col2。其中col1为聚合列，col2为数据列。
      
   
   - 柱状图类型图表：x-column配置为"bar"，y-column配置为col1,col2。其中col1为类目列，col2为数据列。
   
   - 饼图类型图表：x-column配置为"pie"，y-column配置为col1,col2。其中col1为类目列，col2为数据列。