Module io.prometheus.writer.text

Package io.prometheus.metrics.expositionformats

Class OpenMetrics2TextFormatWriter

java.lang.Object

io.prometheus.metrics.expositionformats.OpenMetrics2TextFormatWriter

All Implemented Interfaces:

ExpositionFormatWriter

@StableApi
public class OpenMetrics2TextFormatWriter
extends Object
implements ExpositionFormatWriter

Write the OpenMetrics 2.0 text format. Unlike the OM1 writer, this writer outputs metric names as provided by the user, without appending _total or unit suffixes. The _info suffix is enforced per the OM2 spec (MUST). This is experimental and subject to change as the OpenMetrics 2.0 specification evolves.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OpenMetrics2TextFormatWriter.Builder

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CONTENT_TYPE

Constructor Summary

Constructors

Constructor	Description
OpenMetrics2TextFormatWriter(io.prometheus.metrics.config.OpenMetrics2Properties openMetrics2Properties, boolean createdTimestampsEnabled, boolean exemplarsOnAllMetricTypesEnabled)

Method Summary

Modifier and Type	Method	Description
boolean	accepts(String acceptHeader)
static OpenMetrics2TextFormatWriter.Builder	builder()
static OpenMetrics2TextFormatWriter	create()
String	getContentType()
io.prometheus.metrics.config.OpenMetrics2Properties	getOpenMetrics2Properties()
void	write(OutputStream out, io.prometheus.metrics.model.snapshots.MetricSnapshots metricSnapshots, io.prometheus.metrics.config.EscapingScheme scheme)	Writes the given metric snapshots to the output stream using the specified escaping scheme.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.prometheus.metrics.expositionformats.ExpositionFormatWriter

isAvailable, toDebugString, toDebugString, write

Field Details

CONTENT_TYPE

public static final String CONTENT_TYPE

See Also:

• Constant Field Values

Constructor Details

OpenMetrics2TextFormatWriter

public OpenMetrics2TextFormatWriter(io.prometheus.metrics.config.OpenMetrics2Properties openMetrics2Properties,
 boolean createdTimestampsEnabled,
 boolean exemplarsOnAllMetricTypesEnabled)

Parameters:

openMetrics2Properties - OpenMetrics 2.0 feature flags

createdTimestampsEnabled - whether delegated OM1 output includes _created metrics

exemplarsOnAllMetricTypesEnabled - whether to include exemplars on all metric types

Method Details

builder

public static OpenMetrics2TextFormatWriter.Builder builder()

create

public static OpenMetrics2TextFormatWriter create()

accepts

public boolean accepts(@Nullable
 String acceptHeader)

Specified by:

accepts in interface ExpositionFormatWriter

getContentType

public String getContentType()

Specified by:

getContentType in interface ExpositionFormatWriter

getOpenMetrics2Properties

public io.prometheus.metrics.config.OpenMetrics2Properties getOpenMetrics2Properties()

write

public void write(OutputStream out,
 io.prometheus.metrics.model.snapshots.MetricSnapshots metricSnapshots,
 io.prometheus.metrics.config.EscapingScheme scheme)
           throws IOException

Description copied from interface: ExpositionFormatWriter

Writes the given metric snapshots to the output stream using the specified escaping scheme.

Specified by:

write in interface ExpositionFormatWriter

Throws:

IOException