云监控对接Grafana

云监控为云上用户提供常用云产品的监控数据和用户自定义上报的监控数据。在可视化展示层面，除了在云监控控制台查看监控图表外，您还可以将云监控的数据添加到Grafana中展示。

1. 安装Grafana。
   说明

   • 如果您已安装Grafana，则请忽略本操作。
   • Grafana的其他安装步骤，请参见Grafana官方文档。
   1. 安装Grafana软件。
      本文以Grafana部署在Linux的CentOS系统上为例，介绍其安装方法。

      • 安装方式一：

        yum install https://dl.grafana.com/oss/release/grafana-5.3.4-1.x86_64.rpm

      • 安装方式二：

        wget https://dl.grafana.com/oss/release/grafana-5.3.4-1.x86_64.rpm

        sudo yum localinstall grafana-5.3.4-1.x86_64.rpm

   2. 执行如下命令启动Grafana服务。
      service grafana-server start
   3. （可选）安装Grafana面板插件。

      如果您需要Grafana面板，则执行如下命令安装面板插件，例如：Pie chart（饼状图）插件。

      grafana-cli plugins install grafana-piechart-panel

      说明 Grafana面板的其他插件的安装方法，请参见Panels插件。
2. 安装云监控数据源服务插件。
   1. 确认Grafana插件的安装目录。
      例如：Linux的CentOS系统的插件目录为/var/lib/grafana/plugins/。
   2. 执行如下命令安装插件。

      cd /var/lib/grafana/plugins/

      git clone https://github.com/aliyun/aliyun-cms-grafana.git

   3. 执行如下命令重启Grafana服务。
      service grafana-server restart
   您也可以下载aliyun-cms-grafana.zip插件，解压后上传到Grafana服务器的/var/lib/grafana/plugins/目录下，重启Grafana服务。

   说明 此插件版本目前不支持对监控数据设置报警。
3. 配置云监控数据源服务插件。
   Grafana安装成功后，默认访问端口为：3000，用户名：admin。

   注意 请您首次登录Grafana时，修改默认密码，以免带来安全隐患。
   1. 登录Grafana。
   2. 单击左上方的Configuration，在弹出的列表中选Data Sources。
   3. 进入Data Sources页面，单击右上方的Add data source，添加新的数据源。
   4. 填写云监控数据源的配置项。

      配置项	配置内容
      Name	请您根据所需自定义一个新数据源的名称。
      type	Type请选择CMS Grafana Service。
      URL	URL样例：http://metrics.cn-shanghai.aliyuncs.com，metrics是Project名称，cn-shanghai.aliyuncs.com是Project所在地域Endpoint，在配置数据源时，需要替换成自己的Project和Region地址。不同域选择请参考云监控接入地址。
      Access	使用默认值即可。
      Auth	使用默认值即可。
      cloudmonitor service details	分别填写具备读取权限的AccessKey信息。建议使用子账号的AccessKey。 说明 AccessKey请输入Base64格式。在linux系统中，执行命令echo -n "AccessKey" | base64 ，将AccessKey转换为Base64格式。

      配置示例如下图所示。
   5. 单击Save &Test。
4. 添加和配置Dashboard。
   1. 单击左上方的Dashboards，在弹出的列表中选Manage，进入Manage页面。
      
   2. 单击Dashboard，创建Dashboard。
      您可以选择创建一个Folder后，再创建Dashboard，您也可以导入其他Dashboard。
   3. 配置Graph图表。
      1. 在New Panel的Add下选择Graph图表。
      2. 单击Pannel Title，在弹出的窗口中单击Edit。
      3. 在Metrics配置中，选择datasource为cms-grafana，配置参数Project、Metric、period、Y轴和X轴。
         Project、Metric、Period等参数详情，请参见QueryMetricList。

         参数	说明
         Group	云账户所在云监控的应用分组。
         Dimensions	Project与Metric所在监控项最新监控数据的实例集合，若选Group，则为该Group下的实例。
         Y-column	可支持多选。
         X-column	timestamp。
         Y-column describe	对Y-column的区分描述。

         说明

         • 如果您需要了解更多Graph信息，请单击Graph。
         • 所有参数均可按照QueryMetricList的要求手动输入。
         • 所有已选择或已输入参数均可输入null取消。
         • 如果对应场景下Dimensions的提示信息不全，则需要刷新或按照样例手动输入InstanceId的值即可。

         
         自定义监控的部分参数信息需要手动输入，参数说明如下表所示。

         参数	说明
         Project	acs_customMetric_+云账号ID。
         Metric	上报监控数据的metricName。
         Period	上报监控数据时的Period。
         Group	上报监控数据时的Metric对应的分组ID。
         Dimensions	上报监控数据时的Dimension，暂不支持下拉选择，只支持输入单个Dimension，若输入多个，默认选第一个。 说明 如果云监控控制台的dimensions格式为env: public, step: 5-ReadFromAlertOnline，则请用&替换示例中的,后拼接输入。
         Y-column	上报监控数据时的Average、Maximum、Minimum、Sum、SampleCount、P10、P20、P99等。
         X-column	timestamp。

         
      4. 配置Singlestat面板。
         1. 在New Panel的Add下选择Singlestat。
         2. 单击Pannel Title，在弹出的窗口中单击Edit。
         3. 配置Metric相关参数。
            说明 如果您需了解更多Singlestat信息，请单击Graph。
            
   4. 配置Variables。
      Variables支持Type类型为Query和Custom。

      • 配置Type为Query。
        支持函数如下表所示。

        变量	定义	说明	示例
        $namespace	namespace(filter)	按filter过滤云产品监控项，filter可为null。云产品监控项请参见概述。	namespace(ecs)
        $metric	metric($namespace,filter)	按namespace和filter过滤云产品监控项，namespace可为variable，必选，filter可为null。云产品监控项请参见概述。	metric($namespace,disk)、metric($namespace,null)、metric(acs_ecs_dashboard,disk)
        $tagsFilter	tagsFilter(type, regionId, tagType, tagKey)	获取当前账户下的对应实例打Tag的Key和Key:/:Value集合，暂时只支持ListTagResources和ListTagResources。 type：ECS/RDS，tagType：key/value。 说明 需要对AccessKey授权云服务器ECS和云数据库RDS版的权限。	获取当前账户下打Tag标签的Key列表。tagFilter(RDS, cn-beijing, key, null) 获取当前账户下打Tag标签的Key:/:Value列表。tagFilter(RDS, cn-beijing, value, null)
        $tags	tags(type, regionId, resourceType, resourceId_array, tag_array)	获取当前账户下的对应实例打Tag的instanceId集合，暂时只支持ListTagResources和ListTagResources。 type：ECS/RDS resourceType：instance(ECS)/INSTANCE(RDS) resourceId_array：需过滤的instanceId集合，ResourceId.N 示例：[instanceId_1,instanceId_2,instanceId_3] tag_array：需过滤Tag集合Tag.N.Key和Tag.N.Value，参数形式以key:/:value或key形式填入。 示例：[key1:/:value1,key2:/:value2,key3:/:value3] or [key1,key2,key3] 说明 需要对AccessKey授权云服务器ECS和云数据库RDS版的权限。	获取当前账户下北京地域的rds的instanceId集合。tag(RDS,cn-beijing, INSTANCE, [instanceId_1,instanceId_2], [key1:/:value1,key2:/:value2])
        $dimension	dimension($namespace,metric,filterFirst,filterSecond)	获取当前账户下的dimensions列表。 filterFirst[g99hxhnnyr;1egdhoza;kty4zk40hh] or /dev/vda1 filterSecond [g99hxhnnyr;1egdhoza;kty4zk40hh] or /dev/vda1	dimension(acs_ecs_dashboard,diskusage_used,i-2zed,/dev/vd), dimension($namespace,$metric,[i-2zed;i-2zeg;i-2zeb],/dev/vda1), dimension($namespace,$metric,i-2zed;i-2zeg;i-2zeb,/dev/vda1), dimension($namespace,$metric,/dev/vda1,[i-2zed;i-2zeg;i-2zeb]), dimension($namespace,$metric,/dev/vda1,null)

        在Dashboard settings页面单击Variables，进入添加Variables后，添加要配置的变量，样例如下图所示。
        添加或修改某个变量，标签形式，使用Value groups/tags模块，样例如下图所示。
        将所需的变量按配置完毕后，需在对应的panel配置对应变量，变量获取用$变量名，样例如下图所示。
        说明 具体文档描述可见插件里README文件；在src路径下有该案例的json(ecs,rds)文件，可供导入配置。
      • 配置Type为Custom。
        在Dashboard settings页面，单击Variables，进入添加Variables后添加要配置的变量，样例如下图所示。
        将所需的变量按配置完毕后，需在对应的面板配置对应变量，变量获取用$变量名，样例如下图所示。
        说明 支持对project、metric、period、group、dimensions、ycol的variables的custom类型，模版配置过程中，建议您按照以上名称命名变量。
5. 查看结果。
   通过Grafana创建阿里云监控Dashboard并查看监控结果。