Sending logs

This topic explains how to send logs through the SDK observability plugin.

Overview

The observability plugin automatically sends logs to LaunchDarkly. You can also use recordLog to manually create and send a log record.

You can view all logs sent to LaunchDarkly under Logs in the LaunchDarkly user interface. To learn more, read Logs.

Details about each SDK’s configuration are available in the SDK-specific sections below:

• Client-side SDKs
• Server-side SDKs

Client-side SDKs

This feature is available in the observability plugin for the following client-side SDKs:

• iOS
• Android
• JavaScript
• React Native
• React Web
• Vue

iOS

Expand iOS code sample

You can use recordLog to manually send a custom error:

Record log

      LDObserve.shared.recordLog(message: message, severity: .info, attributes: attributes)

To learn more, read recordLog.

Android

Expand Android code sample

Use recordLog to manually create and send a log record:

Record log

      LDObserve.recordLog("Example log message", Severity.DEBUG, attributes)

The attributes argument is optional. To construct it, use Attributes from the @opentelemetry/api.

Java

Script

Expand JavaScript code sample

Use recordLog to manually create and send a log record:

Record log

      LDObserve.recordLog('Example log message', Severity.DEBUG);

To learn more, read recordLog.

React Native

Expand React Native code sample

Use recordLog to manually create and send a log record:

Record log

      LDObserve.recordLog('Example log message', Severity.DEBUG, attributes);

The attributes argument is optional. To construct it, use Attributes from the @opentelemetry/api. To learn more, read recordLog.

React Web

To send a log record with the React Web SDK, follow the example for JavaScript.

Vue

To send a log record with the Vue SDK, follow the example for JavaScript.

Server-side SDKs

This feature is available in the observability plugin for the following server-side SDKs:

• .NET (server-side)
• Go
• Node.js (server-side)
• Python

.NET (server-side)

Expand .NET (server-side) code sample

Use RecordLog to manually create and send a log record.

Here’s how:

Record log

      Observe.RecordLog(message, loglevel, attributes)

You can optionally pass an array of attributes, which may include any attributes. We recommend using attributes from the OpenTelemetry specification. To learn more, read RecordLog.

Go

Expand Go code sample

Use RecordLog to manually create and record a log record. The log is recorded with LaunchDarkly, but is not sent to other log handlers.

Here’s how:

Record log

      ldobserve.RecordLog(ctx, LogRecord)

The Go context.Context and log record should be specific to this request. You can optionally pass an array of attributes from the OpenTelemetry specification. To learn more, read RecordLog.

Node.js (server-side)

Expand Node.js (server-side) code sample

Use recordLog to manually create and send a log record.

Here’s how:

Record log

      LDObserve.recordLog(
        message,
        level,
        secureSessionId,
        requestId,
        metadata
      });

The recordLog method automatically provides context propagation, so you can leave the secureSessionId and requestId undefined. Alternatively, you have the option to set their values, to assist with the context propagation. You can parse values for secureSessionId and requestId from the incoming request using LDObserve.parseHeaders().

Python

Expand Python code sample

Use record_log to manually create and send a log record. The log is recorded with LaunchDarkly, but is not sent to other log handlers.

Here’s how:

Record log

      observe.record_log("log message", logging.INFO)

The message to record and log level should be specific to this request. You can optionally pass an array of additional Attributes, which may include any attributes from the OpenTelemetry specification. To learn more, read record_log.