订阅指标和运营元数据的出站流量¶

重要提示:仅限自托管 本节仅适用于未在离线模式下运行的客户,并假设你正在使用自托管的 LangGraph Platform 实例。这不适用于 SaaS 或混合部署。

自托管的 LangGraph Platform 实例在本地存储所有信息,永远不会将敏感信息发送到你的网络之外。我们目前仅根据你的订单中的权利跟踪平台使用情况以进行计费。为了更好地远程支持我们的客户,我们确实需要出站访问 https://beacon.langchain.com。

未来,我们将引入支持诊断功能,以帮助我们确保 LangGraph Platform 在你的环境中以最佳水平运行。

警告 这将需要从你的网络出站访问 https://beacon.langchain.com。 如果使用 API 密钥,你还需要允许出站访问 https://api.smith.langchain.com 或 https://eu.api.smith.langchain.com 以进行 API 密钥验证。

通常,我们发送到 Beacon 的数据可以分类如下:

订阅指标
订阅指标用于确定 LangSmith 的访问级别和利用率。这包括但不限于:
- 执行的节点数
- 执行的运行数
- 许可证密钥验证
运营元数据
此元数据将包含并收集上述订阅指标,以协助远程支持,使 LangChain 团队能够更有效地主动诊断和排查性能问题。

示例有效载荷¶

为了最大限度地提高透明度,我们在此提供示例有效载荷:

许可证验证(如果使用企业许可证)¶

端点:

POST beacon.langchain.com/v1/beacon/verify

请求:

{
  "license": "<YOUR_LICENSE_KEY>"
}

响应:

{
  "token": "Valid JWT" // 短期 JWT 令牌,以避免重复的许可证检查
}

API 密钥验证(如果使用 LangSmith API 密钥)¶

端点: POST api.smith.langchain.com/auth

请求:

"Headers": {
  X-Api-Key: <YOUR_API_KEY>
}

响应:

{
  "org_config": {
    "org_id": "3a1c2b6f-4430-4b92-8a5b-79b8b567bbc1",
    ... // 其他组织详细信息
  }
}

使用情况报告¶

端点:

POST beacon.langchain.com/v1/metadata/submit

请求:

{
  "license": "<YOUR_LICENSE_KEY>",
  "from_timestamp": "2025-01-06T09:00:00Z",
  "to_timestamp": "2025-01-06T10:00:00Z",
  "tags": {
    "langgraph.python.version": "0.1.0",
    "langgraph_api.version": "0.2.0",
    "langgraph.platform.revision": "abc123",
    "langgraph.platform.variant": "standard",
    "langgraph.platform.host": "host-1",
    "langgraph.platform.tenant_id": "3a1c2b6f-4430-4b92-8a5b-79b8b567bbc1",
    "langgraph.platform.project_id": "c5b5f53a-4716-4326-8967-d4f7f7799735",
    "langgraph.platform.plan": "enterprise",
    "user_app.uses_indexing": "true",
    "user_app.uses_custom_app": "false",
    "user_app.uses_custom_auth": "true",
    "user_app.uses_thread_ttl": "true",
    "user_app.uses_store_ttl": "false"
  },
  "measures": {
    "langgraph.platform.runs": 150,
    "langgraph.platform.nodes": 450
  },
  "logs": []
}

响应:

"204 No Content"

我们的承诺¶

LangChain 不会在订阅指标或运营元数据中存储任何敏感信息。收集的任何数据都不会与第三方共享。如果你对发送的数据有任何疑虑,请联系你的客户团队。