Dynatrace Generic Log Ingest Log4j2 Appender

Log4j2 Appender & Lookup to integrate Java applications with Dynatrace Generic Log Ingest functionality.

Last stable version: 0.0.7

To make it works you have to provide two parameters:

• activeGateUrl - URL to ActiveGate instance with Generic Log Ingest module enabled
• token - valid token with Log Import permission enabled
• sslValidation - SSL certificate has to be valid. false value will pass self-signed certificates. (OPTIONAL)

DynatraceLookup is used to lookup entity attributes used internally by the Dynatrace. Attributes can be accessed with prefix ${dt:} in the configuration.

OpenTelemetryLookup is used to lookup thread-local contextual information delivered by OpenTelemetry Instrumentation for Java. Attributes can be accessed with prefix ${otel:} in the configuration.

Requirements

• Log4j2 version >= 2.12.0
• for DynatraceLookup Dynatrace OneAgent 1.215 and newer is needed
• for OpenTelemetryLookup OpenTelemetry Instrumentation for Java is needed

How to use it:

Gradle

repositories {
    mavenCentral()
}

dependencies {
    compileOnly group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.14.0'
    compile group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.14.0'

    runtimeOnly group: 'io.github.michaljonko', name: 'dynatrace-log4j2-appender', version: '0.0.7'
    runtimeOnly group: 'org.apache.logging.log4j', name: 'log4j-slf4j-impl', version: '2.14.0'
}

Maven

<dependency>
    <groupId>io.github.michaljonko</groupId>
    <artifactId>dynatrace-log4j2-appender</artifactId>
    <version>0.0.7</version>
    <type>pom</type>
</dependency>

Examples

Simple configuration with defined layout for a message (will be shown as content in Dynatrace Log Viewer):

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
    <Appenders>
        <DynatraceGenericLogIngestAppender name="myAppender" 
                activeGateUrl="https://{ACTIVE_GATE_URL}/api/v2/logs/ingest"
                token="{TOKEN_WITH_LOG_IMPORT_PERMISSION}"
                sslValidation="false">
            <PatternLayout pattern="%d{yyyy.MM.dd HH:mm:ss.SSS} [%t] %-5level %logger - %msg"/>
        </DynatraceGenericLogIngestAppender>
        <Console name="console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{yyyy.MM.dd HH:mm:ss.SSS} [%t] %-5level %logger{1.} - %msg%n"/>
        </Console>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="console"/>
            <AppenderRef ref="myAppender"/>
        </Root>
    </Loggers>
</Configuration>

Simple configuration with three additional attributes (will be part of the log) and custom layout for a message:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
    <Appenders>
        <DynatraceGenericLogIngestAppender name="myAppender"
                activeGateUrl="https://{ACTIVE_GATE_URL}/api/v2/logs/ingest"
                token="{TOKEN_WITH_LOG_IMPORT_PERMISSION}">
            <Property name="service.name">Log4j2 Appender Tester</Property>
            <Property name="dt.os.type">${java:os}</Property>
            <Property name="dt.logpath">${sys:user.dir}/debug.log</Property>
            <PatternLayout pattern="[%t] %-5level %logger - %msg"/>
        </DynatraceGenericLogIngestAppender>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="myAppender"/>
        </Root>
    </Loggers>
</Configuration>

Simple configuration with three additional attributes, lookup attributes from DynatraceLookup and custom layout for a message:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
    <Appenders>
        <DynatraceGenericLogIngestAppender name="myAppender"
                activeGateUrl="https://{ACTIVE_GATE_URL}/api/v2/logs/ingest"
                token="{TOKEN_WITH_LOG_IMPORT_PERMISSION}">
            <Property name="service.name">Log4j2 Appender Tester</Property>
            <Property name="dt.os.type">${java:os}</Property>
            <Property name="log.source">${sys:user.dir}/debug.log</Property>
            <Property name="dt.entity.process_group_instance">${dt:dt.entity.process_group_instance}</Property>
            <Property name="dt.entity.host">${dt:dt.entity.host}</Property>
            <PatternLayout pattern="[%t] %-5level %logger - %msg"/>
        </DynatraceGenericLogIngestAppender>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="myAppender"/>
        </Root>
    </Loggers>
</Configuration>

Simple configuration with three additional attributes, lookup attribute from DynatraceLookup, lookup attribute from OpenTelemetryLookup and custom layout for a message:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
    <Appenders>
        <DynatraceGenericLogIngestAppender name="myAppender"
                activeGateUrl="https://{ACTIVE_GATE_URL}/api/v2/logs/ingest"
                token="{TOKEN_WITH_LOG_IMPORT_PERMISSION}">
            <Property name="service.name">Log4j2 Appender Tester</Property>
            <Property name="dt.os.type">${java:os}</Property>
            <Property name="log.source">${sys:user.dir}/debug.log</Property>
            <Property name="dt.entity.process_group_instance">${dt:dt.entity.process_group_instance}</Property>
            <Property name="dt.http.application_id">${otel:trace_id}</Property>
            <PatternLayout pattern="[%t] [%X{trace_id}]%-5level %logger - %msg"/>
        </DynatraceGenericLogIngestAppender>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="myAppender"/>
        </Root>
    </Loggers>
</Configuration>