granny / JDAAppender

Library for Java applications that use JDA to easily stream the logging output to a text channel on Discord

JDA Appender

Library for Java applications that use JDA to easily stream the logging output of the application to a text channel on Discord.

[insert screenshot here]

Usage

Using default values:

ChannelLoggingHandler handler = new ChannelLoggingHandler(() -> jda.getTextChannelById(System.getenv("CHANNEL")))
        .attach() // attach to SLF4J JDK logging if present, else Log4j if present, else standard out/err
        .schedule(); // schedule handler to flush output asynchronously every 1.5 seconds

Customizing config values, such as adding a logger name mapping:

ChannelLoggingHandler handler = new ChannelLoggingHandler(() -> jda.getTextChannelById(System.getenv("CHANNEL")), config -> {
    config.setColored(true); // enable coloring of different log levels, default true
    config.setSplitCodeBlockForLinks(false); // split the output code blocks when a link is present, default false
    config.setAllowLinkEmbeds(true); // when splitting code blocks for links, allow the links to have an embed, default true
    config.mapLoggerName("net.dv8tion.jda", "JDA"); // add a mapping for logger names "net.dv8tion.jda*" to just be "JDA"
}).attach().schedule();

Artifact

<repository>
    <id>scarsz</id>
    <url>https://nexus.scarsz.me/content/repositories/releases/</url>
</repository>

<!-- JDA 5 -->
<dependency>
    <groupId>me.scarsz.jdaappender</groupId>
    <artifactId>jda5</artifactId>
    <version>1.2.0</version>
</dependency>

    or

<!-- JDA 4 -->
<dependency>
    <groupId>me.scarsz.jdaappender</groupId>
    <artifactId>jda4</artifactId>
    <version>1.2.0</version>
</dependency>

Using with SLF4J-backed apps with minimal effort (JDA, ...)

Use slf4j-jdk14 as your SLF4J logging backend. This will forward SLF4J messages to java.util.logging and can be picked up by JDAAppender with ChannelLoggingHandler#attachJavaLogging.

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-jdk14</artifactId>
    <version>1.7.31</version>
</dependency>