AI langfuseobservability

AI langfuseobservability

Certified

Langfuse observability

OpenTelemetry export settings for Langfuse. Payload capture is disabled by default for security.

yaml
type: io.kestra.plugin.ai.domain.langfuseobservability
Installation

Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:

kestractl plugins get io.kestra.plugin:plugin-ai --compatible-for $KESTRA_VERSION

For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.

Properties

Capture output

If true, model output is exported under the span's output attributes. Defaults to false, since responses may carry sensitive data.

Capture prompt

If true, prompt content is exported under the span's input attributes. Defaults to false, since prompts may carry sensitive data.

Capture system message

If true, the system message is exported in the span metadata. Defaults to false.

Capture tool arguments

If true, the arguments passed to each tool are exported in tool execution events. Defaults to false.

Capture tool results

If true, the value each tool returned is exported in tool execution events. Defaults to false.

Langfuse OTLP endpoint

OTLP endpoint traces are exported to, which differs per Langfuse region or self-hosted install. Not set by default, in which case nothing is exported.

Environment

Deployment environment tagged on the exported traces, so production and staging traffic can be told apart. Not set by default.

Export timeout

Time allowed for the OpenTelemetry exporter's flush and shutdown operations before giving up. Defaults to PT5S; a zero or negative value falls back to that default.

Maximum payload characters

Length cap applied to every captured payload field, beyond which the value is truncated. Defaults to 2000; a value of 0 or less falls back to that default.

Langfuse public key

Public half of the Langfuse API key pair, sent as the basic-auth username. No default: required for export to work.

Release

Application version or release tagged on the exported traces, which helps correlate behavior changes with deployments. Not set by default.

Langfuse secret key

Secret half of the Langfuse API key pair, sent as the basic-auth password. Store it as a Kestra secret rather than inline. No default: required for export to work.

Service name

Value reported as the OpenTelemetry service.name resource attribute, used to group traces in the observability backend. Defaults to kestra-plugin-ai.