1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-11-01 19:07:38 +01:00
unleash.unleash/website/docs/contributing/ADRs/overarching/logging.md
Christopher Kolstad 7f5d3df59c
docs: add ADR for logging with error object (#6249)
I've held an internal knowledge sharing session on this already. If
someone can think of a better phrasing for the background, I'm all ears.
I think it's just nice to have this documented, so people remember that
our logging framework already has a good way to format errors when you
use the API `logger.error("<message>", e)`
2024-02-20 13:41:33 +00:00

854 B

title
ADR: Logging errors

Background

After debugging multiple errors over the last few years, we've consistently found that when something goes wrong, we would like as much context as possible to debug faster.

Decision

When we log at the error level, we should give the person debugging as much information as possible. As such, please include the error as a second argument to logger.error. This will include the stacktrace in the log message and make it a lot easier to figure out where the error is coming from

Change

Previously

function errors() {
    try {
    } catch (e) {
        this.logger.error(`Something went wrong {$e}`);
    }
}

to

function errors() {
    try {
    } catch (e) {
        this.logger.error('Something went wrong', e);
    }
}