Package com.dynatrace.android.agent

Class Dynatrace

  • public class Dynatrace
extends Object
    OneAgent SDK for Android.

    • Method Detail

      • startup

        public static void startup​(Activity activity,
                           com.dynatrace.android.agent.conf.Configuration configuration)
        Initializing the mobile agent for capturing and reporting data.

        This method should be used, when the agent is not immediately started in the application startup phase.

        Parameters:
        activity - instance of the currently active activity
        configuration - configuration object created by the DynatraceConfigurationBuilder
        Since:
        8.231
        See Also:
        startup(Application, Configuration)

      • shutdown

        public static void shutdown()
        Shuts down the mobile agent.

        All data capturing stops. The mobile agent also attempts to flush the data for up to 5 seconds. This is done in a background thread.

      • getCaptureStatus

        public static boolean getCaptureStatus()
        Get the current data capture state.
        Returns:
        true, if data is captured

      • setGpsLocation

        public static void setGpsLocation​(Location location)
        Sets a given GPS location.

        The location is then reported along with other captured data.

        Parameters:
        location - to be saved

      • getRequestTagHeader

        public static String getRequestTagHeader()
        Returns the Dynatrace request tag header name.

        This header is used together with the tag generated by getRequestTag() and placed as HTTP header onto a web request.

        Returns:
        the request tag header name

      • getRequestTag

        public static String getRequestTag()
        Returns the Dynatrace request tag which has to be set manually as HTTP header.

        The header key can be obtained with the method getRequestTagHeader(). If there is an open action in the current thread at the time the request is tagged, the web request is assigned (by the mobile agent) to the open action.

        Returns:
        the request tag value or an empty string, if the mobile agent is not active
        See Also:
        getRequestTagHeader(), DTXAction.getRequestTag()

      • tagRequest

        @Deprecated
public static void tagRequest​(HttpURLConnection conn)
        Deprecated.
        As of version 8.255, instead manually obtain the request tag and the header key and add them to the HTTP headers of HttpURLConnection.
        Places a Dynatrace request tag on a HttpURLConnection web request.

        This tag is evaluated by the corresponding web server agent. The Dynatrace server will link the server-side PurePath data with this mobile user action.

        Since there is no explicit action, the web request is correlated to an action according to the following rule:

        1. If there is an open action in the current thread at the time the request is tagged, the web request is assigned (by the mobile agent) to the open action.
        2. If there is no open action in the current thread, the web request is assigned (by the Dynatrace Server) to an action that calls its leaveAction() method in the same thread where the tagging is done. The tagging time must fall between the action enter and leave times.
        3. If neither of the preceding cases apply, the web request is not assigned to any action. In this case the server-side PurePath data is not linked to the mobile user action (but it can be identified as mobile traffic in the transaction flow).
        Parameters:
        conn - the request tag will be added as header to this connection
        See Also:
        DTXAction.tagRequest(HttpURLConnection)

      • endVisit

        public static void endVisit()
        Can be called to end the current visit and start a new visit.

        All current actions are closed and sent to the server.

      • reportError

        public static void reportError​(String errorName,
                               int errorCode)
        Reports an error with a specified name and error code.

        If given errorName is null or an empty String then no event is reported to the system. The error is reported as root action.

        Parameters:
        errorName - name of this error
        errorCode - numeric error code of this error
        See Also:
        DTXAction.reportError(String, int)

      • reportError

        public static void reportError​(String errorName,
                               Throwable throwable)
        Reports an error with a specified name and a Throwable.

        If given errorName is null or an empty string then no event is reported to the system. The error is reported as root action.

        Parameters:
        errorName - name of this error
        throwable - Throwable causing this error
        See Also:
        DTXAction.reportError(String, Throwable)

      • flushEvents

        public static void flushEvents()
        Call this function to flush all collected events immediately.

        To reduce network chatter, the collected events are usually sent in packages where the oldest event has an age of up to 2 minutes (the default; the maximum age can be configured). Using this function, you can force sending of all collected events regardless of their age.

      • setBeaconHeaders

        public static void setBeaconHeaders​(Map<String,​String> headers)
        Puts a set of http headers on every agent http request.

        For example: adding an Authorization header. It also triggers the agent to reconnect to the beacon endpoint with the new headers. To clear the previous headers, call the method with a null or empty value.

        Parameters:
        headers - a set of http headers
        See Also:
        ConfigurationBuilder.withCommunicationProblemListener(CommunicationProblemListener)

      • identifyUser

        public static void identifyUser​(String userId)
        The current visit/session will be tagged with the provided user id.

        The value will not be stored and has to be renewed for every new session.

        Parameters:
        userId - a unique id that allows you to identify the current user. If userId is null or empty, then the user tag will be removed from the session.

      • identifyUser

        @Deprecated
public static void identifyUser​(String userId,
                                DTXAction parentAction)
        Deprecated.
        As of version 8.215, use identifyUser(String) instead
        The current visit/session will be tagged with the provided user id.

        The value will not be stored and has to be renewed on every agent startup.

        Parameters:
        userId - a unique id that allows you to identify the current user. If userId is null or empty, then the user tag will be removed from the session.
        parentAction - The parent action for the user identify event

      • applyUserPrivacyOptions

        public static void applyUserPrivacyOptions​(UserPrivacyOptions userPrivacyOptions)
        Creates a new session with the specified privacy settings and stores the privacy settings for future sessions.

        This method can only be used, when user opt-in feature is enabled. This method call has no effect if the given privacy settings are identical to the previously specified privacy settings.

        Parameters:
        userPrivacyOptions - the new privacy settings from the user
        Since:
        8.191
        See Also:
        ConfigurationBuilder.withUserOptIn(boolean)

      • isCrashReportingOptedIn

        @Deprecated
public static boolean isCrashReportingOptedIn()
        Deprecated.
        As of version 8.191, replaced by getUserPrivacyOptions()
        Returns the current privacy setting for crash reporting.

        This method will always return true, when the user opt-in feature is not used.

        Returns:
        current privacy setting for crash reporting
        Throws:
        IllegalStateException - if the agent is not started

      • modifyUserAction

        public static void modifyUserAction​(UserActionModifier modifier)
        Allows to modify the currently pending user action.

        If there is no user action pending or if it is already closed upon modification, no modification takes place.

        Parameters:
        modifier - modifications that should be applied to the newly created user action
        Since:
        8.189

      • instrumentWebView

        public static void instrumentWebView​(WebView webView)
        Instruments the given WebView to allow communication between the RUM JavaScript tag and OneAgent for Android.

        For hybrid apps with the RUM JavaScript tag inside a WebView, it is required to execute this method for every WebView that contains the RUM JavaScript tag. Without this method call it can't be ensured that the monitoring data will be combined into same session.

        Parameters:
        webView - the web view that should be instrumented
        Since:
        8.191
        See Also:
        ConfigurationBuilder.withHybridMonitoring(boolean)

      • sendBizEvent

        public static void sendBizEvent​(String type,
                                JSONObject attributes)
        Send a Business Event.

        With sendBizEvent, you can report a business event. These standalone events are being sent detached from user actions or sessions. The 'dt' key, as well as all 'dt.' prefixed keys are considered reserved by Dynatrace and will be stripped from the passed in attributes.

        Note: Business events are only supported on Dynatrace SaaS deployments currently.

        Parameters:
        type - event type that is neither null or empty
        attributes - a non null JSON object
        Since:
        8.243