# 对接Grafana插件（Linux）
Grafana是一个跨平台的开源的度量分析和可视化工具，可将通过将采集的数据查询进行可视化的展示，并及时通知。
LTS-Grafana是Grafana服务中的一个插件，它可以使用LTS的数据，并对数据进行可视化分析和展示。
#### 前提条件
- 已安装Grafana。具体操作，请参见[Grafana官方文档](https://docs.grafana.org/installation/?spm=a2c4g.11186623.0.0.546e6fcfshLLWW)。
  Grafana版本要求使用9.0.0及以上版本。
  
- 下载[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. 执行以下命令将云日志服务grafana插件项目压缩包解压到Grafana插件目录。 
   - 使用YUM或RPM安装的Grafana：
     ```
     unzip LTS-Grafana-OBS-Static.1.0.10.zip -d /var/lib/grafana/plugins
     ```
     
   
   - 使用.tar.gz文件安装的Grafana： {PATH_TO}为Grafana的安装路径，{VERSION}为Grafana版本号
     ```
     unzip LTS-Grafana-OBS-Static.1.0.10.zip -d {PATH_TO}/grafana-{VERSION}/plugins-bundled/internal/input-datasource
     ```
     
   
   
   
   
2. 修改Grafana配置文件 
   - 打开配置文件：
     - 使用YUM或RPM安装的Grafana：/etc/grafana/grafana.ini
     
     - 使用.tar.gz文件安装的Grafana：{PATH_TO}/grafana-{VERSION}/conf/defaults.ini
      
   
   - 在配置文件的\[plugins\]节点中，设置allow_loading_unsigned_plugins参数
     ```
     allow_loading_unsigned_plugins = hw-hws-lts-grafana-datasource-plugin
     ```
     
   
   
   
   
3. 重启Grafana。 
   - 使用kill命令终止Grafana进程。
   
   - 执行以下命令启动Grafana
     - 使用YUM或RPM安装的Grafana：
       ```
       systemctl restart grafana-server
       ```
       
     
     - 使用.tar.gz文件安装的Grafana：
       ```
       ./bin/grafana-server web
       ```
       
      
   
   
   
   
 
#### 添加数据源
1. 在左侧菜单栏中，单击![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001591236509.png "点击放大") 选择Data Sources，进入Data Sources页面，单击Add data source，添加数据源，选择hws-lts-grafana-datasource-plugin。
   
   ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001540357158.png "点击放大")
   
   
2. 配置数据源，完成后单击 Save\& Test。 
   ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000001591237337.png "点击放大")
   表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_0000002142550772.png)按钮，将鼠标悬浮在日志流名称上**，**即可复制日志流ID。 | -                                 |
   | AccesskeyId/SecretAccessKey | 用户访问凭证。登录LTS控制台，单击**账号名称\>我的凭证\>访问密钥**，在访问密钥页面中，可直接复制访问密钥ID。                                                                                                                    | -                                 |
      
   
   
3. 添加仪表盘。 
   1. 在左侧菜单栏中，单击 选择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_0000001591240593.png) 按钮，可刷新请求最新的数据并展示。
      ![](https://support.huaweicloud.com/devg-lts/zh-cn_image_0000002211695894.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为数据列。