Skip to main content

OpenMetrics

Overview

The OpenMetrics Check uses the OpenMetrics format which is evolved from the Prometheus standard. It pulls metrics from a standard Prometheus scrape endpoint or "target". This Check affords the ability to leverage the many Prometheus Exporters to expose metrics and pull them into the Circonus platform, enabling long-term storage and analytics beyond the capabilities of Prometheus.

Evolved from Prometheus, OpenMetrics is an effort to create an open standard for transmitting metrics at scale, with support for both text representation and Protocol Buffers. For more info about OpenMetrics, please see the OpenMetrics site.

Configuration

The only required parameter is the URL to check, including scheme and hostname (as you would type into a browser's location bar.)

Optional parameters:

NameDescription
auth_userThe user to authenticate as.
auth_passwordThe password to use during authentication.
header name/valueInclude an arbitrary header in the HTTP request.
hostThe Host header value to include in the HTTP request.
portTCP port to which the broker should connect (default: 80)
use_sslUpgrade the TCP connection to use SSL/TLS (default: false)