连接到外部 Redis 数据库

LangSmith 使用 Redis 支持队列和缓存操作。默认情况下，LangSmith 自托管版本将使用内置的 Redis 实例。 但您可以将 LangSmith 配置为使用外部 Redis 实例（在生产环境中强烈推荐）。通过配置外部 Redis 实例，您可以更轻松地管理 Redis 实例的备份、扩展及其他运维任务。

要求

• 一个已配置的 Redis 实例，您的 LangSmith 实例将能够通过网络访问该实例。我们建议使用托管式 Redis 服务，例如：
  • Amazon ElastiCache
  • Google Cloud Memorystore
  • Azure Redis 缓存
• 注意：我们仅正式支持 Redis 5 及更高版本。
• 我们不支持 Redis 集群。
• 默认情况下，我们建议使用至少配备 2 个 vCPU 和 8GB 内存的实例。然而，实际需求将取决于您的追踪工作负载。我们建议监控您的 Redis 实例，并根据需要进行扩容。

Redis 集群不受支持

某些托管 Redis 服务的层级可能在底层使用 Redis 集群，但您可以直接指向集群中的单个节点。 例如，在 Azure Cache for Redis 中，“0”层级及更高级别均采用 Redis 集群，因此您需要改用较低层级。

连接字符串

我们使用 redis-py 连接到 Redis。该库支持多种连接字符串格式。您可在此处了解有关连接字符串格式的更多信息：此处。

您需要为您的 Redis 实例组装连接字符串。该连接字符串应包含以下信息：

• 主机
• 数据库
• 端口
• URL 参数

这将表现为：

"redis://host:port/db?<url_params>"

一个示例连接字符串可能如下所示：

"redis://langsmith-redis:6379/0"

要使用 SSL，您可以使用 rediss:// 前缀。一个启用 SSL 的连接字符串示例如下：

"rediss://langsmith-redis:6380/0?password=foo"

配置

获取连接字符串后，您即可配置 LangSmith 实例以使用外部 Redis 实例。您可以通过修改 LangSmith Helm Chart 安装的 values 文件，或 Docker 安装的 .env 文件来实现此配置。

Helm

redis:
  external:
    enabled: true
    connectionUrl: "Your connection url"

Docker

# In your .env file
REDIS_DATABASE_URI="Your connection url"

配置完成后，您应该能够重新安装 LangSmith 实例。如果所有配置均正确，您的 LangSmith 实例现在应已使用外部 Redis 实例。