com.newrelic.agent.service

Interface EventService

All Superinterfaces:

Service

All Known Subinterfaces:

ErrorService, InsightsService, SpanEventsService

All Known Implementing Classes:

ErrorServiceImpl, InsightsServiceImpl, SpanEventsServiceImpl, TransactionEventsService

public interface EventService
extends Service

Defines a service that sends New Relic events. These services can be configured to harvest on a faster interval than other services.

Method Summary

Modifier and Type	Method and Description
void	clearReservoir() Reset the event reservoir to allow for the next harvest to start
java.lang.String	getEventHarvestIntervalMetric() Returns the metric name for this service that records the actual interval in which the harvest is happening.
java.lang.String	getEventHarvestLimitMetric() Returns the metric name for this service that records the harvest limit.
int	getMaxSamplesStored() Returns the current limit of events to store per harvest interval.
java.lang.String	getReportPeriodInSecondsMetric() Returns the metric name for this service that records the expected report period.
void	harvestEvents(java.lang.String appName) Perform the harvest of any pending events right now.
void	setMaxSamplesStored(int maxSamplesStored) Update the current limit of events to store per harvest interval.

Methods inherited from interface com.newrelic.agent.service.Service

getLogger, getName, isEnabled, isStarted, isStartedOrStarting, isStopped, isStoppedOrStopping, start, stop

Method Detail

harvestEvents

void harvestEvents(java.lang.String appName)

Perform the harvest of any pending events right now.

Parameters:

appName - the application to harvest for

getEventHarvestIntervalMetric

java.lang.String getEventHarvestIntervalMetric()

Returns the metric name for this service that records the actual interval in which the harvest is happening. This is different from the report period below because it will be the actual time between harvests, rather than the expected time.

Returns:

harvest interval metric name

getReportPeriodInSecondsMetric

java.lang.String getReportPeriodInSecondsMetric()

Returns the metric name for this service that records the expected report period. This will be the value we get back on connect.

Returns:

report period metric name

getEventHarvestLimitMetric

java.lang.String getEventHarvestLimitMetric()

Returns the metric name for this service that records the harvest limit. This will be the value we get back on connect.

Returns:

event harvest limit metric name

getMaxSamplesStored

int getMaxSamplesStored()

Returns the current limit of events to store per harvest interval. For example, if the maximum size for a 60 second harvest is is 10000 events and this service is configured for 5 second harvests this would return 833 (60/5 = 12, 10000/12 = 833).

Returns:

the maximum number of events to store per configured harvest interval

setMaxSamplesStored

void setMaxSamplesStored(int maxSamplesStored)

Update the current limit of events to store per harvest interval.

Parameters:

maxSamplesStored - the new maximum number of events to store per harvest interval.

clearReservoir

void clearReservoir()

Reset the event reservoir to allow for the next harvest to start