以编程方式使用文档

此 Helm 仓库包含可生成 LangSmith UI 当前不支持直接输出的查询（例如，在单个查询中获取多个组织的追踪计数）。

此命令接受包含嵌入式名称和密码的 PostgreSQL 连接字符串（可从密钥管理器调用传入），并执行输入文件中的查询。在下面的示例中，我们使用的是 pg_get_trace_counts_daily.sql 中的输入文件 support_queries/postgres directory.

前提条件

Ensure you have the following tools/items ready.

  1. kubectl
  1. PostgreSQL 客户端
  1. PostgreSQL 数据库连接：
  • * 主机
  • * 端口
  • * 用户名
  • * 如果使用捆绑版本，则为 postgres
  • * 密码
  • * 如果使用捆绑版本，则为 postgres
  • * 数据库名称
  • * 如果使用捆绑版本，则为 postgres
  1. 从运行迁移脚本的计算机到 PostgreSQL 数据库的连接。
  • * 如果您使用的是捆绑版本，可能需要将 postgresql 服务端口转发到本地计算机。
  • * 运行 kubectl port-forward svc/langsmith-postgres 5432:5432 将 postgresql 服务端口转发到本地计算机。
  1. 运行支持查询的脚本

运行查询脚本

运行以下命令来运行所需的查询：

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 导出（推荐）

  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