> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 用于计费和运营遥测的出站连接

<Info>
  本页面仅适用于未在离线（气隙）模式下运行的客户，并假设您使用的是版本 0.9.0 或更高版本的自托管 LangSmith 实例。
</Info>

自托管 LangSmith 实例将所有信息存储在本地，永远不会将敏感信息发送到您的网络之外。但是，除非您在离线模式下运行，否则 LangSmith 需要出站连接到 `https://beacon.langchain.com` 以进行以下操作：

* **计费遥测** — 许可证验证和订阅/使用情况报告（必需）
* **运营遥测** — 用于支持诊断的日志、指标和跟踪（可选，可以禁用）
* **使用遥测** — 用于产品洞察的匿名使用情况快照（可选，可以禁用）

<Warning>
  **必须出站连接到 `https://beacon.langchain.com`。** 如需静态 IP 地址，请参阅 [IP 地址白名单部分](/langsmith/cloud#allowlisting-ip-addresses)。
</Warning>

## 计费遥测

对于未在离线模式下运行的自托管 LangSmith 实例，计费遥测是**必需的**。这包括许可证验证和订阅/使用情况报告。

<Info>
  计费遥测**无法禁用**。如果您需要在没有任何出站连接的情况下运行，请联系您的客户经理了解离线（气隙）许可证。
</Info>

### 功能说明

* **许可证验证**：在启动时及之后定期验证您的 LangSmith 许可证密钥。
* **订阅/使用情况报告**：根据您订单中的权限，报告用于计费目的的平台使用指标。

### 收集内容

* 许可证密钥验证请求
* 聚合的使用计数（跟踪数量、分配的席位数、使用的席位数）
* 组织和工作区标识符

### 示例有效负载

#### 许可证验证

**端点：** `POST beacon.langchain.com/v1/beacon/verify`

**请求：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "license": "<YOUR_LICENSE_KEY>"
}
```

**响应：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "token": "Valid JWT" //短期有效的 JWT 令牌，以避免重复的许可证检查
}
```

#### 订阅/使用情况报告

**端点：** `POST beacon.langchain.com/v1/beacon/ingest-traces`

**请求：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "license": "<YOUR_LICENSE_KEY>",
  "trace_transactions": [
    {
      "id": "af28dfea-5358-463d-a2dc-37df1da72498",
      "tenant_id": "3a1c2b6f-4430-4b92-8a5b-79b8b567bbc1",
      "session_id": "b26ae531-cdb3-42a5-8bcf-05355199fe27",
      "trace_count": 5,
      "start_insertion_time": "2025-01-06T10:00:00Z",
      "end_insertion_time": "2025-01-06T11:00:00Z",
      "start_interval_time": "2025-01-06T09:00:00Z",
      "end_interval_time": "2025-01-06T10:00:00Z",
      "status": "completed",
      "num_failed_send_attempts": 0,
      "transaction_type": "type1",
      "organization_id": "c5b5f53a-4716-4326-8967-d4f7f7799735"
    }
  ]
}
```

**响应：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "inserted_count": 1 //成功接收的事务数量
}
```

## 运营遥测

从 **0.11** 版本开始，LangSmith 部署默认发送运营遥测。此遥测有助于 LangChain 团队为自托管实例提供主动支持和更快的故障排除。

<Info>
  运营遥测与计费遥测**分开**。您可以在保持计费遥测活动的同时禁用运营遥测。
</Info>

### 功能说明

* 实现对自托管实例的主动支持和更快的故障排除
* 协助性能调优
* 根据实际使用模式帮助优先改进

### 收集内容

* **请求元数据**：匿名化的请求计数、大小和持续时间
* **数据库指标**：查询持续时间、错误率和性能计数器
* **运营跟踪**：高延迟或失败请求的计时和错误信息（这些**不是**客户跟踪——它们是关于 LangSmith 实例本身运行情况的跟踪）
* **日志消息**：仅警告和错误日志消息

<Info>
  我们不收集实际的有效负载内容、数据库记录或任何可以识别您的最终用户或客户的数据。所有遥测数据都与组织和部署相关联，但永远不会与单个用户关联。我们**不收集任何形式的 PII**（个人身份信息）。
</Info>

### 如何禁用

您可以通过在 `langsmith_config.yaml` 文件中设置以下值来禁用运营遥测：

```yaml theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
config:
  telemetry:
    logs: false
    metrics: false
    traces: false
```

您也可以通过仅将特定值设置为 `false` 来禁用单个遥测类型。

<Warning>
  禁用运营遥测会停止导出本节中描述的日志、指标和跟踪。它**不会**禁用计费遥测（许可证验证和订阅/使用情况报告）。
</Warning>

### 示例有效负载

#### 运营指标

**端点：** `POST beacon.langchain.com/v1/beacon/v1/metrics`

**请求：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "resourceMetrics": [
    {
      "resource": {
        "attributes": [
          {
            "key": "resource.name",
            "value": { "stringValue": "langsmith-metrics" }
          },
          {
            "key": "env",
            "value": { "stringValue": "ls_self_hosted" }
          }
        ]
      },
      "scopeMetrics": [
        {
          "scope": {
            "name": "langsmith.metrics",
            "version": "0.1.0"
          },
          "metrics": [
            {
              "name": "langsmith_http_requests_latency",
              "unit": "seconds",
              "description": "LangSmith 服务的请求延迟",
              "gauge": {
                "dataPoints": [
                  {
                    "asDouble": 12.34,
                    "startTimeUnixNano": 1678886400000000000,
                    "timeUnixNano": 1678886400000000000,
                    "attributes": [
                      {
                        "key": "endpoint",
                        "value": { "stringValue": "/sessions" }
                      },
                      { "key": "method", "value": { "stringValue": "GET" } },
                      {
                        "key": "service_name",
                        "value": { "stringValue": "langsmith_backend" }
                      }
                    ]
                  }
                ]
              }
            },
            {
              "name": "langsmith_http_requests_failed",
              "unit": "1",
              "description": "LangSmith 服务失败请求的计数器",
              "sum": {
                "dataPoints": [
                  {
                    "asInt": 456,
                    "startTimeUnixNano": 1678886400000000000,
                    "timeUnixNano": 1678886400000000000,
                    "attributes": [
                      {
                        "key": "endpoint",
                        "value": { "stringValue": "/info" }
                      },
                      { "key": "method", "value": { "stringValue": "POST" } },
                      {
                        "key": "service_name",
                        "value": { "stringValue": "langsmith_platform_backend" }
                      }
                    ],
                    "aggregationTemporality": 2,
                    "isMonotonic": true
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}
```

#### 运营跟踪

**端点：** `POST beacon.langchain.com/v1/beacon/v1/traces`

**请求：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "resourceSpans": [
    {
      "resource": {
        "attributes": [
          {
            "key": "env",
            "value": {
              "stringValue": "ls_self_hosted"
            }
          },
          {
            "key": "service.name",
            "value": {
              "stringValue": "langsmith_backend"
            }
          }
        ]
      },
      "scopeSpans": [
        {
          "scope": {},
          "spans": [
            {
              "traceId": "71699b6fe85982c7c8995ea3d9c95df2",
              "spanId": "3c191d03fa8be0",
              "parentSpanId": "",
              "name": "receive_request",
              "startTimeUnixNano": "1581452772000000321",
              "endTimeUnixNano": "1581452773000000789",
              "droppedAttributesCount": 1,
              "events": [
                {
                  "timeUnixNano": "1581452773000000123",
                  "name": "parse_request",
                  "attributes": [
                    {
                      "key": "request_size",
                      "value": {
                        "stringValue": "100"
                      }
                    }
                  ],
                  "droppedAttributesCount": 2
                },
                {
                  "timeUnixNano": "1581452773000000123",
                  "name": "event",
                  "droppedAttributesCount": 2
                }
              ],
              "droppedEventsCount": 1,
              "status": {
                "message": "status-cancelled",
                "code": 2
              }
            },
            {
              "traceId": "71699b6fe85982c7c8995ea3d9c95df2",
              "spanId": "0932ksdka12345",
              "parentSpanId": "3c191d03fa8be0",
              "name": "process_request",
              "startTimeUnixNano": "1581452772000000321",
              "endTimeUnixNano": "1581452773000000789",
              "links": [],
              "droppedLinksCount": 3,
              "status": {}
            }
          ]
        }
      ]
    }
  ]
}
```

#### 运营日志消息

我们仅导出来自自托管 LangSmith 实例的错误日志消息。这使得 LangChain 团队能够排除应用程序错误，而无需与您的团队进行反复沟通。

**端点：** `POST beacon.langchain.com/v1/beacon/v1/logs`

**请求：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "resourceLogs": [
    {
      "resource": {
        "attributes": [
          {
            "key": "service.name",
            "value": {
              "stringValue": "langsmith_backend"
            }
          }
        ]
      },
      "scopeLogs": [
        {
          "scope": {},
          "logRecords": [
            {
              "timeUnixNano": "1581452773000009875",
              "severityNumber": 13,
              "severityText": "Warning",
              "body": {
                "stringValue": "Database connection pool approaching capacity"
              },
              "attributes": [
                {
                  "key": "component",
                  "value": {
                    "stringValue": "langsmith_backend"
                  }
                },
                {
                  "key": "pool_size",
                  "value": {
                    "intValue": "95"
                  }
                }
              ],
              "droppedAttributesCount": 0,
              "traceId": "08040201000000000000000000000000",
              "spanId": "0102040800000000"
            },
            {
              "timeUnixNano": "1581452773000000789",
              "severityNumber": 17,
              "severityText": "Error",
              "body": {
                "stringValue": "Failed to process trace batch"
              },
              "attributes": [
                {
                  "key": "component",
                  "value": {
                    "stringValue": "langsmith_queue_worker"
                  }
                },
                {
                  "key": "error_type",
                  "value": {
                    "stringValue": "timeout"
                  }
                }
              ],
              "droppedAttributesCount": 0,
              "traceId": "",
              "spanId": ""
            }
          ]
        }
      ]
    }
  ]
}
```

## 使用遥测

使用遥测收集您的 LangSmith 实例使用指标的匿名快照。这些数据有助于 LangChain 了解平台采用模式，并为产品开发决策提供信息。

<Info>
  使用遥测**默认启用**，可以禁用。与计费遥测不同，您可以完全控制是否将这些快照发送给 LangChain。
</Info>

### 功能说明

* 定期捕获聚合的使用指标
* 提供对功能采用和平台增长的洞察
* 帮助 LangChain 根据实际使用情况优先改进和开发新功能

### 收集内容

* **平台指标**：工作区、项目、实验、数据集、评估器和其他平台资源的计数
* **功能使用情况**：运行规则、标注队列、提示和提示相关活动的计数
* **用户**：注册用户总数和过去 30 天内活动的 PAT（个人访问令牌）数量
* **时间戳**：快照的时间范围（UTC 中的起始/结束时间戳）

<Info>
  所有指标**仅为聚合计数**。不收集单个资源数据、标识符或使用模式。我们不收集任何可能识别您的最终用户或客户的信息。
</Info>

### 示例有效负载

**端点：** `POST /v1/beacon/usage-snapshot`

**请求：**

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "license_key": "<YOUR_LICENSE_KEY>",
  "from_timestamp": "2026-03-25T02:00:00+00:00",
  "to_timestamp": "2026-03-26T02:00:00+00:00",
  "measures": {
    "workspaces": 12,
    "users": 63,
    "projects": 87,
    "experiments": 34,
    "datasets": 15,
    "evaluators": 8,
    "run_rules": 5,
    "annotation_queues": 3,
    "prompts": 22,
    "prompt_commits": 156,
    "prompt_pulls": 1043,
    "active_pats_30d": 47
  }
}
```

### 如何禁用

您可以通过在部署配置中设置以下环境变量来禁用使用遥测：

```yaml theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
PHONE_HOME_USAGE_REPORTING_ENABLED: false
```

将其添加到 Helm 配置的 `commonEnv` 部分，以永久禁用使用遥测报告。

<Warning>
  禁用使用遥测**不会**影响计费或运营遥测。许可证验证和订阅/使用情况报告将继续正常运行。
</Warning>

## 我们的承诺

LangChain 不会在计费或运营遥测中存储任何敏感信息。收集的任何数据都不会与第三方共享。日志消息经过过滤，仅包含错误严重级别，我们不会捕获可能包含敏感应用程序数据的日志消息。如果您对发送的数据有任何疑虑，请禁用遥测和/或联系您的客户经理。

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/self-host-egress.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>