Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/langsmith/aws-self-hosted.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ View the [AWS Terraform modules](https://github.com/langchain-ai/terraform/tree/
PostgreSQL database
</Card>
<Card title="Amazon ElastiCache" icon="cpu" href="/langsmith/self-host-external-redis#amazon-elasticache">
Redis for caching
Redis or Valkey for caching
</Card>
<Card title="ClickHouse Cloud" icon="chart-line" href="/langsmith/self-host-external-clickhouse">
Analytics database
Expand Down Expand Up @@ -71,7 +71,7 @@ We recommend leveraging AWS's managed services to provide a scalable, secure, an
- <Icon icon="cube" /> **Frontend & backend services:** Containers run on [Amazon EKS](https://aws.amazon.com/eks/), orchestrated behind the ALB. routes requests to other services within the cluster as necessary.
- <Icon icon="database" /> **Storage & databases:**
- [Amazon RDS for PostgreSQL](https://aws.amazon.com/rds/postgresql/) or [Aurora](https://aws.amazon.com/rds/aurora/): metadata, projects, users, and short-term and long-term memory for deployed agents. LangSmith supports PostgreSQL version 14 or higher.
- [Amazon ElastiCache (Redis)](https://aws.amazon.com/elasticache/redis/): caching and job queues. ElastiCache can be in single-instance or cluster mode, running Redis OSS version 5 or higher.
- [Amazon ElastiCache](https://aws.amazon.com/elasticache/) (Redis or Valkey): caching and job queues. ElastiCache can be in single-instance or cluster mode. LangSmith requires Redis OSS version 5 or higher, or Valkey 8.
- ClickHouse + [Amazon EBS](https://aws.amazon.com/ebs/): analytics and trace storage.
- We recommend using an [externally managed ClickHouse solution](/langsmith/self-host-external-clickhouse) unless security or compliance reasons
prevent you from doing so.
Expand Down
4 changes: 2 additions & 2 deletions src/langsmith/gcp-self-hosted.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ View the [GCP Terraform modules](https://github.com/langchain-ai/terraform/tree/
PostgreSQL database
</Card>
<Card title="Memorystore" icon="cpu" href="/langsmith/self-host-external-redis#google-cloud-memorystore">
Redis for caching
Redis or Valkey for caching
</Card>
<Card title="ClickHouse Cloud" icon="chart-line" href="/langsmith/self-host-external-clickhouse">
Analytics database
Expand Down Expand Up @@ -71,7 +71,7 @@ We recommend leveraging GCP's managed services to provide a scalable, secure, an
- <Icon icon="cube" /> **Frontend & backend services:** Containers run on [Google Kubernetes Engine (GKE)](https://cloud.google.com/kubernetes-engine), orchestrated behind the load balancer. Routes requests to other services within the cluster as necessary.
- <Icon icon="database" /> **Storage & databases:**
- [Cloud SQL for PostgreSQL](https://cloud.google.com/sql/docs/postgres): metadata, projects, users, and short-term and long-term memory for deployed agents. LangSmith supports PostgreSQL version 14 or higher.
- [Memorystore for Redis](https://cloud.google.com/memorystore/docs/redis): caching and job queues. Memorystore can be in single-instance or cluster mode, running Redis OSS version 5 or higher.
- [Memorystore](https://cloud.google.com/memorystore) ([Redis](https://cloud.google.com/memorystore/docs/redis) or [Valkey](https://cloud.google.com/memorystore/docs/valkey)): caching and job queues. Memorystore can be in single-instance or cluster mode. LangSmith requires Redis OSS version 5 or higher, or Valkey 8.
- ClickHouse + [Persistent Disks](https://cloud.google.com/compute/docs/disks): analytics and trace storage.
- We recommend using an [externally managed ClickHouse solution](/langsmith/self-host-external-clickhouse) unless security or compliance reasons
prevent you from doing so.
Expand Down
16 changes: 9 additions & 7 deletions src/langsmith/self-host-external-redis.mdx
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
---
title: Connect to an external Redis database
sidebarTitle: Connect to an external Redis database
title: Connect to an external Redis or Valkey database
sidebarTitle: Connect to an external Redis or Valkey database
---

LangSmith uses Redis to back our queuing/caching operations. By default, LangSmith Self-Hosted will use an internal Redis instance. However, you can configure LangSmith to use an external Redis instance. By configuring an external Redis instance, you can more easily manage backups, scaling, and other operational tasks for your Redis instance.

[Valkey](https://valkey.io/) is also officially supported as a drop-in replacement for Redis. Anywhere this page refers to Redis, you can use a compatible Valkey instance. See [Requirements](#requirements) for supported versions.

<Warning>
Each LangSmith installation must use its own dedicated Redis instance. Redis cannot be shared across separate LangSmith installations (for example, between an existing and new cluster during a migration). Sharing it across installations causes deployment tasks to be routed to the wrong cluster.
</Warning>
Expand All @@ -20,14 +22,14 @@ For cloud-specific IAM/Workload Identity authentication, refer to the [IAM authe

## Requirements

* A provisioned Redis instance that your LangSmith instance will have network access to. We recommend using a managed Redis service like:
* A provisioned Redis or [Valkey](https://valkey.io/) instance that your LangSmith instance will have network access to. We recommend using a managed service like:

* [Amazon ElastiCache](https://aws.amazon.com/elasticache/redis/)
* [Google Cloud Memorystore](https://cloud.google.com/memorystore)
* [Amazon ElastiCache](https://aws.amazon.com/elasticache/redis/) (Redis or Valkey)
* [Google Cloud Memorystore](https://cloud.google.com/memorystore) (Redis or Valkey)
* [Azure Cache for Redis](https://azure.microsoft.com/en-us/services/cache/)

* Note: We only officially support Redis versions >= 5 and Valkey version 8.
* We support both Standalone and Redis Cluster. See the appropriate sections for deployment instructions.
* **Supported versions:** Redis >= 5, or Valkey 8. Valkey is treated as a drop-in replacement for Redis throughout this guide.
* We support both Standalone and Redis Cluster (including Valkey Cluster). See the appropriate sections for deployment instructions.
* We support no authentication, password, and [IAM/Workload Identity](#iam-authentication) authentication.
* By default, we recommend an instance with at least 2 vCPUs and 8GB of memory. However, the actual requirements will depend on your tracing workload. We recommend monitoring your Redis instance and scaling up as needed.

Expand Down
2 changes: 1 addition & 1 deletion src/langsmith/self-hosted.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ LangSmith will bundle all storage services by default. You can configure it to u
|---------|-------------|
| <a id="clickhouse"></a> **ClickHouse** | [ClickHouse](https://clickhouse.com/docs/en/intro) is a high-performance, column-oriented SQL database management system (DBMS) for online analytical processing (OLAP).<br/><br/>LangSmith uses ClickHouse as the primary data store for traces and feedback (high-volume data).<br/><br/>💡 [Connect to external ClickHouse](/langsmith/self-host-external-clickhouse) |
| <a id="postgresql"></a> **PostgreSQL** | [PostgreSQL](https://www.postgresql.org/about/) is a powerful, open source object-relational database system that uses and extends the SQL language combined with many features that safely store and scale the most complicated data workloads.<br/><br/>LangSmith uses PostgreSQL as the primary data store for transactional workloads and operational data (almost everything besides traces and feedback).<br/><br/>💡 [Connect to external PostgreSQL](/langsmith/self-host-external-postgres) - AWS RDS, GCP Cloud SQL, Azure Database |
| <a id="redis"></a> **Redis** | [Redis](https://github.com/redis/redis) is a powerful in-memory key-value database that persists on disk. By holding data in memory, Redis offers high performance for operations like caching.<br/><br/>LangSmith uses Redis to back queuing and caching operations.<br/><br/>💡 [Connect to external Redis](/langsmith/self-host-external-redis) - AWS ElastiCache, GCP Memorystore, Azure Cache |
| <a id="redis"></a> **Redis / Valkey** | [Redis](https://github.com/redis/redis) is a powerful in-memory key-value database that persists on disk. By holding data in memory, Redis offers high performance for operations like caching.<br/><br/>LangSmith uses Redis to back queuing and caching operations. [Valkey](https://valkey.io/) is also officially supported as a drop-in replacement for Redis.<br/><br/>💡 [Connect to external Redis or Valkey](/langsmith/self-host-external-redis) - AWS ElastiCache, GCP Memorystore, Azure Cache |
| <a id="blob-storage"></a> **Blob storage** | LangSmith supports several blob storage providers, including [AWS S3](https://aws.amazon.com/s3/), [Azure Blob Storage](https://azure.microsoft.com/en-us/services/storage/blobs/), and [Google Cloud Storage](https://cloud.google.com/storage).<br/><br/>LangSmith uses blob storage to store large files, such as trace artifacts, feedback attachments, and other large data objects. Blob storage is optional, but highly recommended for production deployments.<br/><br/>💡 [Enable blob storage](/langsmith/self-host-blob-storage) - AWS S3, GCP GCS, Azure Blob |

To install, follow the [Kubernetes setup guide](/langsmith/kubernetes).
Expand Down
Loading