Skip to main content
此 Helm 仓库包含用于生成 LangSmith UI 目前不直接支持的输出的查询（例如，在单个查询中获取多个组织的追踪计数）。 该命令接受一个包含嵌入式名称和密码的 PostgreSQL 连接字符串（可以从密钥管理器调用中传入），并执行输入文件中的查询。在下面的示例中，我们使用 support_queries/postgres 目录中的 pg_get_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. 运行支持查询的脚本

​
运行查询脚本

运行以下命令以执行所需查询： 
sh run_support_query_pg.sh <postgres_url> --input path/to/query.sql
例如，如果使用捆绑版本并启用了端口转发，命令可能如下所示： 
sh run_support_query_pg.sh "postgres://postgres:postgres@localhost:5432/postgres" --input support_queries/pg_get_trace_counts_daily.sql
这将按工作区 ID 和组织 ID 输出每日追踪计数。要将其提取到文件中，请添加标志 --output path/to/file.csv

​
导出使用数据

所有导出方法都生成相同的数据：LangSmith 追踪计数、LangSmith Deployments 节点使用情况以及所有工作区和组织中的 Fleet 运行计数。
UI 和 API 导出需要同时满足以下条件：
  • 具备 organization:manage 权限。
  • 调用者的电子邮件必须列在 USAGE_EXPORT_ADMIN_EMAILS 中，或者必须将 ORG_ADMINS_INSTALLATION_USAGE_EXPORT_ENABLED 设置为 true。
USAGE_EXPORT_ADMIN_EMAILS='["admin@example.com", "admin2@example.com"]'
ORG_ADMINS_INSTALLATION_USAGE_EXPORT_ENABLED=true

​
从 UI 导出（推荐）

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

​
通过 API 导出

如果希望通过编程方式导出使用数据，可以直接调用导出 API 端点。 
curl -OJ \
  -H "X-API-Key: <your_api_key>" \
  https://<langsmith_url>/api/v1/orgs/current/usage/backfill-export

​
通过 SQL 脚本导出

也可以直接对 PostgreSQL 数据库运行 SQL 脚本以导出使用数据。这需要数据库访问凭据——不适用应用程序级别的权限。 要导出追踪使用情况（需要 Helm chart 版本 0.11.4 或更高）： 
sh run_support_query_pg.sh <postgres_url> \
  --input support_queries/postgres/pg_usage_traces_full_export.sql \
  --output ls_export.csv
要导出节点使用情况（需要 Helm chart 版本 0.11.4 或更高）： 
sh run_support_query_pg.sh <postgres_url> \
  --input support_queries/postgres/pg_usage_nodes_full_export.sql \
  --output lgp_export.csv
要导出 Fleet 运行计数（需要 Helm chart 版本 0.13.25 或更高）： 
sh run_support_query_pg.sh <postgres_url> \
  --input support_queries/postgres/pg_usage_agent_builder_full_export.sql \
  --output ab_export.csv
要导出使用情况快照（每日实体计数，如工作区、项目、数据集、提示和活跃用户）： 
sh run_support_query_pg.sh <postgres_url> \
  --input support_queries/postgres/pg_usage_snapshots_full_export.sql \
  --output usage_snapshots_export.csv
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.