Package io.prometheus.client.exporter

Class HTTPServer.Builder

java.lang.Object

io.prometheus.client.exporter.HTTPServer.Builder

Enclosing class:

HTTPServer

public static class HTTPServer.Builder
extends java.lang.Object

We keep the original constructors of HTTPServer for compatibility, but new configuration parameters like sampleNameFilter must be configured using the Builder.

Field Summary

Fields

Modifier and Type	Field	Description
private com.sun.net.httpserver.Authenticator	authenticator
private boolean	daemon
private java.util.concurrent.ExecutorService	executorService
private java.lang.String	hostname
private com.sun.net.httpserver.HttpsConfigurator	httpsConfigurator
private com.sun.net.httpserver.HttpServer	httpServer
private java.net.InetAddress	inetAddress
private java.net.InetSocketAddress	inetSocketAddress
private int	port
private CollectorRegistry	registry
private Predicate<java.lang.String>	sampleNameFilter
private Supplier<Predicate<java.lang.String>>	sampleNameFilterSupplier

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
private void	assertNull(java.lang.Object o, java.lang.String msg)
private void	assertZero(int i, java.lang.String msg)
HTTPServer	build()	Build the HTTPServer
HTTPServer.Builder	withAuthenticator(com.sun.net.httpserver.Authenticator authenticator)	Optional: Authenticator to use to support authentication.
HTTPServer.Builder	withDaemonThreads(boolean daemon)	By default, the HTTPServer uses non-daemon threads.
HTTPServer.Builder	withExecutorService(java.util.concurrent.ExecutorService executorService)	Optional: ExecutorService used by the httpServer.
HTTPServer.Builder	withHostname(java.lang.String hostname)	Use this hostname to resolve the IP address to bind to.
HTTPServer.Builder	withHttpsConfigurator(com.sun.net.httpserver.HttpsConfigurator configurator)	Optional: HttpsConfigurator to use to support TLS/SSL
HTTPServer.Builder	withHttpServer(com.sun.net.httpserver.HttpServer httpServer)	Use this httpServer.
HTTPServer.Builder	withInetAddress(java.net.InetAddress address)	Bind to this IP address.
HTTPServer.Builder	withInetSocketAddress(java.net.InetSocketAddress address)	Listen on this address.
HTTPServer.Builder	withPort(int port)	Port to bind to.
HTTPServer.Builder	withRegistry(CollectorRegistry registry)	Optional: Default is CollectorRegistry.defaultRegistry.
HTTPServer.Builder	withSampleNameFilter(Predicate<java.lang.String> sampleNameFilter)	Optional: Only export time series where sampleNameFilter.test(name) returns true.
HTTPServer.Builder	withSampleNameFilterSupplier(Supplier<Predicate<java.lang.String>> sampleNameFilterSupplier)	Optional: Only export time series where sampleNameFilter.test(name) returns true.

Methods inherited from class java.lang.Object

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

Field Detail

port

private int port

hostname

private java.lang.String hostname

inetAddress

private java.net.InetAddress inetAddress

inetSocketAddress

private java.net.InetSocketAddress inetSocketAddress

httpServer

private com.sun.net.httpserver.HttpServer httpServer

executorService

private java.util.concurrent.ExecutorService executorService

registry

private CollectorRegistry registry

daemon

private boolean daemon

sampleNameFilter

private Predicate<java.lang.String> sampleNameFilter

sampleNameFilterSupplier

private Supplier<Predicate<java.lang.String>> sampleNameFilterSupplier

authenticator

private com.sun.net.httpserver.Authenticator authenticator

httpsConfigurator

private com.sun.net.httpserver.HttpsConfigurator httpsConfigurator

Constructor Detail

Builder

public Builder()

Method Detail

withPort

public HTTPServer.Builder withPort(int port)

Port to bind to. Must not be called together with withInetSocketAddress(InetSocketAddress) or withHttpServer(HttpServer). Default is 0, indicating that a random port will be selected.

withHostname

public HTTPServer.Builder withHostname(java.lang.String hostname)

Use this hostname to resolve the IP address to bind to. Must not be called together with withInetAddress(InetAddress) or withInetSocketAddress(InetSocketAddress) or withHttpServer(HttpServer). Default is empty, indicating that the HTTPServer binds to the wildcard address.

withInetAddress

public HTTPServer.Builder withInetAddress(java.net.InetAddress address)

Bind to this IP address. Must not be called together with withHostname(String) or withInetSocketAddress(InetSocketAddress) or withHttpServer(HttpServer). Default is empty, indicating that the HTTPServer binds to the wildcard address.

withInetSocketAddress

public HTTPServer.Builder withInetSocketAddress(java.net.InetSocketAddress address)

Listen on this address. Must not be called together with withPort(int), withHostname(String), withInetAddress(InetAddress), or withHttpServer(HttpServer).

withHttpServer

public HTTPServer.Builder withHttpServer(com.sun.net.httpserver.HttpServer httpServer)

Use this httpServer. The httpServer is expected to already be bound to an address. Must not be called together with withPort(int), or withHostname(String), or withInetAddress(InetAddress), or withInetSocketAddress(InetSocketAddress), or withExecutorService(ExecutorService).

withExecutorService

public HTTPServer.Builder withExecutorService(java.util.concurrent.ExecutorService executorService)

Optional: ExecutorService used by the httpServer. Must not be called together with the withHttpServer(HttpServer).

Parameters:

executorService -

Returns:

withDaemonThreads

public HTTPServer.Builder withDaemonThreads(boolean daemon)

By default, the HTTPServer uses non-daemon threads. Set this to true to run the HTTPServer with daemon threads.

withSampleNameFilter

public HTTPServer.Builder withSampleNameFilter(Predicate<java.lang.String> sampleNameFilter)

Optional: Only export time series where sampleNameFilter.test(name) returns true.

Use this if the sampleNameFilter remains the same throughout the lifetime of the HTTPServer. If the sampleNameFilter changes during runtime, use withSampleNameFilterSupplier(Supplier).

withSampleNameFilterSupplier

public HTTPServer.Builder withSampleNameFilterSupplier(Supplier<Predicate<java.lang.String>> sampleNameFilterSupplier)

Optional: Only export time series where sampleNameFilter.test(name) returns true.

Use this if the sampleNameFilter may change during runtime, like for example if you have a hot reload mechanism for your filter config. If the sampleNameFilter remains the same throughout the lifetime of the HTTPServer, use withSampleNameFilter(Predicate) instead.

withRegistry

public HTTPServer.Builder withRegistry(CollectorRegistry registry)

Optional: Default is CollectorRegistry.defaultRegistry.

withAuthenticator

public HTTPServer.Builder withAuthenticator(com.sun.net.httpserver.Authenticator authenticator)

Optional: Authenticator to use to support authentication.

withHttpsConfigurator

public HTTPServer.Builder withHttpsConfigurator(com.sun.net.httpserver.HttpsConfigurator configurator)

Optional: HttpsConfigurator to use to support TLS/SSL

build

public HTTPServer build()
                 throws java.io.IOException

Build the HTTPServer

Throws:

java.io.IOException

assertNull

private void assertNull(java.lang.Object o,
                        java.lang.String msg)

assertZero

private void assertZero(int i,
                        java.lang.String msg)