Skip to content

Prometheus Configuration

Prometheus is the monitoring solution open-sourced by SoundCloud, featuring its support for a multidimensional data model, flexible query language, and powerful alarm management. EMQX supports integration with Prometheus as a third-party monitoring system. For more information about this feature, see Integrate with Prometheus.

You can enable and configure the Pushgateway through the emqx.conf configuration file, for example:

prometheus {
  push_gateway_server = ""
  interval = 15s
  headers {}
  job_name = "${name}/instance/${name}~${host}"


  • push_gateway_server is to set the URL of a Prometheus push gateway server, which is used to push metrics to Prometheus, default:
  • interval is to set the interval at which metrics will be collected and exported to Prometheus, default: 15s.
  • headers is to set the additional headers to be included in the HTTP request made to the Prometheus push gateway server.
  • job_name is to set the name of the job in Prometheus to which the metrics will be exported, default: "${name}/instance/${name}~${host}"

EMQX has offered more configuration items to serve customized needs better. For details, see Configuration Manual.


You can also use Dashboard to configure the push mode integration with the Prometheus by clicking Management -> Monitoring -> Integration on the left navigation menu.

Once you configured the integration via the Dashboard, your settings will override the same configuration items in emqx.conf.