Struct LangfuseConfig 

pub struct LangfuseConfig {

    pub public_key: String,
    pub secret_key: String,
    pub base_url: String,
    pub timeout: Duration,
    pub flush_at: usize,
    pub flush_interval: Duration,
    pub sample_rate: f64,
    pub environment: Option<String>,
    pub release: Option<String>,
    pub debug: bool,
    pub tracing_enabled: bool,
    pub mask: Option<Arc<dyn Fn(Value) -> Value + Send + Sync>>,
    pub additional_headers: Option<HashMap<String, String>>,
    pub max_retries: usize,
    pub media_upload_thread_count: usize,
    pub io_capture_enabled: bool,
    pub should_export_span: Option<Arc<dyn Fn(&SpanData) -> bool + Send + Sync>>,
}

Configuration for the Langfuse client.

Supports construction via the builder pattern (LangfuseConfig::builder) or from environment variables (LangfuseConfig::from_env).

Fields

public_key: String

Langfuse public key (required).

secret_key: String

Langfuse secret key (required).

base_url: String

Langfuse API base URL. Defaults to https://cloud.langfuse.com.

timeout: Duration

HTTP request timeout. Defaults to 5 seconds.

flush_at: usize

Number of events to buffer before flushing. Defaults to 512.

flush_interval: Duration

Maximum interval between flushes. Defaults to 5 seconds.

sample_rate: f64

Sampling rate for traces (0.0–1.0). Defaults to 1.0 (100%).

environment: Option<String>

Optional environment tag for traces.

release: Option<String>

Optional release tag for traces.

debug: bool

Enable debug logging. Defaults to false.

tracing_enabled: bool

Enable tracing. Defaults to true.

mask: Option<Arc<dyn Fn(Value) -> Value + Send + Sync>>

Optional mask function applied to JSON values before storing as span attributes.

additional_headers: Option<HashMap<String, String>>

Optional additional HTTP headers sent with every request.

max_retries: usize

Maximum number of retries for HTTP requests. Defaults to 3.

media_upload_thread_count: usize

Number of threads for media uploads. Defaults to 4.

io_capture_enabled: bool

Whether I/O capture is enabled for the observe decorator. Defaults to true.

should_export_span: Option<Arc<dyn Fn(&SpanData) -> bool + Send + Sync>>

Optional filter function to decide whether a span should be exported.

Implementations

impl LangfuseConfig

pub fn builder() -> LangfuseConfigBuilder

Create a new builder for LangfuseConfig.

pub fn from_env() -> Result<LangfuseConfig, ConfigError>

Build configuration from environment variables.

Required env vars: LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY. Optional: LANGFUSE_BASE_URL, LANGFUSE_TIMEOUT, LANGFUSE_FLUSH_AT, LANGFUSE_FLUSH_INTERVAL, LANGFUSE_SAMPLE_RATE, LANGFUSE_TRACING_ENVIRONMENT, LANGFUSE_RELEASE, LANGFUSE_DEBUG, LANGFUSE_TRACING_ENABLED, LANGFUSE_MAX_RETRIES, LANGFUSE_MEDIA_UPLOAD_THREAD_COUNT, LANGFUSE_OBSERVE_DECORATOR_IO_CAPTURE_ENABLED.

pub fn basic_auth_header(&self) -> String

Generate the HTTP Basic Auth header value.

pub fn otel_endpoint(&self) -> String

Get the OTLP traces endpoint URL.

pub fn api_base_url(&self) -> String

Get the REST API base URL.

Trait Implementations

impl Clone for LangfuseConfig

fn clone(&self) -> LangfuseConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LangfuseConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.