OpenTelemetry Logs SDK

Note: This is an experimental package under active development. New releases may include breaking changes.

OpenTelemetry logs module contains the foundation for all logs SDKs of opentelemetry-js.

Used standalone, this module provides methods for manual instrumentation of code, offering full control over recording logs for client-side JavaScript (browser) and Node.js.

It does not provide automated instrumentation of known libraries or host environment logs out-of-the-box.

Installation

1npm install --save @opentelemetry/api-logs
2npm install --save @opentelemetry/sdk-logs

Usage

The basic setup of the SDK can be seen as followings:

1const logsAPI = require('@opentelemetry/api-logs');
2const {
3  LoggerProvider,
4  SimpleLogRecordProcessor,
5  ConsoleLogRecordExporter,
6} = require('@opentelemetry/sdk-logs');
7
8// To start a logger, you first need to initialize the Logger provider.
9// and add a processor to export log record
10const loggerProvider = new LoggerProvider({
11  processors: [new SimpleLogRecordProcessor(new ConsoleLogRecordExporter())]
12});
13
14//  To create a log record, you first need to get a Logger instance
15const logger = loggerProvider.getLogger('default');
16
17// You can also use global singleton
18logsAPI.logs.setGlobalLoggerProvider(loggerProvider);
19const logger = logsAPI.logs.getLogger('default');
20
21// emit a log record
22logger.emit({
23  severityNumber: logsAPI.SeverityNumber.INFO,
24  severityText: 'INFO',
25  body: 'this is a log record body',
26  attributes: { 'log.type': 'LogRecord' },
27});

Config

Logs configuration is a merge of both the user supplied configuration and the default configuration as specified in config.ts

Example

See examples/logs

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us in GitHub Discussions

License

Apache 2.0 - See LICENSE for more information.