@logwarden/logger

Official Logwarden logging client.

Install

npm install @logwarden/logger

Usage

import { Logwarden } from "@logwarden/logger";

const logger = new Logwarden("YOUR_API_KEY", {
  spaceId: "4568fe55-57ad-4eca-aff7-a752869573f5",
});

await logger.log("test", "type/error", new Error("Something failed"));
await logger.log("test", "log", "User signed in", { userId: "u_123" });

Constructor

new Logwarden(apiKey, options);

• apiKey (required): Logwarden API key
• options.spaceId (required): Space id
• options.baseUrl (optional): defaults to https://logwarden.net
• options.requestTimeoutMs (optional): defaults to 10000
• options.resolveChannelByName (optional): defaults to true

log(channel, level, value, metadata?)

• channel: channel name (default behavior) or channel id
• level: supports aliases like error, warn, info, debug, log, monitoring, and forms like type/error
• value: string, Error, or any serializable object
• metadata: optional extra metadata object

Required key permissions

• channels:view (for resolving channel names)
• channels:write (for posting logs)

If you pass channel ids and set resolveChannelByName: false, only channels:write is required.