Package com.dynatrace.agent.api

Class ExceptionEventData

java.lang.Object
com.dynatrace.agent.api.ExceptionEventData
public final class ExceptionEventData extends Object
Holds the configuration for an exception event to be sent via the Dynatrace#sendExceptionEvent.

Configure the event by providing the required Throwable and any optional user event properties. A null throwable will cause the event to be discarded. User event properties must have keys prefixed with "event_properties.". Any property without this prefix will be dropped.

OneAgent will verify the reported monitoring data based on the Semantic Dictionary. Invalid fields will be removed and invalid events will be dropped.

Example (Kotlin) 

 catch(exception: Exception) {
     Dynatrace.sendExceptionEvent(
         ExceptionEventData(exception)
             .addEventProperty("event_properties.userId", "12345")
     )
 }
Since:
8.329

  • Constructor Details

    • ExceptionEventData

      public ExceptionEventData(Throwable throwable)
      Creates a new exception event configuration to be sent via Dynatrace#sendExceptionEvent.
      Parameters:
      throwable - the Throwable causing this exception. If null is passed instead, the event cannot be generated and will be discarded.

  • Method Details

    • addEventProperty

      public ExceptionEventData addEventProperty(String key, String value)
      Adds a user event property with a String value.
      Parameters:
      key - name of the event property. Has to start with "event_properties." or it will be dropped
      value - property value
      Returns:
      this instance for chaining

    • addEventProperty

      public ExceptionEventData addEventProperty(String key, int value)
      Adds a user event property with an Integer value.
      Parameters:
      key - name of the event property. Has to start with "event_properties." or it will be dropped
      value - property value
      Returns:
      this instance for chaining

    • addEventProperty

      public ExceptionEventData addEventProperty(String key, long value)
      Adds a user event property with a Long value.
      Parameters:
      key - name of the event property. Has to start with "event_properties." or it will be dropped
      value - property value
      Returns:
      this instance for chaining

    • addEventProperty

      public ExceptionEventData addEventProperty(String key, double value)
      Adds a user event property with a Double value.

      Note: Double.NaN, Double.POSITIVE_INFINITY or Double.NEGATIVE_INFINITY are not allowed and will be dropped

      Parameters:
      key - name of the event property. Has to start with "event_properties." or it will be dropped
      value - property value
      Returns:
      this instance for chaining

    • addEventProperty

      public ExceptionEventData addEventProperty(String key, boolean value)
      Adds a user event property with a Boolean value.
      Parameters:
      key - name of the event property. Has to start with "event_properties." or it will be dropped
      value - property value
      Returns:
      this instance for chaining