grafana 入门

grafana是什么

Grafana 是基于JS开发的，功能齐全的度量仪表盘和图形编辑器，帮助开发人员发现问题的工具

如何使用

安装

docker

#下载并运行容器
#可是这样启动的容器数据会由于重启而丢失因此官方推荐下面的方式来启动
docker run -d --name=grafana -p 3000:3000 grafana/grafana

#建立持久化volume
docker run -d -v /var/lib/grafana --name grafana-storage busybox:latest

#从volume得到数据启动
docker run \
  -d \
  -p 3000:3000 \
  --name=grafana \
  --volumes-from grafana-storage \
  grafana/grafana

deb

wget https://grafanarel.s3.amazonaws.com/builds/grafana_3.1.0-1468321182_amd64.deb
sudo dpkg -i grafana_3.1.0-1468321182_amd64.deb
sudo update-rc.d grafana-server defaults 95 10

基本概念

• datasource
  数据的存储源，它定义了将用什么方式来查询数据展现在grafana上面，不一样的datasource拥有不一样的查询语法，grafana支持多种类型例如es,influxdb,

• dashboard
  row的集合

• row
  panel的集合

• panel
  最小的可视化单位，支持多种数据展现方式，table，graph

• playlist
  dashboard的集合，当控制台数量太多时，用来快速在目标群中切换

建立一个datasource

这个的time field有些坑。。。在设置_mapping的时候须要注意必需要date类型(date类型的默认值为strict_date_optional_time||epoch_millis)，由于grafana会使用epoch_millis做为默认格式去查询 time field

epoch_millis 最长13位的时间戳
strict_date_optional_time 支持格式

选择panel

选择合适的类型

query

使用query_string的查询语法

{
  "_index" : "prestashop-2016.09.26",
  "_type" : "fluentd",
  "_id" : "AVdj0EsYixMKEZLuBfYW",
  "_score" : 1.0,
  "_source" : {
    "type" : "request",
    "app" : "en",
    "data" : {
      "clientip" : "108.162.215.126",
      "referer" : "https://www.easyacc.com/",
      "agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.116 Safari/537.36",
      "http_method" : "get",
      "uri" : "/580-easyacc-grid-design-multi-functional-bluetooth-speaker.html",
      "os" : "mac",
      "browser" : "google chrome"
    },
    "@timestamp" : "2016-09-26T08:06:16+08:00"
  }
}

聚合

document
有两个重要的概念 buckets 和metrics

• buckets （桶）
  用来过滤出数据中的某一类集合，相似于sql中的group by和where的组合，例如找出班级中大于14岁的男学生这就是一个嵌套的buckets

• metrics （指标）
  和sql中得count,max,avg同样

grafana中默认的聚合：

date histogram 按照时间段来分桶

• interval
  时间分段的单位，支持从年到分

• min doc count
  es默认将不会显示为0数据的桶，这个参数能够强制显示

• field
  通常是时间字段

time range

有时候可能出现数据源对了，query对了，可是就是没数据的状况，这个时候须要检查时间设置。
这里有一个全局时间（分左边绝对时间范围和右边的相对时间范围），能够设置全部panel的时间查询范围

若是设置的是相对，每一个panel能够在Time Range里面覆盖dashbord的相对时间，不管dashbord里面怎么改，该panel的查询范围不变

若是dashbord设置的是绝对时间，则不能够被覆盖

panel建立完以后你的grafana就能够启程了~