Prometheus Monitor Attribute Metric

Prometheus Monitor Attribute Metrics provide a way of publishing the value of a monitor attribute as a Prometheus metric.

Relations to This Component Properties dsconfig Usage

Relations to This Component

The following components have a direct composition relation to Prometheus Monitor Attribute Metrics:

Properties

The properties supported by this managed object are as follows:


Basic Properties: Advanced Properties:
 metric-name  None
 monitor-attribute-name
 monitor-object-class-name
 metric-type
 filter
 metric-description
 label-name-value-pair

Basic Properties

metric-name

Description
The name that will be used in the metric to be consumed by Prometheus.
Default Value
None
Allowed Values
The metric name must start with a letter or underscore, and it must only contain letters, digits, and underscores.
Multi-Valued
No
Required
Yes
Admin Action Required
None. Modification requires no further action

monitor-attribute-name (Read-Only)

Description
The name of the monitor attribute that contains the numeric value to be published.
Default Value
None
Allowed Values
A string
Multi-Valued
No
Required
Yes
Admin Action Required
None. Modification requires no further action

monitor-object-class-name (Read-Only)

Description
The name of the object class for monitor entries that contain the monitor attribute.
Default Value
None
Allowed Values
A string
Multi-Valued
No
Required
Yes
Admin Action Required
None. Modification requires no further action

metric-type

Description
The metric type that should be used for the value of the specified monitor attribute.
Default Value
None
Allowed Values
counter - The value should be treated as a counter whose value increases over time as associated events occurs.

gauge - The value should be treated as a gauge whose value may go up or down over time to reflect a point-in-time value.

boolean - The value should be treated as a true/false value that will change over time. This should only be used for monitor attributes that have true/false, enabled/disabled, on/off, and 1/0 values. Note: Prometheus does not support boolean metric values, so this value will be represented as 0 or 1 in Prometheus and will have "gauge" as its Prometheus metric type.
Multi-Valued
No
Required
Yes
Admin Action Required
None. Modification requires no further action

filter

Description
A filter that may be used to restrict the set of monitor entries for which the metric should be generated.
Default Value
None
Allowed Values
A valid LDAP search filter
Multi-Valued
No
Required
No
Admin Action Required
None. Modification requires no further action

metric-description

Description
A human-readable description that should be published as part of the metric definition.
Default Value
None
Allowed Values
A string
Multi-Valued
No
Required
No
Admin Action Required
None. Modification requires no further action

label-name-value-pair

Description
A set of name-value pairs for labels that should be included in the published metric for the target attribute. Each value should be presented in the form "name=value", with an equal sign used to separate the name and the value.
Default Value
None
Allowed Values
Each value must be a label name followed by an equal sign and the label value. The label name must start with a letter or underscore, and it must only contain letters, digits, and underscores. The label value can be any non-empty string.
Multi-Valued
Yes
Required
No
Admin Action Required
None. Modification requires no further action


dsconfig Usage

To list the configured Prometheus Monitor Attribute Metrics:

dsconfig list-prometheus-monitor-attribute-metrics
     [--property {propertyName}] ...

To view the configuration for an existing Prometheus Monitor Attribute Metric:

dsconfig get-prometheus-monitor-attribute-metric-prop
     --metric-name {name}
     --extension-name {name}
     [--tab-delimited]
     [--script-friendly]
     [--property {propertyName}] ...

To update the configuration for an existing Prometheus Monitor Attribute Metric:

dsconfig set-prometheus-monitor-attribute-metric-prop
     --metric-name {name}
     --extension-name {name}
     (--set|--add|--remove) {propertyName}:{propertyValue}
     [(--set|--add|--remove) {propertyName}:{propertyValue}] ...

To create a new Prometheus Monitor Attribute Metric:

dsconfig create-prometheus-monitor-attribute-metric
     --metric-name {name}
     --extension-name {name}
     --set monitor-attribute-name:{propertyValue}
     --set monitor-object-class-name:{propertyValue}
     --set metric-type:{propertyValue}
     [--set {propertyName}:{propertyValue}] ...

To delete an existing Prometheus Monitor Attribute Metric:

dsconfig delete-prometheus-monitor-attribute-metric
     --metric-name {name}
     --extension-name {name}