
AI langfuseobservability
CertifiedLangfuse observability
AI langfuseobservability
Langfuse observability
OpenTelemetry export settings for Langfuse. Payload capture is disabled by default for security.
type: io.kestra.plugin.ai.domain.langfuseobservabilityInstallation
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.
For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.
Properties
captureOutput booleanstring
Capture output
If true, model output is exported under the span's output attributes. Defaults to false, since responses may carry sensitive data.
capturePrompt booleanstring
Capture prompt
If true, prompt content is exported under the span's input attributes. Defaults to false, since prompts may carry sensitive data.
captureSystemMessage booleanstring
Capture system message
If true, the system message is exported in the span metadata. Defaults to false.
captureToolArguments booleanstring
Capture tool arguments
If true, the arguments passed to each tool are exported in tool execution events. Defaults to false.
captureToolResults booleanstring
Capture tool results
If true, the value each tool returned is exported in tool execution events. Defaults to false.
endpoint string
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 string
Environment
Deployment environment tagged on the exported traces, so production and staging traffic can be told apart. Not set by default.
exportTimeout string
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.
maxPayloadChars integerstring
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.
publicKey string
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 string
Release
Application version or release tagged on the exported traces, which helps correlate behavior changes with deployments. Not set by default.
secretKey string
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.
serviceName string
Service name
Value reported as the OpenTelemetry service.name resource attribute, used to group traces in the observability backend. Defaults to kestra-plugin-ai.