此 Helm 仓库包含用于生成 LangSmith 界面目前不直接支持的输出的查询（例如，在单个查询中获取多个组织的跟踪计数）。 此命令需要一个包含嵌入用户名和密码的 PostgreSQL 连接字符串（可从密钥管理器调用传入），并从输入文件执行一个查询。以下示例使用了 support_queries/postgres 目录中的 pg_get_historic_trace_counts_daily.sql 输入文件。

​
前提条件

请确保您已准备好以下工具/项目。
  1. kubectl
  2. PostgreSQL 客户端
  3. PostgreSQL 数据库连接信息：
    • 主机
    • 端口
    • 用户名
      • 如果使用捆绑版本，则为 postgres
    • 密码
      • 如果使用捆绑版本，则为 postgres
    • 数据库名称
      • 如果使用捆绑版本，则为 postgres
  4. 从运行迁移脚本的机器到 PostgreSQL 数据库的连接性。
    • 如果您使用的是捆绑版本，可能需要将 postgresql 服务端口转发到本地机器。
    • 运行 kubectl port-forward svc/langsmith-postgres 5432:5432 以将 postgresql 服务端口转发到本地机器。
  5. 用于运行支持查询的脚本

​
运行查询脚本

运行以下命令以执行所需的查询：
例如，如果您使用的是带端口转发的捆绑版本，命令可能如下所示：
此命令将输出按工作区 ID 和组织 ID 分组的每日跟踪计数。要将结果导出到文件，请添加标志 --output path/to/file.csv

​
导出使用数据

所有导出方法都产生相同的数据：LangSmith 跟踪计数、LangSmith 部署节点使用情况以及跨所有工作区和组织的 Fleet 运行计数。
界面和 API 导出需要同时满足以下条件：
  • organization:manage 权限。
  • 调用者的邮箱必须列在 USAGE_EXPORT_ADMIN_EMAILS 中，或者 ORG_ADMINS_INSTALLATION_USAGE_EXPORT_ENABLED 必须设置为 true。

​
从界面导出（推荐）

  1. 导航至 设置 > 使用情况与计费 > 使用情况导出。
  2. 点击 导出使用数据。
  3. 将下载一个包含所有使用数据的 ZIP 文件。

​
通过 API 导出

如果您希望以编程方式导出使用数据，可以直接调用导出 API 端点。

​
通过 SQL 脚本导出

您也可以直接对 PostgreSQL 数据库运行 SQL 脚本来导出使用数据。这需要数据库访问凭据——不涉及应用层权限。 要导出跟踪使用情况（需要 Helm chart 版本 0.11.4 或更高版本）：
要导出节点使用情况（需要 Helm chart 版本 0.11.4 或更高版本）：
要导出 Fleet 运行计数（需要 Helm chart 版本 0.13.25 或更高版本）：
要导出使用情况快照（每日实体计数，如工作区、项目、数据集、提示和活跃用户）：
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.