IRONdb has native endpoints for accepting remote write data from a Prometheus
installation. Once the Prometheus module is enabled, data can be sent to IRONdb
by setting the Prometheus
remote_write endpoint to:
Enable the Prometheus Module
As of version 0.17.0, the Prometheus module is active by default for new installations. If you previously activated the module using the instructions below, you may remove the line from
irondb-modules-site.confafter upgrading to 0.17.0 or later, but it is not an error if the line appears more than once.
IRONdb must be configured such that the Prometheus module is enabled for reading or writing Prometheus data natively. Prometheus support is activated by adding the following line:
<generic image="prometheus" name="prometheus"/>
/opt/circonus/etc/irondb-modules-site.conf on each IRONdb node. This file
preserves local modifications across package updates. A service
restart is required after changing
Prometheus data is not namespaced by nature. This can create confusion if
different copies of Prometheus have identically named metrics. Inside of
IRONdb, we require that all data be namespaced under a UUID. This UUID can be
uuidgen on a typical UNIX(like) system or via any external tool
or website that generates well-formed,
UUIDs. Each distinct set of Prometheus data should have its own UUID. For
high-availability in Prometheus it is the recommended pratice to have two
copies collecting the same data. While these two instances do not contain the
same data, they do represent the same metrics, and so should share a common
UUID for their namespace. One may wish to send both of these instances into
IRONdb where they simply become more samples in the given metric stream.
All metrics live under a numeric identifier (one can think of this like an account ID). Metric names can only be associated with one "account ID". This allows separate client instances that completely segregate data.
Writing Prometheus Data to IRONdb
To configure a Prometheus instance to write to IRONdb the Prometheus YAML
configuration file will need to be updated. The
field should be set to
This should look something like:
remote_write: - url: "https://irondbnode:8112/module/prometheus/write/1/321b704b-a8ff-44b7-8171-777dc49bc788"