Installation

Requirements

Java 11 or later. Works on any JDK distribution (Temurin, Corretto, Oracle, GraalVM, etc.).

Gradle (Kotlin DSL)

dependencies {
    implementation("ai.auralogs:auralogs-core:1.0.0")
    // Optional: SLF4J bridge captures logs from existing code and third-party libraries
    implementation("ai.auralogs:auralogs-slf4j:1.0.0")
}

Gradle (Groovy)

dependencies {
    implementation 'ai.auralogs:auralogs-core:1.0.0'
    implementation 'ai.auralogs:auralogs-slf4j:1.0.0'
}

Maven

<dependency>
    <groupId>ai.auralogs</groupId>
    <artifactId>auralogs-core</artifactId>
    <version>1.0.0</version>
</dependency>
<dependency>
    <groupId>ai.auralogs</groupId>
    <artifactId>auralogs-slf4j</artifactId>
    <version>1.0.0</version>
</dependency>

Initialize

import ai.auralogs.Auralogs;
import ai.auralogs.AuralogsConfig;

Auralogs.init(AuralogsConfig.builder()
    .apiKey(System.getenv("AURALOGS_API_KEY"))
    .environment("production")
    .build());

Auralogs.info("hello from auralogs");

The SDK batches log sends every 5 seconds (configurable) and automatically flushes pending logs on JVM exit via a shutdown hook. For deterministic flush (short-lived CLI apps, serverless):

Auralogs.shutdown();

Source

Open source at github.com/auralogs-ai/auralogs-java (MIT).