阿里云监控grafana数据源使用说明文档

一. grafana安装

   如果服务器上没有安装grafana，需要在服务器上安装grafana。
   Grafana官方文档： http://docs.grafana.org/guides/getting_started/

1. grafana卸载：

   1.1 查看grafana安装情况

   rpm -qa | grep -i grafana

   1.2 停止运行grafana,删除运行的grafana

   service grafana-server stop
   rpm -e 文件名

   1.3 查找之前老版本grafana，并且删除老版本grafana的文件和库

   find / -name grafana
   rm -rf /usr/share/grafana/

2. grafana安装：

   2.1 yum安装 http://docs.grafana.org/installation/rpm/官网推荐方式

   yum install https://s3-us-west-2.amazonaws.com/grafana-releases/release/grafana-5.3.0-1.x86_64.rpm

   2.2 启动 service grafana-server start

   开机自启 /sbin/chkconfig --add grafana-server
   用户名：admin 密码：admin 端口：3000
   yum安装文件信息

   安装包细节：
       安装二进制文件 /usr/sbin/grafana-server
       将init.d脚本复制到 /etc/init.d/grafana-server
       安装默认文件（环境变量） /etc/sysconfig/grafana-server
       将配置文件复制到 /etc/grafana/grafana.ini
       安装systemd服务（如果systemd可用）名称 grafana-server.service
       默认配置使用日志文件 /var/log/grafana/grafana.log
       默认配置指定sqlite3数据库 /var/lib/grafana/grafana.db
       
   systemd服务文件和init.d脚本都使用位于/etc/sysconfig/grafana-server启动后端时使用的环境变量的文件。在这里，您可以覆盖日志目录，数据目录和其他变量
   默认情况下，Grafana将登录 /var/log/grafana
   默认配置指定位于的sqlite3数据库/var/lib/grafana/grafana.db。请在升级前备份此数据库。您还可以使用MySQL或Postgres作为Grafana数据库，如配置页面中所详述。
   配置文件位于/etc/grafana/grafana.ini
   服务器端图像（png）呈现是一项可选功能，但在共享可视化时非常有用，例如在警报通知中。
       如果图像缺失文本，请确保已安装字体包。
       yum install fontconfig
       yum install freetype*
       yum install urw-fonts
   

二. 安装云监控grafana数据源

请确认Grafana的插件目录位置。插件目录/var/lib/grafana/plugins/安装插件，重启grafana-server。
执行以下命令安装插件，并重启grafana-server。
第一种

cd /var/lib/grafana/plugins/
git clone [email protected]:cms/aliyun-cms-grafana.git
service grafana-server restart

第二种：下载metricstore-datasource.zip，上传metricstore-datasource.zip压缩包到指定服务器地址，然后解压

cd /var/lib/grafana/plugins/
unzip metricstore-datasource.zip
rm -rf metricstore-datasource.zip
service grafana-server restart

三. 配置云监控grafana数据源

1. 进入grafana的数据源配置页面(Data Sources)，
2. 点击Add data source进入配置表单页面，
3. 填入数据源名称（Name），在数据源类型（Type）下拉列表中选择metricstore。
4. 然后开始配置Endpoint以及认证信息，Endpoint是所有获取云监控数据的请求地址，根据你所在Endpoint填写，默认为http://metrics.cn-hangzhou.aliyuncs.com，Access key ID和Secret access key填写账号AK，
5. 填写完成点击Save & Test，如果显示Success Data source is working，说明数据源配置成功，可以开始在grafana中访问阿里云监控的数据了。
   

四. 使用云监控grafana数据源

数据源支持多种grafana原生的数据展示方式，下面主要介绍Graph和Table两种展示方式和Templating功能的使用：
（1）、图表（Graph）方式

在dashboard上点击 "+" Create Dashboard时选择Graph，在Panel data source中选择配置的云监控数据源（Data Sources Name），上方会显示配置表单，下面解释表单中各项的意义：
Project：指标的Project，必须选择了Project才能选择Metric，
(支持自定义监控指标:acs_custom_$uid;
日志监控指标:acs_logMonitor_$uid，需要手动输入指标)，
详细请访问: [预设监控项参考]。
Metric：指标名，必须选择Metric，因为其他各项会依赖Metric选项。
Period：数据点时间间隔，按照所选metric定义的peroid或者peroid的整数倍填写，默认为空，当Period为空时云监控后台会根据选择的时间范围计算一个最合适的Period。由于每次请求后台只返回1000个数据点，所以建议选择时间段较长的时候保持此项为空，避免图表中出现数据断层。
Values：统计方法，比如Average 、Minimum 、Maximum等，此项可以下拉选择一项或者多项，已选项会以标签的方式列在右侧，你可以点击标签上的X删除一个已选项。注意：选择此项必须先选择Metric。
Dimensions：维度，比如instanceId、device等，根据选择的Metric不同会有所不同。Dimensions是有层级关系的，必须先选择上一层级Dimension的值才会显示下一层级Dimension的名称和可选的值，当你点击Dimension的输入框时，会下拉提示设置账号下所属资源的列表。
**注意：需要先选择Metric才可以配置Dimensions。
当你配置完成所有配置项的时候，点击表单空白位置就会在图标中出现数据，当然你修改Period、Values、Dimensions任意一项的时候，都会按照你最新的配置重新获取数据。如果你修改了Metric，若新的Metric和旧的Metric各配置项不匹配的时候会清空所有表单中的配置，因为不同Metric可以配置的项目内容可能不同。**
说明：图表标题默认为配置Metric的名称；图表各线条的命名规则为：Metric_Dimensions_Value，其中Dimensions有几级就显示几级，用"_"分割，这种组合命名方式方便区分不同线条所代表的意义。

（2）、表格（Table）方式

在dashboard上点击 "+" Create Dashboard时选择Table，在Panel data source中选择配置的云监控数据源，上方会显示配置表单，下面解释表单中各项的意义：

Project：同图表（Graph）方式。
Metric：同图表（Graph）方式。
Period：同图表（Graph）方式。
Values：同图表（Graph）方式。
Dimensions：同图表（Graph）方式。