How do I integrate BqLog with Unity?

BqLog provides a Unity plugin detailed in the Game Engine Integration Guide, including blueprint support and editor redirection for easy setup in game projects.

Is BqLog faster than spdlog or Log4j2?

Yes, benchmarks show BqLog is about 3x faster than Log4j2 for text logs and over 10x faster for compressed logs, though spdlog comparisons aren't provided in the README.

Can I read BqLog compressed logs without decryption?

No, the compressed file appender outputs encrypted logs that require decryption tools provided in the Advanced Usage documentation for readability.

What happens if my app crashes with BqLog?

BqLog's asynchronous logging includes crash recovery features to minimize data loss, with recovery mechanisms promoted to stable in version 2.x.

Does BqLog support custom log formats?

It supports C++20 std::format style strings without positional indexes, and allows custom parameter types via extensions, but full format customization is limited compared to some libraries.

BqLog or Log4j2 for a Java backend?

Choose BqLog for high-performance, multi-language environments where speed is critical; stick with Log4j2 if you need a mature Java-only ecosystem with extensive community plugins.

BqLog

NOASSERTIONC++Release_2.7.1

A lightweight, high-performance, industrial-grade logging library for C++, Java, C#, Python, TypeScript, and game engines, battle-tested in Honor of Kings.

GitHub

707 stars59 forks0 contributors

What is BqLog?

BqLog is a lightweight, high-performance logging library developed by Tencent and battle-tested in large-scale online projects like Honor of Kings. It provides a unified logging solution across multiple programming languages and platforms, solving performance and storage challenges in high-concurrency environments.

Target Audience

Developers building performance-critical applications, especially in gaming (Unity/Unreal), mobile (Android/iOS/HarmonyOS), and server-side systems requiring efficient, cross-language logging.

Value Proposition

Developers choose BqLog for its exceptional speed (3–10x faster than alternatives like Log4j2), low memory footprint, built-in log compression/encryption, and seamless multi-language support within a single process.

Overview

A lightweight, high-performance, industrial-grade cross-language logging library (C++/Java/C#/Kotlin/TS/Python/Go), battle-tested in Honor of Kings.

Use Cases

Best For

High-performance game logging in Unity or Unreal Engine

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

Server-side applications requiring low-latency logging under high concurrency

Cross-platform mobile apps (iOS, Android, HarmonyOS) needing efficient logging

Multi-language projects (e.g., C++ backend with Java/Python services) wanting unified logging

Applications with strict storage constraints needing compressed logs

Scenarios requiring encrypted log files for security compliance

Not Ideal For

Projects requiring immediate, plain-text log readability without additional decryption tools
Teams deeply embedded in mature logging ecosystems like Logback for Java or Winston for Node.js where migration effort outweighs performance gains
Small-scale applications with minimal logging needs where the overhead of a high-performance system is unnecessary

Pros & Cons

Pros

Blazing Fast Performance

Benchmarks show BqLog is 3–10 times faster than Log4j2 in high-concurrency tests, with memory usage as low as 1 MB for 20 million log entries.

Unified Multi-Language API

Provides a consistent logging interface across C++, Java, C#, Python, and more, allowing different language wrappers to access the same log object within a process.

Built-in Compression & Encryption

Offers high-compression real-time log format with optional hybrid encryption that has minimal performance overhead, addressing storage and security needs directly.

Robust Crash Recovery

Asynchronous logging is designed to avoid data loss and supports recovery from application crashes, ensuring log integrity in unstable environments.

Cons

Compressed Logs Unreadable

The high-performance compressed file appender outputs logs that are not human-readable without decryption, complicating quick debugging and requiring extra tools.

Steep Integration Curve

Requires CMake-based builds and platform-specific integration steps, as noted in the separate integration guides, which can be cumbersome compared to drop-in logging libraries.

Breaking Changes Between Versions

Version 2.x deprecated features like the raw_file appender and introduced configuration changes, potentially disrupting upgrades for existing users.

Frequently Asked Questions

Home

C/C++

spdlog

Fast C++ logging library.

Stars29,698

Forks5,338

Last commit7 days ago

glog

C++ implementation of the Google logging module

Stars7,377

Forks2,187

Last commit1 year ago

Easylogging++

C++ logging library. It is powerful, supports asynchronous low latency, extendable, light-weight, fast performing, thread and type safe and consists of many built-in features. It provides ability to write logs in your own customized format. It also provide support for logging your classes, third-party libraries, STL and third-party containers etc.

Stars3,933

Forks942

Last commit1 year ago