• Home
  • How to use Dynatrace
  • Log Monitoring
  • Log ingest & process
  • Log processing
  • Log processing data types

Log processing data types

The script in a processor definition operates with strongly typed data: the functions and operators accept only declared types of data. The type is assigned to all input fields defined by the USING command as well as to the variables created while parsing or using the casting functions.

Whatever type has a field that is a part of the processor output, the system makes its best effort to convert it to a type expected by the event. The same applies to the input fields defined by the USING command. For example, a STRING attribute with the value 123 can be easily converted to the INTEGER type, but not to the BOOLEAN type.

Data types supported by the USING command (processor input/output):

Data typeDescription
BOOLEANHas only two possible values: true and false.
INTEGERA 32-bit signed two's complement integer that has a minimum value of -2^31 and a maximum value of 2^31-1.
LONGA 64-bit two's complement integer. The signed long has a minimum value of -2^63 and a maximum value of 2^63-1.
DOUBLEA double-precision 64-bit IEEE 754 floating point. The range of its values is beyond the scope of this discussion, but is specified in the Floating-Point Types, Formats, and Values section of the Java Language Specification.
DURATIONA time period in nanoseconds.
STRINGA sequence of characters with a specified character set.
TIMESTAMPA reference to a point in time with a precision of nanoseconds.
IPADDRRepresents an IPv4 or IPv6 address.

Additionally, within the processor script itself, more data types may appear after parsing:

Data typeDescription
BYTESAn sequence of bytes.
TUPLEA set of key-value pair data whose value can be any of supported data types.
VARIANTA data type evaluated dynamically at runtime. VARIANT can represent any of the primitive data types.
VARIANT_ARRAYAn array of VARIANT type data.
VARIANT_OBJECTA set of key-value pairs with STRING type keys and VARIANT type values. VARIANT_OBJECT is created when parsing JSON objects.
Related topics
  • Log processing examples

    Example log processing scenarios.