安装

1.环境准备

金山云云监控插件运行要求为 Grafana 8.0 或更高的版本上。运行该插件前请确保安装 Grafana 环境，详情参考 Grafana 安装文档

2.安装与更新

安装

此插件有多种安装方式，请选择下面任意一种方式安装。

• 直接安装云监控grafana数据源

a. 在 release 页面 https://github.com/KscSDK/ksc-cloudmonitor-app/releases 下载最新版本 Grafana 应用插件代码 ksc-cloudmonitor-app-1.1.1.zip
b. 下载到 grafana 的 plugin 目录中，解压缩 unzip ksc-cloudmonitor-app-1.1.1.zip
c. 修改 grafana.ini 允许未签名插件运行
    allow_loading_unsigned_plugins = ksc-cloudmonitor-app,ksc-cloudmonitor-datasource
d. 重启grafana

注意：升级完成后需删除旧数据源，重新配置新数据源。

• 源代码安装

a. 编译
    进入ksc-cloudmonitor-app目录下,执行bin/build.sh
	生成 ksc-cloudmonitor-app-1.1.1.zip
b. 下载到 grafana 的 plugin 目录中，解压缩 unzip ksc-cloudmonitor-app-1.1.1.zip
c. 修改 grafana.ini 允许未签名插件运行
    allow_loading_unsigned_plugins = ksc-cloudmonitor-app,ksc-cloudmonitor-datasource
d. 重启grafana

3.启用插件

安装完成后，即可开始使用。
【Configuration-plugins】，搜索Ksyun Cloud Monitor，选择插件；
点击进入应用详情，点击【enable】按钮，启用应用。

4.配置数据源

【Configuration-Data Sources】，点击【Add data source】按钮，搜索 Ksyun Cloud Monitor，点击进入数据源配置页面；

输入AccessKey、SecretAccessKey，选择需要启用服务的产品线；

单击【Save & Test】，测试数据源的配置信息是否正确，配置成功后，即可以在 Dashboard 中使用。

5.创建Dashboard

支持快捷创建、管理页面方式创建 Dashboard。

• 快捷创建
  【Create-Dashboard】，即可创建一个新的 Dashboard。
  
• 管理页面
  【Dashboards-Home】进入 Dashboard 管理页面，单击 New Dashboard，即可创建一个新的 Dashboard。同时，在该页面可以对 Dashboard 进行各种管理操作，如新建文件夹、移动 Dashboard、导入 Dashboard 等。
  

步骤6：配置 Panel 数据

创建 Dashboard 之后，通过配置 Panel 信息，即可获取相应监控数据。现在以简单的 Graph 为例，展示如何配置 Panel 信息。

单击 New Panel 面板的 Add Query 选项，进入 Panel 配置页面。在左侧第一个 Query 选项卡，Data source选择【金山云监控数据源】。可配置项如下：

• Namespace 命名空间，例如云服务器监控的命名空间为 KEC
• Region 地域，地域列表会根据 Namespace 选项自动获取，单击选择某一地域。
• Instance 实例，实例列表会自动获取。实例列表默认以各产品的实例ID展示。
• MetricName 指标名称，指标列表会根据 Namespace 和 Region 选项自动获取，单击选择指标。
• Period 监控统计粒度，会根据 MetricName 选项自动获取，单击选择某一统计粒度。
• Show Details 按钮仅在选择非模板变量时显示，切换 Show Details 为 true，可展示实例请求参数，如果需要变更实例查询条件，可参考各产品线接口文档，配置相应参数。
  

模板变量

支持配置模板变量。已经提供的模板变量详见模板变量