Context-based server-side logging solution for ROBLOX projects.
import { rLog } from "@rbxts/rlog";
const logger = new rLog();
logger.debug("User purchase made", {
user: {
id: 123,
purchase: {
id: 15,
details: {
item: "Nuke",
result: Enum.ProductPurchaseDecision.PurchaseGranted,
position: new Vector3(10, 15, 20),
rotation: new CFrame(),
},
},
},
});
Install rLog with your preferred package manager.
npm install @rbxts/rlogpnpm add @rbxts/rlogyarn add @rbxts/rlogrLog is a Context-based server-side logging framework for ROBLOX, designed to help organize and structure your logging process.
Utilizing Correlation IDs via rLog's LogContext, you can create logging infrastructure that mirrors more enterprise-like systems; facilitating easier debugging and external auditing.
- Log data to the console according to different severity levels.
- Utilize tags (or prefixes) for individual logging instances.
- Attach data to your log entries that gets serialized before being sent; ensuring the data is properly visible.
- Support for deeply nested roblox data types that don't typically translate well (e.g., CFrames).
- Support for encoding custom classes and functions.
- Customizable class serialization.
- Attach Correlation IDs to your logs, creating a linkage between logs in individual flows.
- Differiate between multiple of the same log in the same function.
- Automatically generate unique IDs when needed.
- Optionally configure a custom method for providing your own ID generation.
- Share configuration settings between context consumers, optionally unique to each invocation.
- Optionally "suspend" logs until they're needed (i.e., a
WARNINGorERRORoccurs.); facilitating verbose logs for easier debugging without taking up resources until they're needed.
- Attach data to your logs to identify which file the log was sent from.
- Attach data to your logs to identify what line number in the file the log was sent from.
- Attach data to your logs to identify which function the log was sent from, or optionally the nearest named function on the stack (in the case of anonymous functions).
- In the case of anonymous functions, identify the nearest named function from where the log was sent.
Tip
rLog provides an in-house sink for sending logs to the Google Cloud Logging platform.
Learn more about it by giving the Using rLog with Google Cloud Logging guide a read!
- Define callbacks that can conditionally decide to filter logs from reaching any output.
- Define callbacks that can send logs to external services for storage and auditing.
- Recursively define callbacks through a hierarchy of logger instances and configurations; allowing you to provide callbacks for individual flows.
- Define dynamic callbacks that change according to arguments (e.g., the player).
- Define callbacks that can conditionally mutate or add data to logs.
- Recursively define callbacks through a hierarchy of logger instances and configurations; allowing you to provide callbacks for individual flows.
- Define dynamic callbacks that change according to arguments (e.g., the type of data being sent).
- Extensive configuration options for toggling various serialization settings, and overriding encoding behavior when needed.
- Optionally configure the minimum log level that gets output to the console.
- Optionally provide custom methods for formatting data in the roblox console, or directing how it reaches the console.
So you're ready to get started with rLog!
You can either checkout our Quick Start guide, read through our list of Basic Guides, or jump straight into our API Reference.
Tip
If you're already familiar with logging libraries, you can give our Fast Breakdown a read to get a quick overview of what rLog provides, and where it differs from others.
- Add publishing for wally
- Add docs for lua usage
- Separate provided sinks into a sub package
- Support google cloud console logging
- Migrate tests to individual files
- Implement workflow for test coverage
- Implement tests for provided workflows
- Implement more refined serialization/assertions lib
- Add workflow for checking API diff and version bumping according to semver
- Add note in contributing about checking the api diff
If you're interested in contributing to rLog, give the CONTRIBUTING doc a read.