一、Docker

首先需要安装 Docker，已经安装的朋友直接跳过该节即可。

Docker 最近新出了 Docker Desktop，可以对容器和镜像可视化管理，还是很不错的。访问官网

下载即可，这里我使用 Windows 平台进行安装。【最好采用科学上网，否则速度会很感人】

如果安装完毕后打开报下图的错，需要在更新下 WSL2，点此下载。

启动成功后如下图所示：

二、Prometheus + Grafana

打开 PowerShell 或其他命令行工具，下载镜像：

1
docker pull prom/prometheus

下载完毕后，提前准备好配置文件，新建配置文件 prometheus.yml，内容如下。将其保存到任一位置即可，并记录下它的绝对路径。我这里把它放置在了桌面，因此它的绝对路径是：C:\Users\Jitwxs\Desktop\prometheus.yml。

1
2
3
4
5
6
7
8
9
10
global:
  scrape_interval:     60s
  evaluation_interval: 60s
 
scrape_configs:
  - job_name: prometheus
    static_configs:
      - targets: ['localhost:9090']
        labels:
          instance: prometheus

执行命令启动容器【注意命令中的绝对路径，需要替换成你自己实际的路径】：

1
docker run  -d -p 9090:9090 -v C:\Users\Jitwxs\Desktop\prometheus.yml:/etc/prometheus/prometheus.yml prom/prometheus

执行完毕后，打开 Docker 客户端，可以看到 Prometheus 已经启动成功，在 Mounts 中可以看到配置文件也被挂载到容器内。

打开浏览器，输入 http://127.0.0.1:9090 即可登录 Prometheus，选择 Status -> Configuration 也能看到我们的配置文件。

至此 Prometheus 的起步就完成了，下面来启动 Grafana 把。

三、Grafana

下载镜像：

1
docker pull grafana/grafana

启动容器：

1
docker run -d -p 3000:3000 --name=grafana grafana/grafana

执行完毕后，打开 Docker 客户端，可以看到 Grafana 已经启动成功。

打开浏览器，输入 http://127.0.0.1:3000，即可登录 Grafana 首页，使用默认用户名密码 admin 登录即可。

首先配置下 Grafana 的数据源，点击右侧⚙图标，选择 Data Sources 选项卡，然后选择 右侧的 Prometheus。

并做以下配置：

  • URL: http://127.0.0.1:9090
  • Access: Browser

然后点击下方 Save & Test 按钮，弹出 Data source is working 的绿色提示即可。

【注意：如果弹出的是红色的HTTP Error Bad Gateway，尝试将 Access 改为 Server 试试看】

至此完成 Grafana 的起步。

四、入门实例

下面展示一个简单的心跳监测的功能，Prometheus 服务自身也会对外暴露一些 Metrics，下面来实现如何在 Grafana 上侦听 Prometheus 服务是否存活。

我们在 Prometheus 的首页上，搜索一个名为 up 的 metrics，搜索结果中有一条，它有两个 label，通过 instance 这个 label 得知这条记录就是 prometheus 提供的。

切换到 Grafana 上，点击左侧的加号，点击 Dashboard，会创建一个 Dashboard。然后我们选择 Add new panel，新建一个面板。

在下面的 PromQL 表达式上输入刚刚的 metrics，然后将图表从默认的 Graph 改为 Stat。

对于 up 这个 metrics，可能的取值有 1 和不存在。我们可以通过 Value Mapping 功能，将取值和实际的展示的内容作对应。同时对于不同的取值，也可以指定配色。

如下图所示，我将 1 映射为 UP，将 null 映射为 DOWN。同时，将 1 颜色指定为绿色，0 指定为红色。

另外图表下方的 Graph 展示了这个数值在不同时间的变化情况，假设我们只想关心当前的，不想关心这个服务什么时候 UP 什么时候 DOWN，可以将其隐藏掉。

至此这个 Panel 就制作好了，返回到 Dashboard 后形如下图所示：

让我们尝试关闭掉 prometheus 服务

点击 Grafana Dashboard 右上角的刷新后，发现变成了 DOWN。将 Prometheus 服务恢复后，又恢复正常。