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 Object

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

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
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	withHostname(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(InetAddress address)	Bind to this IP address.
HTTPServer.Builder	withInetSocketAddress(InetSocketAddress address)	Listen on this address.
HTTPServer.Builder	withPort(int port)	Port to bind to.
HTTPServer.Builder	withRegistry(io.prometheus.client.CollectorRegistry registry)	Optional: Default is CollectorRegistry.defaultRegistry.
HTTPServer.Builder	withSampleNameFilter(io.prometheus.client.Predicate<String> sampleNameFilter)	Optional: Only export time series where sampleNameFilter.test(name) returns true.
HTTPServer.Builder	withSampleNameFilterSupplier(io.prometheus.client.Supplier<io.prometheus.client.Predicate<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

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(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(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(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).

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(io.prometheus.client.Predicate<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(io.prometheus.client.Supplier<io.prometheus.client.Predicate<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(io.prometheus.client.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 IOException

Build the HTTPServer

Throws:

IOException