主题
查看使用情况
LangSmith 中有哪些使用情况数据、每个指标的含义，以及自托管有何不同。
LangSmith 会为你的组织使用情况提供多种视图，具体取决于你的方案和托管类型。本页解释有哪些数据可用、每个指标的含义，以及适用于自托管的限制。
使用情况视图
| 视图 | 在哪里找到 | 谁可以查看 | 方案可用性 |
|---|---|---|---|
| 使用情况图 | Enterprise：Settings > Usage > Usage graph Self-serve：Settings > Billing > Usage graph | 所有组织成员 | 所有方案 |
| 详细使用情况 | Enterprise：Settings > Usage > Granular usage Self-serve：Settings > Billing > Granular usage | 所有组织成员 | 所有方案 |
| 合同使用情况 | Enterprise：Settings > Usage > Contract usage Self-serve：Settings > Billing > Contract usage | 仅组织管理员（organization:manage） | 仅企业版 |
| 发票 | Settings > Billing > Invoices | 所有组织成员 | 仅自助式 Cloud |
| 评估器花费 | Evaluators 页面、评估器详情 | 所有工作区成员 | 每周跟踪，于周一 UTC 12AM 重置，与下方的月度账期分开 |
使用情况图
使用情况图显示你组织的聚合追踪消耗量，并按工作区细分。它涵盖当前账期，不显示花费——要了解花费，请参阅发票。
导航到 Settings > Billing and Usage > Usage Graph。
可计费指标
| 指标 | 计数内容 |
|---|---|
| LangSmith Traces (Base Charge) | 账期内发送到 LangSmith 的每一条追踪，无论数据保留层级如何。 |
| LangSmith Traces (Extended Data Retention Upgrades) | 升级到延长保留的追踪（截至 2026 年 9 月 14 日默认为 180 天，企业版客户可自定义）。这些在基础费用之外另行计费。 |
| LangSmith Deployment Runs | 已部署 LangGraph agent 的端到端调用。定价详情请参阅 LangSmith Deployment 计费。 |
| LangSmith Fleet Runs | Fleet agent 的端到端调用。Cloud 托管与自托管部署分开跟踪。 |
| LangSmith Deployment Nodes Executed | 已部署 agent 中各个 LangGraph 节点的执行。已部署 agent 图中的每一步都计为一次节点执行。Cloud 托管与自托管部署分开跟踪。 |
有关追踪保留层级的更多详情，请参阅数据保留。
NOTE
使用情况图将术语 tenant_id 与工作区 ID 互换使用。
合同使用情况
具有预付承诺的企业版客户可以查看其合同已被消耗多少。
导航到 Settings > Usage Configuration > Contract Usage。
此视图显示：
- 使用情况摘要：总用量、总积分以及任何超额。当用量超过你的总预付承诺时会产生超额。
- 承诺进度条：为每个承诺提供可视化指示，显示已消耗百分比以及已用与剩余的金额。一份合同可以有多个承诺，分别适用于不同时间段（例如多年合同的第一年和第二年）或不同产品。
- 月度用量图：柱状图，显示合同期内每个月的使用量。
- 产品费率：你所享有产品及其定价的表格。
NOTE
合同使用情况需要 organization:manage 权限，并且仅对具有预付承诺的企业版客户可用。
NOTE
如果你的合同跨越同一账单实体下的多个组织，合同使用情况视图会显示所有这些组织上累计的合并用量，而不仅仅是你当前查看的那个。详细使用情况始终限定于单个组织，因此要查看特定组织的详细使用情况，请切换到该组织并分别查看其详细使用情况。
发票
发票仅在自助式 Cloud 方案上可用。企业版 Cloud 组织有一个单独的使用情况视图来跟踪花费。
导航到 Settings > Billing and Usage > Invoices，查看你的用量如何转化为花费。显示的第一张发票是你当月发票的草稿，反映你迄今的累计花费。
详细使用情况
详细使用情况让你能够追踪数量按你所选维度（工作区、项目、用户或 API 密钥）在你所选时间段上进行细分。这对于内部费用分摊、识别高用量团队或审计追踪活动很有用。
导航到 Settings > Billing and Usage > Granular Usage，或使用详细使用情况 API。
这里的「追踪」含义
详细使用情况视图统计的是追踪：根级运行及其所有子 span 被计为一个单元。这与用于计费的单元相同。它不会单独统计各个 span、token 或模型调用。
何时记录用量
详细使用情况按插入时间（LangSmith 接收并存储追踪的时间）记录追踪，而不是按它在你应用中运行的时间。实际上这种差异通常可以忽略，但延迟发送的追踪（例如缓冲的 SDK 上传）可能会出现在比预期更晚的时间桶中。
有关分组选项、时间桶大小和 API 参考，请参阅详细可计费使用情况。
自托管限制
由于计费基础设施的差异，自托管 LangSmith 可提供的使用情况视图集合与 Cloud 不同。
| 功能 | 自托管可用性 |
|---|---|
| 详细使用情况（追踪归属） | 通过功能标志或版本 ≥ 0.13.12 可用 |
| 使用情况图（聚合追踪） | 在 Helm chart 0.9.5 及更高版本上可用 |
| 合同使用情况 | 在启用 Beacon phone-home 时可用 |
| 发票与付款管理 | 不可用（账单在 LangSmith 之外处理） |
自托管上的详细使用情况
详细使用情况在自托管上可用，但需要显式选择启用：
在 LangSmith 0.13.12 及更高版本上，详细使用情况收集默认启用。
在较早版本上，通过设置以下两个环境变量来启用它：
envDEFAULT_ORG_FEATURE_ENABLE_GRANULAR_USAGE_REPORTING=true GRANULAR_USAGE_TABLE_ENABLED=true
WARNING
数据收集从功能被启用那一刻开始。启用之前不会回填历史用量数据。在选择何时启用此功能时请据此规划。
自托管上的聚合使用情况
使用情况图在运行 Helm chart 0.9.5 或更高版本的自托管上可用。LangSmith 会自动生成并同步组织使用情况图表，可在 Settings > Usage and billing > Usage graph 下查看：
- Usage by Workspace：每个工作区的追踪数（根运行）
- Organization Usage：整个组织的总追踪数
图表每 5 分钟刷新一次以纳入新工作区，且不可编辑。
要以编程方式访问追踪数，请参阅查看整个组织的追踪数。