Modrinth · Fabric, Forge, NeoForge, Quilt · Client mod

Async Logger

Async Logger is a client-side mod. Install it on your computer; the server does not need it.

Asynchronous logging and efficient filtering - performance improvements and utility for keeping your logs clean

Downloads
2.7M
Author
decce6
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
1.0 – 26.3
Updated
–

Setup

Install Async Logger on your client

Client-side mods only run on your computer. More server RAM does not change their performance.

  1. 01

    Install the loader locally

    Install Fabric or Forge or NeoForge or Quilt for your Minecraft version in your launcher.

  2. 02

    Download the file

    Download the Async Logger file for your loader and your exact Minecraft version, for example 26.3-snapshot-5.

  3. 03

    Add it to the mods folder

    Put the .jar file in your local .minecraft/mods folder and remove older duplicates.

  4. 04

    Launch

    Launch Minecraft with the loader profile. Nothing needs to change on the server.

On the server
Not needed
On the client
Required
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
26.3-snapshot-5, 26.3-snapshot-4, 26.3-snapshot-3 +95 more
License
GNU Lesser General Public License v3.0 only

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

Async Logger · Modrinth
Original description by the project author

Async Logger is a Minecraft mod that makes logging operations asynchronous.

In vanilla, loggers are not asynchronous. This means the actual logging operations, including I/O operations, happen on the logging thread. This mod changes logging to be asynchronous for better performance.

This can be especially useful when large amounts of messages are being logged and/or debug logging is enabled (default on Forge / NeoForge).

Benchmarks

Item Vanilla AsyncLogger
Simple Messages (10k) 6146.1ms 141.2ms
Messages with Placeholders (10k) 6413.2ms 96.6ms
Messages with Throwable (1.5k) 19572.4ms 9.0ms

You can do these tests yourself by enabling testPerformance in the config. When this option is enabled, the mod will log a large number of messages both before and after setting up async loggers. You can see the test results in the log.

Filtering

Starting from version 2.0.0, AsyncLogger supports log filtering. The filtering happens on the dedicated, async logger thread, ensuring there is no overhead for the caller.

To use, simply set filtering.enabled to true in the config, and edit one or more of the filters. Filtering by logger name, level, and message (match substring or regexps) is supported.

Technical Details

  • Asynchronous loggers are used, in favor of Asynchronous appenders. The former is newer, faster and lighter on allocation rate.
    • Asynchronous loggers require LMAX Disruptor, a lock-free inter-thread communication library. The mod will load the library onto the system classloader when it is not present. This mod redistributes LMAX Disruptor under the Apache-2.0 License.
  • The config file allows easy control of some log4j2 settings.
  • System.out and System.err can be redirected to loggers.

FAQ

Async Logger questions

Question not listed? Ask our team.

Does Async Logger need to be installed on the Minecraft server?

No. Modrinth marks Async Logger as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.

Which version and loader does Async Logger require?

Use a file for Fabric, Forge, NeoForge, Quilt and your exact Minecraft version. Supported versions include 26.3-snapshot-5, 26.3-snapshot-4, 26.3-snapshot-3. Files for different loaders are not interchangeable.

Async Logger is not working – what should I check?

First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.

Looking for mods for your own server?

The catalog lists mods that run on Minecraft servers.

Browse all mods