com.newrelic.agent.errors

Class ErrorServiceImpl

java.lang.Object

com.newrelic.agent.service.AbstractService

com.newrelic.agent.errors.ErrorServiceImpl

All Implemented Interfaces:

ErrorService, HarvestListener, EventService, Service

public class ErrorServiceImpl
extends AbstractService
implements ErrorService, HarvestListener

Field Summary

Fields

Modifier and Type	Field and Description
protected Harvestable	harvestable

Fields inherited from class com.newrelic.agent.service.AbstractService

logger

Constructor Summary

Constructors

Constructor and Description
ErrorServiceImpl(java.lang.String appName) Note that an instance of this class is created for each RPMService, which is a side effect of using auto app naming and the servlet instrumentation.

Method Summary

Modifier and Type	Method and Description
void	addHarvestableToService()
void	afterHarvest(java.lang.String appName) Called after the harvest.
void	beforeHarvest(java.lang.String appName, StatsEngine statsEngine) Called before the harvest.
void	clearReservoir() Reset the event reservoir to allow for the next harvest to start
void	clearReservoir(java.lang.String appName)
protected static com.newrelic.agent.model.ErrorEvent	createErrorEvent(java.lang.String theAppName, TracedError error, TransactionData transactionData, TransactionStats transactionStats)
protected void	doStart()
protected void	doStop()
java.util.List<TracedError>	getAndClearTracedErrors() Get the traced errors for this reporting period.
static java.util.Collection<? extends PointCut>	getEnabledErrorHandlerPointCuts()
ErrorAnalyzer	getErrorAnalyzer()
ErrorCollectorConfig	getErrorCollectorConfig()
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.
DistributedSamplingPriorityQueue<com.newrelic.agent.model.ErrorEvent>	getReservoir(java.lang.String appName)
int	getTracedErrorsCount()
void	harvestEvents(java.lang.String appName) Perform the harvest of any pending events right now.
void	harvestTracedErrors(java.lang.String appName, StatsEngine statsEngine)
boolean	isEnabled() Is the service enabled.
void	refreshErrorCollectorConfig(AgentConfig agentConfig)
void	reportError(java.lang.String message, java.util.Map<java.lang.String,?> params, boolean expected)
void	reportError(TracedError error)
protected void	reportError(TracedError error, TransactionData transactionData, TransactionStats transactionStats)
void	reportErrors(TracedError... errors)
void	reportException(java.lang.Throwable throwable) Checks if exception should be ignored.
void	reportException(java.lang.Throwable throwable, java.util.Map<java.lang.String,?> params, boolean expected) Report an exception to New Relic.
void	reportHTTPError(java.lang.String message, int statusCode, java.lang.String uri)
void	setHarvestable(Harvestable harvestable)
void	setMaxSamplesStored(int maxSamplesStored) Update the current limit of events to store per harvest interval.

Methods inherited from class com.newrelic.agent.service.AbstractService

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

Methods inherited from class java.lang.Object

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

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

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

Field Detail

harvestable

protected Harvestable harvestable

Constructor Detail

ErrorServiceImpl

public ErrorServiceImpl(java.lang.String appName)

Note that an instance of this class is created for each RPMService, which is a side effect of using auto app naming and the servlet instrumentation.

Method Detail

doStart

protected void doStart()
                throws java.lang.Exception

Specified by:

doStart in class AbstractService

Throws:

java.lang.Exception

isEnabled

public boolean isEnabled()

Description copied from interface: Service

Is the service enabled.

Specified by:

isEnabled in interface Service

Returns:

true if the service is enabled

doStop

protected void doStop()
               throws java.lang.Exception

Specified by:

doStop in class AbstractService

Throws:

java.lang.Exception

addHarvestableToService

public void addHarvestableToService()

Specified by:

addHarvestableToService in interface ErrorService

getErrorCollectorConfig

public ErrorCollectorConfig getErrorCollectorConfig()

getMaxSamplesStored

public int getMaxSamplesStored()

Description copied from interface: EventService

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

Specified by:

getMaxSamplesStored in interface EventService

Returns:

the maximum number of events to store per configured harvest interval

setMaxSamplesStored

public void setMaxSamplesStored(int maxSamplesStored)

Description copied from interface: EventService

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

Specified by:

setMaxSamplesStored in interface EventService

Parameters:

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

clearReservoir

public void clearReservoir()

Description copied from interface: EventService

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

Specified by:

clearReservoir in interface EventService

clearReservoir

public void clearReservoir(java.lang.String appName)

setHarvestable

public void setHarvestable(Harvestable harvestable)

harvestEvents

public void harvestEvents(java.lang.String appName)

Description copied from interface: EventService

Perform the harvest of any pending events right now.

Specified by:

harvestEvents in interface EventService

Parameters:

appName - the application to harvest for

getEventHarvestIntervalMetric

public java.lang.String getEventHarvestIntervalMetric()

Description copied from interface: EventService

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.

Specified by:

getEventHarvestIntervalMetric in interface EventService

Returns:

harvest interval metric name

getReportPeriodInSecondsMetric

public java.lang.String getReportPeriodInSecondsMetric()

Description copied from interface: EventService

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

Specified by:

getReportPeriodInSecondsMetric in interface EventService

Returns:

report period metric name

getEventHarvestLimitMetric

public java.lang.String getEventHarvestLimitMetric()

Description copied from interface: EventService

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

Specified by:

getEventHarvestLimitMetric in interface EventService

Returns:

event harvest limit metric name

harvestTracedErrors

public void harvestTracedErrors(java.lang.String appName,
                                StatsEngine statsEngine)

refreshErrorCollectorConfig

public void refreshErrorCollectorConfig(AgentConfig agentConfig)

reportErrors

public void reportErrors(TracedError... errors)

Specified by:

reportErrors in interface ErrorService

reportError

public void reportError(TracedError error)

Specified by:

reportError in interface ErrorService

reportError

protected void reportError(TracedError error,
                           TransactionData transactionData,
                           TransactionStats transactionStats)

createErrorEvent

protected static com.newrelic.agent.model.ErrorEvent createErrorEvent(java.lang.String theAppName,
                                                                      TracedError error,
                                                                      TransactionData transactionData,
                                                                      TransactionStats transactionStats)

getAndClearTracedErrors

public java.util.List<TracedError> getAndClearTracedErrors()

Get the traced errors for this reporting period.

Specified by:

getAndClearTracedErrors in interface ErrorService

Returns:

the traced errors for this reporting period.

getErrorAnalyzer

public ErrorAnalyzer getErrorAnalyzer()

getTracedErrorsCount

public int getTracedErrorsCount()

getReservoir

public DistributedSamplingPriorityQueue<com.newrelic.agent.model.ErrorEvent> getReservoir(java.lang.String appName)

reportException

public void reportException(java.lang.Throwable throwable)

Checks if exception should be ignored.

Specified by:

reportException in interface ErrorService

reportException

public void reportException(java.lang.Throwable throwable,
                            java.util.Map<java.lang.String,?> params,
                            boolean expected)

Report an exception to New Relic. Implements the public API.

Specified by:

reportException in interface ErrorService

reportError

public void reportError(java.lang.String message,
                        java.util.Map<java.lang.String,?> params,
                        boolean expected)

Specified by:

reportError in interface ErrorService

beforeHarvest

public void beforeHarvest(java.lang.String appName,
                          StatsEngine statsEngine)

Description copied from interface: HarvestListener

Called before the harvest. The service may or may not be currently connected.

Specified by:

beforeHarvest in interface HarvestListener

afterHarvest

public void afterHarvest(java.lang.String appName)

Description copied from interface: HarvestListener

Called after the harvest. The service may or may not be currently connected.

Specified by:

afterHarvest in interface HarvestListener

getEnabledErrorHandlerPointCuts

public static java.util.Collection<? extends PointCut> getEnabledErrorHandlerPointCuts()

reportHTTPError

public void reportHTTPError(java.lang.String message,
                            int statusCode,
                            java.lang.String uri)

Specified by:

reportHTTPError in interface ErrorService