Skip to main content

Logging

In this section we will learn to use DBOS's built-in logging system. The DBOS runtime comes with a global logger you can access through any operation's context.

Usage​

@GetApi('/greeting/:name')
static async greetingEndpoint(ctx: HandlerContext, @ArgSource(ArgSources.URL) name: string) {
    ctx.logger.info("Logging from the greeting handler");
    return `Greeting, ${name}`;
}

The logger provides four logging levels: info(), debug(), warn() and error(). Each accepts and logs any output that can be serialized to JSON. error() additionally logs a stack trace.

Viewing Logs in DBOS Cloud​

You can view your applications' logs in DBOS Cloud through our monitoring dashboard. It allows you to filter for particular applications or time ranges.

You can also retrieve logs through the app logs command. In your package root directory, run:

npx dbos-cloud app logs

Configuration​

In the configuration file, you can configure the logging level, silence the logger, and request to add context metadata to log entries:

...
telemetry:
  logs:
    logLevel: 'info' # info (default) | debug | warn | emerg | alert | crit | error
    addContextMetadata: 'true' # true (default) | false
    silent: 'false' # false (default) | true

Context metadata includes the workflow identity UUID and the name of the user running the workflow.

You can also configure the logging level as a CLI argument to the runtime:

npx dbos start --loglevel debug