Package com.newrelic.telemetry.metrics

Class MetricBatchSender

java.lang.Object

com.newrelic.telemetry.metrics.MetricBatchSender

public class MetricBatchSender
extends java.lang.Object

Manages the sending of MetricBatch instances to the New Relic Metrics API.

Method Summary

Modifier and Type	Method	Description
static SenderConfiguration.SenderConfigurationBuilder	configurationBuilder()
static MetricBatchSender	create(SenderConfiguration configuration)	Build the final MetricBatchSender.
static MetricBatchSender	create(java.util.function.Supplier<HttpPoster> httpPosterCreator, BaseConfig baseConfig)	Creates a new MetricBatchSender with the given supplier of HttpPoster impl and a BaseConfig instance, with all configuration NOT in BaseConfig being default.
static java.net.URL	returnEndpoint(java.lang.String userRegion)
Response	sendBatch(MetricBatch batch)	Send a batch of metrics to New Relic.

Methods inherited from class java.lang.Object

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

Method Detail

sendBatch

public Response sendBatch(MetricBatch batch)
                   throws ResponseException

Send a batch of metrics to New Relic.

Parameters:

batch - The batch to send. This batch will be drained of accumulated metrics as a part of this process.

Returns:

The response from the ingest API.

Throws:

ResponseException - In cases where the batch is unable to be successfully sent, one of the subclasses of ResponseException will be thrown. See the documentation on that hierarchy for details on the recommended ways to respond to those exceptions.

create

public static MetricBatchSender create(java.util.function.Supplier<HttpPoster> httpPosterCreator,
                                       BaseConfig baseConfig)

Creates a new MetricBatchSender with the given supplier of HttpPoster impl and a BaseConfig instance, with all configuration NOT in BaseConfig being default.

Parameters:

httpPosterCreator - A supplier that returns an HttpPoster for this MetricBatchSender to use.

baseConfig - basic configuration for the sender

Returns:

a shiny new MetricBatchSender instance

create

public static MetricBatchSender create(SenderConfiguration configuration)

Build the final MetricBatchSender.

Parameters:

configuration - new relict rest api ingest configurations

Returns:

the fully configured MetricBatchSender object

returnEndpoint

public static java.net.URL returnEndpoint(java.lang.String userRegion)
                                   throws java.net.MalformedURLException

Throws:

java.net.MalformedURLException

configurationBuilder

public static SenderConfiguration.SenderConfigurationBuilder configurationBuilder()