遥测（默认开启）

jshookmcp 内置 OpenTelemetry 遥测：把工具调用与搜索行为以标准 OTLP/HTTP 协议导出。默认开启——无需任何配置，数据发送到项目维护者的接收端点（内容最小化，见下表；匿名 install.id 标识）。

想发到自己的后端（自建 opentelemetry-collector、SigNoz、Grafana Cloud）或完全关闭，用以下环境变量。

配置

在 .env（或 MCP server 进程环境）中设置：

# 发到自己的后端：
OTEL_EXPORTER_OTLP_ENDPOINT=<端点地址>
OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer <token>"
# 完全关闭（零网络、零开销）：
JSHOOK_OBSERVABILITY_EXPORTER=none

采集什么（最小化原则）

信号	内容	不包含
tool.execute span	工具名、所属域、耗时、成功/失败	工具参数、响应内容一律不采集
search.query span	查询文本（见下方策略）、top-K、结果数、延迟、BM25 置信分、向量是否参与	检索结果内容
search_feedback_used 指标	被调用工具的排名档位（top1/3/5/10）+ 工具名	—
tool.execute span 的参数	默认仅参数键名（shape——键名本就公开于工具 schema，值永不采集）；显式设 JSHOOK_OTLP_TOOL_ARGS=truncated/full 才采集值，且凭证类键（authorization/cookie/token/secret 等）一律脱敏为 *** 并有总量上限	完整参数值默认不采集
资源标识	service.name=jshookmcp、每次进程的 service.instance.id、匿名随机安装 UUID install.id	无主机名、无用户名、无 IP、无机器指纹——install.id 是首次运行时本地生成的随机 UUID

查询文本策略（JSHOOK_OTLP_QUERY_TEXT）

搜索查询可能包含你自己的敏感信息（目标站 URL、token、样本内容）。默认 truncated 只发送前 64 个字符加溢出标记：

JSHOOK_OTLP_QUERY_TEXT=off         # 完全不发送查询文本（指标仍包含数值统计）
JSHOOK_OTLP_QUERY_TEXT=truncated   # 默认：前 64 字符 + …(+N)
JSHOOK_OTLP_QUERY_TEXT=full        # 完整文本（仅在私有端点下使用）

关闭

删除上述环境变量即恢复默认（no-op，零网络活动）。已生成的匿名 install.id 存于 ~/.jshookmcp/state/install-id，删除该文件即可重置身份。

代理网络：导出器会自动识别 HTTPS_PROXY/ALL_PROXY 环境变量（NO_PROXY 与 localhost 端点始终直连），无需额外配置。

其他后端

JSHOOK_OBSERVABILITY_EXPORTER=memory 将 span/指标保存在进程内存中（诊断用）；none 为默认 no-op。