feat(winston): Add customLevelMap for winston transport

[JPeer264]

closes #18868
closes JS-1498

ATM it is not possible to map custom levels to OpenTelemetry levels. The option customLevelMap has been added to make this possible. Which means that custom levels would have never been send to Sentry, as they were not mapped correctly.

Now when there are custom levels it can be used like this:

const customLevels = {
  levels: {
    customCritical: 0,
    customNotice: 2,
  },
};

const SentryWinstonTransport = Sentry.createSentryWinstonTransport(Transport, {
  customLevelMap: {
    customCritical: 'fatal',
    customNotice: 'info',
  },
});

const mappedLogger = winston.createLogger({
  levels: customLevels.levels,
  level: 'customNotice', // this needs to be added due to https://github.com/winstonjs/winston/issues/1491
  transports: [new SentryWinstonTransport()],
});

Merge checklist

• Sentry Docs update issue has been created

[linear]

JS-1498 Allow customization of level mapping in `createSentryWinstonTransport`

[github-actions]

node-overhead report 🧳

Note: This is a synthetic benchmark with a minimal express app and does not necessarily reflect the real-world performance impact in an application.
⚠️ Warning: Base artifact is not the latest one, because the latest workflow run is not done yet. This may lead to incorrect results. Try to re-run all tests to get up to date results.

Scenario	Requests/s	% of Baseline	Prev. Requests/s	Change %
GET Baseline	8,675	-	8,786	-1%
GET With Sentry	1,623	19%	1,657	-2%
GET With Sentry (error only)	6,045	70%	5,978	+1%
POST Baseline	1,207	-	1,181	+2%
POST With Sentry	592	49%	583	+2%
POST With Sentry (error only)	1,056	87%	1,039	+2%
MYSQL Baseline	3,221	-	3,229	-0%
MYSQL With Sentry	459	14%	422	+9%
MYSQL With Sentry (error only)	2,622	81%	2,665	-2%

View base workflow run

[s1gr1d]

Looks good, but I am wondering if we can auto-detect those levels so users don't have to manually add them 🤔

[nicohrubec]

m: would it make sense to warn the user in case he provides a sentry level that does not exist?

[JPeer264]

That could actually make sense

[JPeer264]

@nicohrubec I added a debug warning now. This is however only then when levels are overwritten. In all other cases they will default to info already

[JPeer264]

I am wondering if we can auto-detect those levels so users don't have to manually add them 🤔

That shouldn't be a problem. The main problem is what it should get mapped to. myCustomLevel would be impossible for us to identify if this is an error or info

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[nicohrubec]

nice