更新时间:2024-11-11 GMT+08:00

对接Grafana插件(Linux)

Grafana是一个跨平台的开源的度量分析和可视化工具,可将通过将采集的数据查询进行可视化的展示,并及时通知。

LTS-Grafana是Grafana服务中的一个插件,它可以使用LTS的数据,并对数据进行可视化分析和展示。

前提条件

  • 已安装Grafana。具体操作,请参见Grafana官方文档

    Grafana版本要求使用9.0.0及以上版本。

  • 下载LTS-Grafana插件压缩包
  • 需要在云日志服务控制台开通可视化功能才能使用LTS-Grafana插件。

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

安装日志服务(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. 在左侧菜单栏中,单击 选择Data Sources,进入Data Sources页面,单击Add data source,添加数据源,选择hws-lts-grafana-datasource-plugin。

  2. 配置数据源,完成后单击 Save& Test。

    表1 参数说明表

    参数

    说明

    示例

    Name

    插件名称,可自定义。

    hws-lts-grafana-datasource-plugin

    EndPoint

    终端节点,根据自己的区域选择不同的终端节点。可参考地区和终端节点

    -

    projectId

    账户的projectId。
    说明:

    登录LTS控制台,单击账号名称>我的凭证>API凭证,在API凭证页面中,可直接复制所属区域对应的项目ID。

    -

    Log StreamId

    已配置结构化的日志流Id。

    说明:

    登录LTS控制台,在日志管理页面,单击日志组名称对应的按钮,将鼠标悬浮在日志流名称上即可复制日志流ID。

    -

    AccesskeyId/SecretAccessKey

    用户访问凭证。

    说明:

    登录LTS控制台,单击账号名称>我的凭证>访问密钥,在访问密钥页面中,可直接复制访问密钥ID。

    -

  3. 添加仪表盘。

    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为数据列。