> ## Documentation Index
> Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# langfuse

> Per-agent tracing to our self-hosted Langfuse. Auto-provisioned: each agent gets its own Langfuse organization and project, so one agent's traces are…

# `langfuse` — Langfuse tracing

Per-agent tracing to our self-hosted Langfuse. Auto-provisioned: each agent gets its own Langfuse organization and project, so one agent's traces are never visible from another's. Credentials are created for you — only the on/off toggle, environment and tags are editable. (System prompt content is never sent — only its length.)

**Section key** `langfuse` · **Shape** object · **Tier** Business only (not in the free trial)\
**Edit in the dashboard:** [Monitoring page](/sidebar-menu/monitoring)

## Fields

| Field           | Required | Type            | Allowed values / constraints | Default | Description                                                                                                                                                                      |
| --------------- | -------- | --------------- | ---------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enabled`       | no       | boolean         | —                            | —       | Master on/off for trace export. Owner-editable.                                                                                                                                  |
| `publicKey`     | no       | string          | —                            | —       | Langfuse public key (pk-lf-…). Auto-provisioned; do not edit.                                                                                                                    |
| `secretKey`     | no       | string          | —                            | —       | Langfuse secret key (sk-lf-…). Auto-provisioned and stored encrypted at rest; never returned to the browser.                                                                     |
| `host`          | no       | string          | —                            | —       | Server-side Langfuse base URL. Set from the LANGFUSE\_HOST env var at provision time; defaults to [http://localhost:3000](http://localhost:3000).                                |
| `orgId`         | no       | string          | —                            | —       | Langfuse organization ID owning this agent's project. One organization per agent — org membership is the only access boundary the OSS Langfuse build enforces. Auto-provisioned. |
| `projectId`     | no       | string          | —                            | —       | Langfuse project ID dedicated to this agent — the isolation boundary for its traces. Auto-provisioned.                                                                           |
| `managed`       | no       | boolean         | —                            | —       | True when the binding was created by platform auto-provisioning (always true for new agents).                                                                                    |
| `provisionedAt` | no       | string          | —                            | —       | ISO-8601 timestamp of when this agent's Langfuse project and keys were created.                                                                                                  |
| `environment`   | no       | string          | —                            | —       | Optional environment tag stamped on every trace (e.g. 'production', 'staging'). Owner-editable.                                                                                  |
| `tags`          | no       | array of string | —                            | —       | Optional list of tags stamped on every trace for filtering in the Langfuse dashboard. Owner-editable.                                                                            |