Collecting Traces & Telemetry
ClickHouse is optional and only required for telemetry/observability features. Letta works perfectly fine without it using just PostgreSQL. You only need ClickHouse if you want to collect traces, view LLM provider requests, or analyze system performance metrics.
Letta uses ClickHouse to store telemetry. ClickHouse is a database optimized for storing logs and traces. Traces can be used to view raw requests to LLM providers and also understand your agent’s system performance metrics.
Configuring ClickHouse
You will need to have a ClickHouse DB (either running locally or with ClickHouse Cloud) to connect to Letta.
You can configure ClickHouse by passing the required enviornment variables:
Finding your credentials in ClickHouse Cloud
You can find these variable inside of ClickHouse Cloud by selecting the “Connection” button in the dashboard.

Connecting to Grafana
We recommend connecting ClickHouse to Grafana to query and view traces. Grafana can be run locally, or via Grafana Cloud.
Other Integrations
Letta also supports other exporters when running in a containerized environment. To request support for another exporter, please open an issue on GitHub.
Configuring Signoz
You can configure Signoz by passing the required enviornment variables: