Skip to content

Latest commit

 

History

History
78 lines (59 loc) · 3.76 KB

README.md

File metadata and controls

78 lines (59 loc) · 3.76 KB
Raw

cloudeye-grafana

LICENSE

cloudeye-grafana是华为云监控服务为适配Grafana开发的datasource插件，通过华为云SDK获取监控数据。

快速入门

1. 安装

安装前准备:
a. 已安装Grafana版本 >=7.4.0, grafana官方下载地址
b. 从release页面下载cloudeye-grafana-{version}.tar.gz

  • 注意：如果使用release 1.0.3之前的版本，若grafana同时安装多个插件存在兼容问题，建议升级至1.0.3

1.1 从release安装

a. 将下载的插件包放到grafana的plugin目录(见conf/defaults.ini中的plugins配置路径), 解压缩cloudeye-grafana-{version}.tar.gz, 需要注意目录权限和grafana运行权限保持一致

b. 修改 conf/defaults.ini 允许未签名插件运行

allow_loading_unsigned_plugins = huawei-cloudeye-grafana

c. 重启grafana

2. 配置cloudeye-grafana数据源

配置前准备:
a. 获取AK/SK
b. (可选)Specific Region Mode模式下需要获取project_id
c. (可选)Specific Region Mode模式下需要获取CES Endpoint和RegionID

2.1 配置数据源

a. 进入grafana的数据源配置页面(Data Sources),点击Add data source进入配置表单页面,填入数据源名称cloudeye-grafana, 在数据源列表中选择cloudeye-grafana。

b. 当前支持两种模式，可按需选择配置。

Huaweicloud Mode（华为云多region模式）：配置IAM Access Key、IAM Secret Key

Specific Region Mode（单region模式）：配置CES Endpoint、Region ID、Project ID、IAM Access Key、IAM Secret Key

c. (可选)如果需要开启通过配置文件读取指标元数据，需要点击Get Metric Meta From Conf按钮开启，并按下文配置指标元数据列表。

d. 点击Save & test按钮，如果显示Data source is working，说明数据源配置成功，可以开始在grafana中访问华为云监控的数据了。

3. (可选)配置指标元数据列表

为了提升查询体验，对于资源列表变化实时性不高、资源量大的租户，可以提前将资源列表配置在dist/metric.yaml文件中,区域/服务/资源/指标列表以配置文件为准。

a. 云监控支持的服务指标列表
b. 华为云支持region列表
c. 按metric.yaml样例配置完成后，重启grafana

4. 导入dashboard模板

为简便租户配置，本插件提供了ECS、ELB、RDS服务的Dashboard预设模板，见： cloudeye-grafana/src/templates目录

5. 创建自定义Dashboard

a. 鼠标移动至页面左侧菜单"+"图标，选择Dashboard，点击即可创建

b. 创建好之后请点击右上角齿轮图标，选择左侧"Variables"菜单项，点击"Add variable"按钮添加filter和period模板变量。变量配置如下:

filter变量：

{
    Name: filter,
    Type: Query,
    Label: Filter,
    Data source: cloudeye-grafana,
    Query: listFilterOptions()
}

period变量：

{
    Name: period,
    Type: Query,
    Label: Period,
    Data source: cloudeye-grafana,
    Query: listPeriodOptions()
}

c. 配置好自定义模板变量后回到Dashboard页面，点击"Add an empty panel"按钮添加指标监控图表

d. 点击右上角保存按钮，完成自定义Dashboard创建