Prometheus Filter(3.3)

Use this filter to configure the Prometheus metrics that are going to be exposed for scraping.

The purpose with the Prometheus Filter is to prevent flooding of metrics in the storage of the Prometheus host.

The filter is positive, so you define what you want to get. Except in the situation where no Prometheus Filter exists or all existing Prometheus Filters are disabled, then all available metrics are exposed for scraping. The exception being MIM metrics from batch workflows. In case of MIMs from a batch workflows no metrics will be collected unless there is a filter whitelisting them.

A prometheus filter consists of one or many metric filters. Each metric filter has a Metric Name Filter and optionally a number of Label Filter(s). A metric that passes at least one of the metric filters will be exposed for scraping.

Example of a prometheus filter with one metric filter that has no label filters.


Field

Description

EnabledWhether this Prometheus Filter is enabled or not. 

Metric Name Filter

A filter that is applied to the metric name.

Label Filter(s)

A filter that applies to a label that exists on the metric(s) that passes the corresponding metric name filter. 

To Add a Metric Filter

To add a metric filter, take the following steps:

  1. Click the Add button. 
     
  2. In the dialog that is displayed, enter a Metric Name Filter in the form of a regular expression. 
     
  3. Optionally, specify one or many label filter(s) by entering the Label along with a corresponding Label Value Filter
    The Label Value Filter has to be entered in the form of a regular expression. 

  4. Click Add to add the metric filter.

  5. Click Close when done. 


Example, five metric filters are configured. See detailed description in the table below.


Metric Name FilterLabel Filter(s)Filter output

jvm_.*
java_.*
process_.*


Will give you Global statistics (JVM, processes, event management).
com_digitalroute_event.*
MIM metrics related to the event handling system.
com_digitalroute_wf_.*workflow=Default.myWorkflow.*Workflow MIM metrics for the workflows in the Default folder that has a name beginning with "myWorkflow".