From 3b7c1f7a875d2901986299f00eb883d1165f2b2f Mon Sep 17 00:00:00 2001 From: dadachann <185672915+dadachann@users.noreply.github.com> Date: Fri, 31 Jul 2026 15:33:19 +0000 Subject: [PATCH] docs: document workspace telemetry identity --- en/insight/data-collection-policy.mdx | 11 ++++++----- ja/insight/data-collection-policy.mdx | 11 ++++++----- zh/insight/data-collection-policy.mdx | 11 ++++++----- 3 files changed, 18 insertions(+), 15 deletions(-) diff --git a/en/insight/data-collection-policy.mdx b/en/insight/data-collection-policy.mdx index c076b1146..d709d4714 100644 --- a/en/insight/data-collection-policy.mdx +++ b/en/insight/data-collection-policy.mdx @@ -17,7 +17,8 @@ When telemetry is enabled (via LangBot Space integration), the following data is | `model_name` | The model name used for the query (e.g., `gpt-4o`, `deepseek-chat`) | | `duration_ms` | How long the query took to process (in milliseconds) | | `version` | The LangBot version you are running | -| `instance_id` | A randomly generated UUID identifying your LangBot instance (generated at first launch, not linked to personal identity) | +| `workspace_uuid` | A stable UUID identifying the Workspace where the query ran. For the default self-hosted Workspace it is aligned with the installation UUID and is not linked to personal identity. | +| `runtime_instance_id` | For managed SaaS query events only, the runtime deployment identifier used to refresh idle-timeout activity. It is not stored in the analytics event record. | | `pipeline_plugins` | Names of pipeline plugins involved in the query | | `features` | Anonymous feature-usage counters for the query (see below) | | `error` | Error traceback if the query failed (no user content included) | @@ -36,9 +37,9 @@ To understand which capabilities are actually used, each query event may include | `activated_skills` | Names of skills activated during the query | | `mcp_servers` | Names of MCP servers bound to the pipeline (omitted when "all enabled" is used) | -### Instance heartbeat +### Workspace heartbeat -In addition to per-query events, LangBot sends an anonymous **instance heartbeat** once shortly after startup and then once per day. It describes the instance's configuration profile — never its data: +In addition to per-query events, LangBot sends one anonymous **Workspace heartbeat** for each active Workspace shortly after startup and then once per day. It describes that Workspace's configuration profile — never its data: | Field | Description | |---|---| @@ -92,7 +93,7 @@ space: When telemetry is disabled: - No query data will be sent -- No instance heartbeats will be sent +- No Workspace heartbeats will be sent - No surveys will be fetched or displayed - All other LangBot features continue to work normally @@ -100,4 +101,4 @@ When telemetry is disabled: We may update this policy as LangBot evolves. Changes will be documented in our release notes and reflected in this page. -*Last updated: June 2026* +*Last updated: July 2026* diff --git a/ja/insight/data-collection-policy.mdx b/ja/insight/data-collection-policy.mdx index ab01d4fce..cc6cde82c 100644 --- a/ja/insight/data-collection-policy.mdx +++ b/ja/insight/data-collection-policy.mdx @@ -17,7 +17,8 @@ LangBot は製品改善のため、最小限の匿名テレメトリデータを | `model_name` | クエリに使用されたモデル名（例：`gpt-4o`、`deepseek-chat`） | | `duration_ms` | クエリの処理時間（ミリ秒） | | `version` | 実行中の LangBot バージョン | -| `instance_id` | LangBot インスタンスを識別するランダム生成 UUID（初回起動時に生成、個人情報とは紐付けられません） | +| `workspace_uuid` | クエリが実行されたワークスペースを識別する安定した UUID。デフォルトのセルフホストワークスペースではインストール UUID と一致し、個人情報とは紐付けられません。 | +| `runtime_instance_id` | マネージド SaaS のクエリイベントでのみ送信され、実行環境のアイドルタイムアウト活動を更新するために使用されます。分析イベントレコードには保存されません。 | | `pipeline_plugins` | クエリに関与したパイプラインプラグイン名 | | `features` | クエリの匿名機能使用カウンター（下記参照） | | `error` | クエリ失敗時のエラートレースバック（ユーザーコンテンツは含まれません） | @@ -36,9 +37,9 @@ LangBot は製品改善のため、最小限の匿名テレメトリデータを | `activated_skills` | クエリ中にアクティベートされたスキル名 | | `mcp_servers` | パイプラインにバインドされた MCP サーバー名（「すべて有効」の場合は送信されません） | -### インスタンスハートビート +### ワークスペースハートビート -クエリごとのイベントに加え、LangBot は起動直後とその後 1 日 1 回、匿名の**インスタンスハートビート**を送信します。これはインスタンスの構成プロファイルを示すもので、インスタンスのデータは一切含まれません： +クエリごとのイベントに加え、LangBot は起動直後とその後 1 日 1 回、アクティブなワークスペースごとに匿名の**ワークスペースハートビート**を送信します。これはそのワークスペースの構成プロファイルを示すもので、ワークスペースのデータは一切含まれません： | フィールド | 説明 | |---|---| @@ -92,7 +93,7 @@ space: テレメトリを無効にすると： - クエリデータは送信されません -- インスタンスハートビートは送信されません +- ワークスペースハートビートは送信されません - アンケートの取得・表示は行われません - その他すべての LangBot 機能は通常通り動作します @@ -100,4 +101,4 @@ space: LangBot の発展に伴い、このポリシーを更新する場合があります。変更はリリースノートに記載され、このページに反映されます。 -*最終更新：2026年6月* +*最終更新：2026年7月* diff --git a/zh/insight/data-collection-policy.mdx b/zh/insight/data-collection-policy.mdx index 7459dfd7c..aa5a18416 100644 --- a/zh/insight/data-collection-policy.mdx +++ b/zh/insight/data-collection-policy.mdx @@ -17,7 +17,8 @@ LangBot 收集最少量的匿名遥测数据，以帮助改进产品。本文档 | `model_name` | 查询使用的模型名称（如 `gpt-4o`、`deepseek-chat`） | | `duration_ms` | 查询处理耗时（毫秒） | | `version` | 您正在运行的 LangBot 版本 | -| `instance_id` | 随机生成的 UUID，标识您的 LangBot 实例（首次启动时生成，不与个人身份关联） | +| `workspace_uuid` | 标识查询执行工作区的稳定 UUID。默认自托管工作区与安装 UUID 对齐，不与个人身份关联。 | +| `runtime_instance_id` | 仅托管 SaaS 查询事件发送，用于刷新运行实例的空闲超时活动；不会写入分析事件记录。 | | `pipeline_plugins` | 参与查询的管道插件名称 | | `features` | 本次查询的匿名功能使用计数（见下文） | | `error` | 查询失败时的错误追踪信息（不包含用户内容） | @@ -36,9 +37,9 @@ LangBot 收集最少量的匿名遥测数据，以帮助改进产品。本文档 | `activated_skills` | 本次查询中激活的技能名称 | | `mcp_servers` | 绑定到管道的 MCP 服务器名称（使用"全部启用"时不发送） | -### 实例心跳 +### 工作区心跳 -除每次查询事件外，LangBot 会在启动后不久发送一次匿名**实例心跳**，之后每天发送一次。心跳描述实例的配置概况 — 绝不包含实例数据： +除每次查询事件外，LangBot 会在启动后不久为每个活跃工作区发送一条匿名**工作区心跳**，之后每天发送一次。心跳描述该工作区的配置概况 — 绝不包含工作区数据： | 字段 | 说明 | |---|---| @@ -92,7 +93,7 @@ space: 关闭遥测后： - 不会发送任何查询数据 -- 不会发送实例心跳 +- 不会发送工作区心跳 - 不会获取或展示问卷调查 - 所有其他 LangBot 功能照常运行 @@ -100,4 +101,4 @@ space: 我们可能会随着 LangBot 的发展更新此政策。变更将记录在发布说明中并体现在此页面。 -*最后更新：2026 年 6 月* +*最后更新：2026 年 7 月*