com.dynatrace.android.agent

Interface DTXAction

public interface DTXAction

Method Summary

Modifier and Type	Method and Description
String	getRequestTag() Generates a Dynatrace request tag for a web request, which has to be manually added as http header (header key can be obtained with the method Dynatrace.getRequestTagHeader()).
String	getRequestTagHeader() This method is identical to Dynatrace.getRequestTagHeader()
void	leaveAction() Completes this action and prepares the data for the next sending interval.
void	reportError(String errorName, int errorCode) Reports an error as key-value pair with the time at which it occurred.
void	reportError(String errorName, Throwable throwable) Reports an error as Throwable with the time at which it occurred.
void	reportEvent(String eventName) Reports the time when a specific event occurred.
void	reportValue(String valueName, double value) Reports a key-value pair with the time at which this event occurred.
void	reportValue(String valueName, int value) Reports a key-value pair with the time at which this event occurred.
void	reportValue(String valueName, long value) Reports a key-value pair with the time at which this event occurred.
void	reportValue(String valueName, String value) Reports a key-value pair with the time at which this event occurred.
void	tagRequest(HttpURLConnection conn) Places a Dynatrace request tag on the web request, which is evaluated by the corresponding web server agent.

Method Detail

leaveAction

void leaveAction()

Completes this action and prepares the data for the next sending interval.

When an outer/parent action is exited, all nested/child actions are automatically closed.

reportEvent

void reportEvent(String eventName)

Reports the time when a specific event occurred. This event can be used to determine when a user passed through a specific part of your application. The reportEvent method is a simple way to track user behavior in your application.

Parameters:

eventName - name of the event

reportValue

void reportValue(String valueName,
                 int value)

Reports a key-value pair with the time at which this event occurred. This event can be used to report important measurement data.

Parameters:

valueName - name of the value

value - an int value from Integer.MIN_VALUE through Integer.MAX_VALUE

reportValue

void reportValue(String valueName,
                 long value)

Reports a key-value pair with the time at which this event occurred. This event can be used to report important measurement data.

Parameters:

valueName - name of the value

value - a long value from Long.MIN_VALUE through Long.MAX_VALUE

Since:

8.197

reportValue

void reportValue(String valueName,
                 double value)

Reports a key-value pair with the time at which this event occurred. This event can be used to report important measurement data.

Parameters:

valueName - data name of the value

value - a double value

reportValue

void reportValue(String valueName,
                 String value)

Reports a key-value pair with the time at which this event occurred. This event can be used to report important measurement data.

Parameters:

valueName - data name of the value

value - a String value

reportError

void reportError(String errorName,
                 int errorCode)

Reports an error as key-value pair with the time at which it occurred. This event can be used to report error codes.

Parameters:

errorName - error name

errorCode - integer error code

reportError

void reportError(String errorName,
                 Throwable throwable)

Reports an error as Throwable with the time at which it occurred. This event can be used to report a handled exception.

Parameters:

errorName - error name

throwable - a caught exception

tagRequest

void tagRequest(HttpURLConnection conn)

Places a Dynatrace request tag on the web request, which is evaluated by the corresponding web server agent. The Dynatrace server will link the server-side PurePath data with this mobile user action.

Parameters:

conn - object to tag

getRequestTagHeader

String getRequestTagHeader()

This method is identical to Dynatrace.getRequestTagHeader()

Returns:

the request tag header name

getRequestTag

String getRequestTag()

Generates a Dynatrace request tag for a web request, which has to be manually added as http header (header key can be obtained with the method Dynatrace.getRequestTagHeader()). The tag value is evaluated by the corresponding web server agent. The Dynatrace server will link the server-side PurePath data with this mobile user action.

Returns:

the request tag value or an empty string, if the mobile agent is not active

See Also:

Dynatrace.getRequestTag()