对接Grafana

阿里云日志服务是针对日志类数据的一站式服务，您只需要将精力集中在日志分析上，过程中数据采集、对接各种存储计算、数据索引和查询等其他工作都可以通过配置日志服务来自动完成。2017年9月日志服务升级日志实时分析功能（LogSearch/Analytics），可以使用查询+SQL92语法对日志进行实时分析。

在结果分析可视化上，除了使用自带Dashboard外，还支持DataV、Grafana、Tableua、QuickBI等对接方式。本文主要通过Grafana示例演示如何通过日志服务对Nginx日志进行分析与可视化。

在线成果演示请查看线上Demo。

视频教程

流程架构

日志从收集到分析的流程架构如下。

配置流程

1. 日志数据采集。详细步骤请参考五分钟快速入门。
2. 索引设置与控制台查询配置。详细步骤请参考简介或最佳实践采集并分析Nginx访问日志。
3. 安装Grafana插件，将实时查询SQL转化为视图。

在做完1、2步骤后，您可以在查询分析界面看到日志服务已采集的日志。

本文档演示步骤3。

配置步骤

1. 安装Grafana
2. 安装日志服务插件
3. 配置日志数据源
4. 添加Dashboard
   1. 配置模板变量
   2. 配置PV、UV
   3. 配置出入网带宽
   4. 不同HTTP方法的占比
   5. 不同HTTP状态码占比
   6. 热门来源页面
   7. 延时最高页面
   8. 热门页面
   9. 非200请求top页面
   10. 前后端平均延时
   11. 客户端统计
   12. 保存和发布Dashboard
5. 查看结果

1 安装Grafana

Grafana的详细安装步骤请参见Grafana官方文档。

以Ubuntu为例，安装命令为：

wget https://s3-us-west-2.amazonaws.com/grafana-releases/release/grafana_4.5.2_amd64.deb
sudo apt-get install -y adduser libfontconfig
sudo dpkg -i grafana_4.5.2_amd64.deb

如您需要使用饼状图，则需安装Pie chart插件。详细步骤请参考Grafana官方文档。

安装命令如下：

grafana-cli plugins install grafana-piechart-panel

2 安装日志服务插件

请确认Grafana的插件目录位置。 在Ubuntu的插件目录/var/lib/grafana/plugins/安装插件，重启grafana-server。

cd /var/lib/grafana/plugins/
git clone https://github.com/aliyun/aliyun-log-grafana-datasource-plugin
service grafana-server restart

3 配置日志数据源

如您是在本机部署，默认是安装在3000端口。请提前在浏览器打开3000端口。

1. 在左上角单击Grafana的logo，并在弹出窗口上选择Data Sources。
2. 单击右上角的Add data source，添加新的数据源。使用Grafana和阿里云日志服务进行日志可视化分析。
3. 填写新数据源的配置项。

   各部分配置如下：

   配置项	配置内容
   datasource	Name表示名称，请自定义一个新数据源的名称。Type请选择LogService。
   Http Setting	Url输入样例：http://dashboard-demo.cn-hangzhou.log.aliyuncs.com。dashboard-demo是project名称，cn-hangzhou.log.aliyuncs.com是project所在地域的endpoint，在配置自己的数据源时，需要替换成自己的project和region地址。Access可以选择Direct，也可以选择Proxy。
   Http Auth	采用默认配置。
   log service details	日志服务详细配置，分别填写Project和Logstore，以及具备读取权限的AccessKey。AccessKey可以是主账号的AccessKey，也可以是子帐号的AccessKey。

   配置示例：

   
   
   

配置完成后单击Add，即可完成添加DataSource。

4 添加Dashboard

单击打开左上角菜单，选择Dashboards并单击New。在左上角菜单中新加一个Dashboard。

4. 1 配置模板变量

在Grafana中可以配置模板变量，在同一个视图中，通过选择不同的变量值，展示不同的视图。本文档主要配置每个时间区间的大小，以及不同域名的访问情况。

1. 单击页面上方设置图标，然后单击Templating。
2. 在当前页面显示出已经配置的模板变量，单击New， 创建新的模板。

   首先配置一个时间区间，变量的名称是您在配置中使用的变量，在这里起名为myinterval， 在查询条件中，要写成$myinterval ，会自动替换成页面选择的模板值。请参照下表配置。

   配置项	配置内容
   Name	变量名称，您可以命名为myinterval。
   Type	请选择Interval
   Lable	请输入time interval
   Internal Options	value项请输入1m,10m,30m,1h,6h,12h,1d,7d,14d,30d

3. 配置一个域名模板。

   通常一个vps上可以挂载多个域名，那么需要查看不同域名的访问情况。在模板值中，输入*,www.host.com,www.host0.com,www.host1.com， 表示可以查看所有域名，也可以分别查看www.host.com、www.host0.com或者www.host1.com的访问情况。

   域名模板配置如下。

   配置项	配置内容
   Name	变量名称，您可以命名为hostname。
   Type	请选择Custom
   Lable	请输入域名
   Custom Options	value项请输入*,www.host.com,www.host0.com,www.host1.com

   配置完成后，可以在Dashboard页面上方看到刚才配置的模板变量，通过下拉框可以选择任何一个值，例如time interval。

4.2 配置PV、UV

1. 单击左侧ADD ROW，新建一行图表。如果已有一行row，可以在左侧的弹出式菜单里选择Add Panel：
2. Grafana可以支持多重类型的视图。对于PV，UV数据，在标签栏中单击Graph，创建一个Graph视图。
3. 单击Pannel Title，在弹出的窗口中单击Edit。
4. 在Metrics配置中，选择datasource为logservice，输入Query、Y轴和X轴：

   

5. dataSource下拉框中选择之前配置的logservice。

   配置项	配置内容
   Query	$hostname| select approx_distinct(remote_addr) as uv ,count(1) as pv , __time__ - __time__ % $$myinterval as time group by time order by time limit 1000 上述Query中的$hostname，在实际展示时，会替换成用户选择的域名。$$myinterval，则会替换成时间区间，注意myinterval前有两个$符号，而hostname有一个。
   X-Column	time
   Y-Column	uv,pv

   UV和PV的值相差比较大，需要用两个Y轴来展示，在图标下方，单击uv左侧有颜色的线，可以选择uv是在左Y轴显示，还是在右Y轴显示：

   
   
   

   视图需要标题，默认是Panel Title。如需修改，请打开General页签，在Title配置项中输入新的标题，例如PV&UV。

4.3 配置出入网带宽

您可以参考4.2 配置PV、UV，使用同样的方法添加出入网带宽的流量。

主要配置项如下：

$hostname | select sum(body_byte_sent) as net_out, sum(request_length) as net_in
              ,__time__ - __time__ % $$myinterval as time group by __time__ - __time__ %
              $$myinterval limit 10000

4.4 不同HTTP方法的占比

您可以参考4.2 配置PV、UV，使用同样的方法配置不同HTTP方法的占比的饼图。

新建一个Row，视图选择Pie Chart，并在配置中输入Query、x轴和y轴。

主要配置项如下：

$hostname | select count(1) as pv ,method group by method

4.5 不同HTTP状态码占比

您可以参考4.2 配置PV、UV，使用同样的方法配置不同HTTP状态码占比的饼图。

新建一个Row，视图选择Pie Chart。

主要配置项如下：

$hostname | select count(1) as pv ,status group by status

4.6 热门来源页面

您可以参考4.2 配置PV、UV，使用同样的方法配置热门来源页面的饼图。

新建一个Row，视图选择Pie Chart

主要配置项如下：

$hostname | select count(1) as pv , referer group by referer order by pv
            desc

4.7 延时最高页面

您可以参考4.2 配置PV、UV，使用同样的方法配置延时最高页面的视图。

为了以表格形式展示Url和对应的延时，请在创建时，指定Table视图。

主要配置项如下：

$hostname | select url as top_latency_url ,request_time order by request_time desc
              limit 10

4.8 热门页面

您可以参考4.2 配置PV、UV，使用同样的方法配置热门页面的视图。

新建一个表格视图。Data Source选择Logservice，Query内容、X轴和Y轴请参考下表。

$hostname | select count(1) as pv, split_part(url,'?',1) as path group by
              split_part(url,'?',1) order by pv desc limit 20

4.9 非200请求top页面

您可以参考4.2 配置PV、UV，使用同样的方法配置非200请求top页面的视图。

新建一个表格视图。Data Source选择Logservice，Query内容、X轴和Y轴请参考下表。

$hostname not status:200| select count(1) as pv , url group by url order by pv
              desc

4.10 前后端平均延时

您可以参考4.2 配置PV、UV，使用同样的方法配置前后端平均延时的视图。

新建一个Graph视图。Data Source选择Logservice，Query内容、X轴和Y轴请参考下表。

$hostname | select avg(request_time) as response_time, avg(upstream_response_time) as
              upstream_response_time ,__time__ - __time__ % $$myinterval as time group by __time__ -
              __time__ % $$myinterval limit 10000

4.11 客户端统计

您可以参考4.2 配置PV、UV，使用同样的方法配置客户端统计的视图。

新建一个饼图。Data Source选择Logservice，Query内容、X轴和Y轴请参考下表。

$hostname  | select count(1) as pv, case when  regexp_like(http_user_agent , 'okhttp') then 'okhttp' when  regexp_like(http_user_agent ,  'iPhone') then 'iPhone' when regexp_like(http_user_agent ,  'Android')  then 'Android' else 'unKnown' end as http_user_agent group by  http_user_agent order by pv desc limit 10

4.12 保存和发布Dashboard

单击页面上方的保存按钮，发布Dashboard。

5 查看结果

打开Dashboard首页查看效果。示例请参见Demo。

您可以在页面上方选择统计的时间范围，也可以选择统计的时间粒度或不同的域名。

这样整个Nginx访问统计的Dashboard就完成了，您可以从视图中挖掘有价值的信息。