com.newrelic.agent

Class RPMService

java.lang.Object

com.newrelic.agent.service.AbstractService

com.newrelic.agent.RPMService

All Implemented Interfaces:

AgentConfigListener, EnvironmentChangeListener, IRPMService, Service

public class RPMService
extends AbstractService
implements IRPMService, EnvironmentChangeListener, AgentConfigListener

The RPMService acts as a stub for communication between the agent and New Relic.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COLLECT_ERRORS_KEY
static java.lang.String	COLLECT_TRACES_KEY
static java.lang.String	DATA_REPORT_PERIOD_KEY

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

logger

Constructor Summary

Constructors

Constructor and Description
RPMService(java.util.List<java.lang.String> appNames, ConnectionConfigListener connectionConfigListener, ConnectionListener connectionListener, java.util.List<AgentConnectionEstablishedListener> agentConnectionEstablishedListeners)

Method Summary

Modifier and Type	Method and Description
void	agentIdentityChanged(AgentIdentity agentIdentity) This is invoked whenever the identifying environment information changes.
void	configChanged(java.lang.String appName, AgentConfig agentConfig)
void	connect() This thing ultimately calls launch() after about 50 billion points of indirection.
protected void	doStart()
protected void	doStop()
java.util.List<java.util.List<?>>	getAgentCommands()
java.lang.String	getApplicationLink()
java.lang.String	getApplicationName() Returns the name of the application the rpm service is reporting data for.
long	getConnectionTimestamp() The timestamp of when the agent connected to the New Relic service.
java.lang.String	getEntityGuid()
ErrorService	getErrorService()
java.lang.String	getHostString()
protected java.util.Map<java.lang.String,java.lang.Object>	getStartOptions() Returns a map of startup options to be sent to RPM when the RPM service connects.
TransactionNamingScheme	getTransactionNamingScheme()
void	harvest(StatsEngine statsEngine)
void	harvestNow()
boolean	hasEverConnected()
boolean	isConnected()
boolean	isEnabled() Is the service enabled.
boolean	isMainApp() Is this the main application?
void	launch() Notify RPM that this agent has launched, and obtain the agent run id
void	reconnect()
void	sendAnalyticsEvents(int reservoirSize, int eventsSeen, java.util.Collection<TransactionEvent> events)
void	sendCommandResults(java.util.Map<java.lang.Long,java.lang.Object> commandResults)
void	sendCustomAnalyticsEvents(int reservoirSize, int eventsSeen, java.util.Collection<? extends com.newrelic.agent.model.CustomInsightsEvent> events)
void	sendErrorData(java.util.List<TracedError> errors)
void	sendErrorEvents(int reservoirSize, int eventsSeen, java.util.Collection<com.newrelic.agent.model.ErrorEvent> events)
void	sendLogEvents(java.util.Collection<? extends com.newrelic.agent.model.LogEvent> events)
void	sendModules(java.util.List<JarData> jarDataList) Sends the meta information about the jars used by the application to the New Relic service.
java.util.List<java.lang.Long>	sendProfileData(java.util.List<ProfileData> profiles)
void	sendSpanEvents(int reservoirSize, int eventsSeen, java.util.Collection<com.newrelic.agent.model.SpanEvent> events)
void	sendSqlTraceData(java.util.List<SqlTrace> sqlTraces)
void	sendTransactionTraceData(java.util.List<TransactionTrace> traces)
void	shutdown() notify RPM that the agent is shutting down
java.lang.String	toString()

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, wait, wait, wait

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

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

Field Detail

COLLECT_TRACES_KEY

public static final java.lang.String COLLECT_TRACES_KEY

See Also:

Constant Field Values

COLLECT_ERRORS_KEY

public static final java.lang.String COLLECT_ERRORS_KEY

See Also:

Constant Field Values

DATA_REPORT_PERIOD_KEY

public static final java.lang.String DATA_REPORT_PERIOD_KEY

See Also:

Constant Field Values

Constructor Detail

RPMService

public RPMService(java.util.List<java.lang.String> appNames,
                  ConnectionConfigListener connectionConfigListener,
                  ConnectionListener connectionListener,
                  java.util.List<AgentConnectionEstablishedListener> agentConnectionEstablishedListeners)

Method Detail

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

doStart

protected void doStart()
                throws java.lang.Exception

Specified by:

doStart in class AbstractService

Throws:

java.lang.Exception

getStartOptions

protected java.util.Map<java.lang.String,java.lang.Object> getStartOptions()

Returns a map of startup options to be sent to RPM when the RPM service connects.

launch

public void launch()
            throws java.lang.Exception

Notify RPM that this agent has launched, and obtain the agent run id

Specified by:

launch in interface IRPMService

Throws:

java.lang.Exception

getEntityGuid

public java.lang.String getEntityGuid()

Specified by:

getEntityGuid in interface IRPMService

getApplicationLink

public java.lang.String getApplicationLink()

Specified by:

getApplicationLink in interface IRPMService

getTransactionNamingScheme

public TransactionNamingScheme getTransactionNamingScheme()

Specified by:

getTransactionNamingScheme in interface IRPMService

reconnect

public void reconnect()

Specified by:

reconnect in interface IRPMService

getHostString

public java.lang.String getHostString()

Specified by:

getHostString in interface IRPMService

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

sendErrorData

public void sendErrorData(java.util.List<TracedError> errors)

Specified by:

sendErrorData in interface IRPMService

sendProfileData

public java.util.List<java.lang.Long> sendProfileData(java.util.List<ProfileData> profiles)
                                               throws java.lang.Exception

Specified by:

sendProfileData in interface IRPMService

Throws:

java.lang.Exception

sendModules

public void sendModules(java.util.List<JarData> jarDataList)
                 throws java.lang.Exception

Description copied from interface: IRPMService

Sends the meta information about the jars used by the application to the New Relic service. Note that only the jars which have not yet been sent be passed into this method.

Specified by:

sendModules in interface IRPMService

Parameters:

jarDataList - The jars which have not yet been sent to the New Relic service.

Throws:

java.lang.Exception - Thrown if a problem sending the jars.

sendAnalyticsEvents

public void sendAnalyticsEvents(int reservoirSize,
                                int eventsSeen,
                                java.util.Collection<TransactionEvent> events)
                         throws java.lang.Exception

Specified by:

sendAnalyticsEvents in interface IRPMService

Throws:

java.lang.Exception

sendCustomAnalyticsEvents

public void sendCustomAnalyticsEvents(int reservoirSize,
                                      int eventsSeen,
                                      java.util.Collection<? extends com.newrelic.agent.model.CustomInsightsEvent> events)
                               throws java.lang.Exception

Specified by:

sendCustomAnalyticsEvents in interface IRPMService

Throws:

java.lang.Exception

sendLogEvents

public void sendLogEvents(java.util.Collection<? extends com.newrelic.agent.model.LogEvent> events)
                   throws java.lang.Exception

Specified by:

sendLogEvents in interface IRPMService

Throws:

java.lang.Exception

sendSpanEvents

public void sendSpanEvents(int reservoirSize,
                           int eventsSeen,
                           java.util.Collection<com.newrelic.agent.model.SpanEvent> events)
                    throws java.lang.Exception

Specified by:

sendSpanEvents in interface IRPMService

Throws:

java.lang.Exception

sendErrorEvents

public void sendErrorEvents(int reservoirSize,
                            int eventsSeen,
                            java.util.Collection<com.newrelic.agent.model.ErrorEvent> events)
                     throws java.lang.Exception

Specified by:

sendErrorEvents in interface IRPMService

Throws:

java.lang.Exception

sendSqlTraceData

public void sendSqlTraceData(java.util.List<SqlTrace> sqlTraces)
                      throws java.lang.Exception

Specified by:

sendSqlTraceData in interface IRPMService

Throws:

java.lang.Exception

sendTransactionTraceData

public void sendTransactionTraceData(java.util.List<TransactionTrace> traces)
                              throws java.lang.Exception

Specified by:

sendTransactionTraceData in interface IRPMService

Throws:

java.lang.Exception

getErrorService

public ErrorService getErrorService()

Specified by:

getErrorService in interface IRPMService

getApplicationName

public java.lang.String getApplicationName()

Returns the name of the application the rpm service is reporting data for.

Specified by:

getApplicationName in interface IRPMService

Returns:

the name of the application (this is interned)

isMainApp

public boolean isMainApp()

Is this the main application?

Specified by:

isMainApp in interface IRPMService

Returns:

true if this is the main application

shutdown

public void shutdown()
              throws java.lang.Exception

notify RPM that the agent is shutting down

Throws:

java.lang.Exception

harvestNow

public void harvestNow()

Specified by:

harvestNow in interface IRPMService

getAgentCommands

public java.util.List<java.util.List<?>> getAgentCommands()
                                                   throws java.lang.Exception

Specified by:

getAgentCommands in interface IRPMService

Throws:

java.lang.Exception

sendCommandResults

public void sendCommandResults(java.util.Map<java.lang.Long,java.lang.Object> commandResults)
                        throws java.lang.Exception

Specified by:

sendCommandResults in interface IRPMService

Throws:

java.lang.Exception

connect

public void connect()

This thing ultimately calls launch() after about 50 billion points of indirection.

isConnected

public boolean isConnected()

Specified by:

isConnected in interface IRPMService

hasEverConnected

public boolean hasEverConnected()

Specified by:

hasEverConnected in interface IRPMService

harvest

public void harvest(StatsEngine statsEngine)

Specified by:

harvest in interface IRPMService

doStop

protected void doStop()

Specified by:

doStop in class AbstractService

getConnectionTimestamp

public long getConnectionTimestamp()

Description copied from interface: IRPMService

The timestamp of when the agent connected to the New Relic service.

Specified by:

getConnectionTimestamp in interface IRPMService

agentIdentityChanged

public void agentIdentityChanged(AgentIdentity agentIdentity)

Description copied from interface: EnvironmentChangeListener

This is invoked whenever the identifying environment information changes.

Specified by:

agentIdentityChanged in interface EnvironmentChangeListener

configChanged

public void configChanged(java.lang.String appName,
                          AgentConfig agentConfig)

Specified by:

configChanged in interface AgentConfigListener