Day 11：架设 Grafana (0)

做好了指标的收集，接下来还有一个很重要的步骤 --- 数据的视觉化，关於这方面的功能虽然 Prometheus 已经有内建简单的图表了，然而在实际运行的服务上它还是不够用，所以通常会看到搭配 Grafana 这套数据视觉化的工具来帮助我们更方便的浏览与分析收集到的资料。

设定 docker compose

架设 grafana 的步骤也很简单，透过 docker image 就可以直接部署了，services 内的定义看起来会像这样：

grafana:
  image: grafana/grafana:8.1.5
  restart: unless-stopped
  volumes:
    - ./grafana/data:/var/lib/grafana
    - ./grafana/provisioning:/etc/grafana/provisioning
  environment:
    - GF_SECURITY_ADMIN_USER=admin
    - GF_SECURITY_ADMIN_PASSWORD__FILE=/run/secrets/admin_password
    - GF_USERS_ALLOW_SIGN_UP=false
  ports:
    - 3000:3000
  secrets:
    - source: gf_admin_password
      target: admin_password

另外，因为这边我使用了 docker secrets 来储存 admin 密码，所以还需要在 docker-compose.yml 的最上层设定 secrets：

secrets:
  gf_admin_password:
    file: ./grafana/secrets/admin_password

这样就可以避免把敏感资讯写入 docker-compose.yml 里面了。另外关於要如何透过环境变数去设定 grafana，可以参考这篇说明，而有关 docker container 的设定在这边。

另外还有一种作法是直接使用 host 上的环境变数来设定，若是这样的话，grafana 的设定可能会长得像是下面这样：

grafana:
  image: grafana/grafana:8.1.5
  restart: unless-stopped
  volumes:
    - ./grafana/data:/var/lib/grafana
    - ./grafana/provisioning:/etc/grafana/provisioning
  environment:
    - GF_SECURITY_ADMIN_USER=$GF_ADMIN
    - GF_SECURITY_ADMIN_PASSWORD=$GF_ADMIN_PASS
    - GF_USERS_ALLOW_SIGN_UP=false
  ports:
    - 3000:3000

按照上面的定义，只要在我的 host 上面去设定 GF_ADMIN 和 GF_ADMIN_PASS 两个环境变数（也可以透过同目录底下的 .env 档），就可以在创建服务时注入到 container 内，详细的说明可以参考 docker 的官方文件。

最後，还需要去修改 grafana/data 这个资料夹的权限设定，让他的 uid 与 container 使用的一致，所以在补一个 sudo chown -R 472:root grafana/data，或是在 service 的定义里面指定 uid 也是可以的选项。

都设定好之後，执行 docker-compose up -d 就可以把他们跑起来了，然後进到 http://localhost:3000，输入刚刚设定的帐号密码，就能看到 grafana 的首页了。

建立 data source

要做资料视觉化，我们首先要有资料嘛，所以第一步就是要来定义我们的资料哪里来，在 grafana 里面这就叫做 data source，目前官方有支援许多常见的工具（列表），甚至有需要的话我们可以自己开发 data source。那麽现在，我们先来设定一个 Prometheus 的 data source 吧。

首先点下首页那个大大的写有 "Add your first data source" 的按钮。