对接Grafana插件（Windows）

前提条件

• 安装Grafana。
  

  • Grafana版本要求使用9.0.0及以上版本。
  • 在Windows中，建议Grafana安装在非系统盘，否则可能会出现没有权限打开Grafana配置文件的情况。
  • 本机上安装Grafana后，在浏览器中输入localhost:3000进行访问，初始账号密码是admin/admin。
• 下载LTS-Grafana插件压缩包。
• 需要在云日志服务控制台开通可视化功能才能使用LTS-Grafana插件。
  

  目前此功能仅支持全部用户使用的局点有：华南-广州、华北-北京四、华北-乌兰察布二零一、华北-乌兰察布一、华东-上海一、中国-香港、西南-贵阳一、亚太-新加坡、华南-深圳，支持部分白名单用户使用的局点有：亚太-曼谷、华北-北京一、华东-上海二、华北-乌兰察布二零二，其他局点暂不支持该功能。

安装云日志服务（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服务。

      

2. 修改Grafana配置文件。
   1. 打开配置文件。
      • 安装目录/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. 在左侧菜单栏中，单击 选择Data Sources，进入Data Sources页面，单击Add data source，添加数据源。

   

3. 配置数据源。

   表1 参数说明表

   参数	说明	示例
   Name	插件名称，可自定义。	hws-lts-grafana-datasource-plugin
   EndPoint	终端节点，根据自己的区域选择不同的终端节点。可参考地区和终端节点。	-
   projectId	账户的projectId。 说明： 登录LTS控制台，单击账号名称>我的凭证>API凭证，在API凭证页面中，可直接复制所属区域对应的项目ID。	-
   Log StreamId	已配置结构化的日志流Id。 说明： 登录LTS控制台，在日志管理页面，单击日志组名称对应的按钮，将鼠标悬浮在日志流名称上，即可复制日志流ID。	-
   AccesskeyId/SecretAccessKey	用户访问凭证。 说明： 登录LTS控制台，单击账号名称>我的凭证>访问密钥，在访问密钥页面中，可直接复制访问密钥ID。	-

   

4. 完成后，单击Save & Test。

添加仪表盘

1. 在左侧菜单栏中，单击 选择Dashboards，在New dashboard页面中，单击add an empty panel。
2. 在New dashboards页面中，选择hws-lts-grafana-datasource-plugin插件和填写对应的sql语句。

   

3. 在右上角选择对应时间，并单击 按钮，可刷新请求最新的数据并展示。

   

   

   LTS-Grafana插件相关参数配置规则如下：

   • 表格类型数据，需要将x-column参数的值给为"table"。
   • 单值类型数据，例如数字图，需要将x-column参数值给成"single"。
   • 包含维度列图表：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为数据列。