EMQX+Prometheus+Grafana：MQTT 数据可视化监控实践

在完成了 Prometheus 的配置后，我们就可以通过使用配置文件来启动 Prometheus 服务了。如果您是使用 Docker 安装的 Prometheus，可以通过以下命令启动 Prometheus：

docker run -d --name prometheus -p 9090:9090 -v path/to/your/prometheus.yaml:/etc/prometheus.yaml prom/prometheus --config.file=/etc/prometheus/prometheus.yaml

如果是通过其它方式下载和安装的，可以在运行 Prometheus 时指定配置文件路径，例如：

./prometheus --config.file=prometheus.yml

* 注：在使用配置文件时，需要将 /path/to/your/prometheus.yaml
替换为您存储 Prometheus 配置文件的真实路径。

运行成功后，打开 http://localhost:9090
就可以访问 Prometheus 的 Dashboard 了。通过 Dashboard 可以查看 Prometheus 的运行状态，输入 emqx
可以查找 EMQX 的监控数据，如果数据显示正常，就表示此时 Prometheus 已经成功启动，并成功采集到 EMQX 的监控数据。

除直接通过使用包含 EMQX 的 API 配置文件的方式来指定采集数据指标外，EMQX 同样支持使用 Pushgateway 来采集数据指标。

* 注：Pushgateway 为 Prometheus 的一个组件，用于临时存储数据指标，然后由 Prometheus 从 Pushgateway 中拉取数据指标。

通常情况下，我们不需要使用 Pushgateway 服务，因为 EMQX 本身就支持通过 API 来获取数据指标。如果盲目使用 Pushgateway 去获取数据，可能会出现一些问题，例如：Pushgateway 监视多个实例时，Pushgateway 会成为单个故障点，Pushgateway 不会丢弃或者删除其 Series 并且会一直暴露给 Prometheus，等等。

但是在某些情况下，我们可能需要使用 Pushgateway 来采集数据指标，例如：当 EMQX 服务运行在 Docker 容器或 Kubernetes 集群中时，我们可以通过使用 Pushgateway 来采集数据指标，而不需要将 EMQX 的 API 暴露到外部网络中。且通常，Pushgateway 中唯一有效用例是用于捕获服务级批处理作业的结果。点击查看和了解更多，关于何时使用 Pushgateway（https://prometheus.io/docs/practices/pushing/）。

使用 Docker 安装 Pushgateway 服务：

docker run -d --name pushgateway -p 9091:9091 prom/pushgateway

更多关于安装和使用 Pushgateway 的信息，请参考 Pushgateway 安装文档（https://github.com/prometheus/pushgateway#run-it）。此时，我们可以通过 http://localhost:9091
来访问 Pushgateway 的 Dashboard。

EMQX 提供了一个配置 Pushgateway 服务的 API（https://www.emqx.io/docs/zh/v5.0/observability/prometheus.html#通过-dashboard-配置），可以将 EMQX 的数据指标通过配置上报到 Pushgateway 的服务地址中，并最终由 Prometheus 从 Pushgateway 中拉取数据指标。同时也可以直接在 EMQX Dashboard 中配置 Pushgateway 的服务地址，输入完成后，点击更新即可。

使用 Pushgateway 需要在 Prometheus 的配置文件的 scrape_configs
中新增如下配置：

* 注：配置中的 targets 需要替换为您真实的 Pushgateway 服务地址。

# EMQX Pushgateway monitoring
- job_name: 'pushgateway'
  scrape_interval: 5s
  honor_labels: true
  static_configs:
    # Pushgateway IP address and port
    - targets: ['127.0.0.1:9091']

完成配置后，同样根据上述中启动 Prometheus 的操作，使用配置文件启动 Prometheus 服务，即可完成 EMQX 的监控配置。

本文介绍了如何使用 Prometheus 采集 EMQX 的数据指标，并使用 Grafana 对其进行可视化监控。

阅读我们的指标监控文档（https://www.emqx.io/docs/zh/v5.0/observability/metrics-and-stats.html#metrics-stats），了解更多关于您可以查询到的数据指标。

有关使用该监控系统中的规则和配置告警的更多详细教程文章，敬请关注后续推送。