查看整个组织的追踪数量

NOTE

此功能在 Helm chart 0.9.5 及更高版本中可用。

对于自托管安装，LangSmith 会自动生成并同步组织用量图表。

这些图表位于 Settings > Usage and billing > Usage graph 下：

• 按工作区统计用量：按工作区统计追踪（根运行）数量
• 组织用量：统计整个组织的所有追踪（根运行）

图表每 5 分钟刷新一次，以包含任何新的工作区。请注意，这些图表不可编辑。

以编程方式获取追踪数量

你可以使用两种不同的方法以编程方式获取追踪数量：

方法 1：使用 LangSmith REST API

如果你的自托管安装使用在线密钥，可以使用 LangSmith REST API 获取组织用量数据。

curl -X GET "https://your-langsmith-instance.com/api/v1/orgs/current/billing/usage" \
  -H "Accept: application/json" \
  -H "X-API-Key: your-api-key" \
  -G \
  -d "starting_on=2025-09-01T00:00:00Z" \
  -d "ending_before=2025-10-01T00:00:00Z" \
  -d "on_current_plan=true"

方法 2：使用 PostgreSQL 支持查询

对于使用离线密钥的安装，或当你需要更详细的导出能力时，可以直接针对 PostgreSQL 数据库运行支持查询。所有可用脚本都位于 support queries 仓库。

sh run_support_query_pg.sh "postgres://postgres:postgres@localhost:5432/postgres" \
  --input support_queries/postgres/pg_get_historic_trace_counts_daily.sql \
  --output trace_counts.csv

有关运行支持查询的更多详细信息，请参阅针对 PostgreSQL 运行支持查询指南。

---