TraceProfileSecuritybeacon
让应用自己，
说出发生了什么。
观测云应用采集器。
从应用内部收集信号，
把请求、代码与运行时连成可理解的上下文。
零代码接入，按需开启性能剖析与运行时安全。
采集有深度，开销有控制。
从一次请求，
走进应用的每一层。
把应用内部的信号带到观测云。切换一种能力，看看 Beacon 如何帮助你理解系统。
Trace / request context示意HTTP request
application
database
outbound call
同一个请求，一条完整调用链。
Profile / call stack示意application
request handler
computeserialize
parseallocateencode
沿着调用栈，深入性能热点。
慢在哪里？
再往代码里看一层。
Java 使用 JFR；Python 提供调用栈、内存、锁与异常采集；Node.js 支持 wall-time 与 heap Profile。把性能排查深入到函数与资源消耗。
了解观测云性能剖析Java JFR 为实验性能力，需 JDK 11+；Python 异常 Profile 需 3.12+。Profile 需单独配置接收端。
Exception / context示意!
exception异常事件span.context所在调用trace.context请求链路把异常，放回发生时的上下文。
Security / data flow示意- source外部输入
- propagation应用内传播
- sink敏感操作
沿数据流，保留风险线索。
让安全线索，
带着应用现场的证据。
Java、Python、Node.js 可按需启用 Security，采集已建模的数据流、安全发现与运行时 SBOM，通过 OTLP Logs 导出。
查看 Beacon Security 文档默认关闭；安全发现是待研判的观测证据，不代表已确认漏洞。
轻量接入。
把开销交给你控制。
需要多少观测能力，由应用决定。独立开关、采样配置与资源预算，让每一份额外工作都有边界。
采样间隔调用栈深度
用合适的粒度看问题Security 队列上限
超限截断 / 丢弃
安全数据有界处理为安全采集设定预算
Java、Python、Node.js 的 Security 对内存、对象、活跃请求与导出队列设置预算，并对事件与字节量限流。安全发现与 SBOM 使用独立的有界队列。
查看资源控制实现示意图不代表实测性能。实际开销取决于运行时、应用负载与开启的能力，建议在预发布环境验证。
看清代码如何运行，
也看清风险从何而来。
安全观测内置于同一个采集器。启用后，从输入、传播、敏感操作到运行时依赖，把分散的线索组织成可追溯的证据。
阅读 Security 文档HTTP 输入应用代码SQL / 命令 / HTTP / 文件
跟踪已建模的数据流，保留传播路径与调用位置。
关联证据 示意
- finding_id
- 稳定风险指纹
- trace / span
- 单次请求上下文
- component
- 运行时组件身份
- validation
- unvalidated
沿着数据流，定位风险入口
在已建模的调用范围内，跟踪外部输入向 SQL、命令执行、出站 HTTP 和文件操作的传播，保留来源、传播路径与调用位置。
同一风险，保留每次请求的线索
稳定指纹关联重复发现，单次发生记录保留各自的 Trace / Span 上下文。完整证据采样与发生记录分开处理，让风险能够回到具体请求。
运行时 SBOM，看见实际依赖
记录运行时组件清单，并将安全发现与组件身份关联，为依赖排查和风险研判补上应用现场的上下文。
采集范围，由你决定。
Security 默认关闭，本地诊断文件默认关闭。Python / Node.js 可通过 include / exclude 指定应用范围；安全发现和 SBOM 复用 OpenTelemetry Logs 管道。
当前面向 Java、Python、Node.js 的支持运行时；安全发现提供观测证据与候选风险，需进一步研判，不代表已确认漏洞或攻击成功。
保留你的代码，
改变启动方式。
选择语言，配置服务名和接收端。
让 Beacon 随应用一起启动。
Java / v1.3.0
curl -fL -o beacon-javaagent.jar \
https://github.com/beacon-observability/beacon-java/releases/download/v1.3.0/beacon-javaagent-1.3.0.jar
export OTEL_SERVICE_NAME=my-service
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4317
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
java -javaagent:./beacon-javaagent.jar -jar app.jar下载 Agent JAR，在原有 JVM 启动参数中挂载。Profile 为实验性 JFR，需 JDK 11+ 并主动开启。
完整接入指南 Python / v1.2.0
pip install 'beacon-otel[fastapi]==1.2.0'
export OTEL_SERVICE_NAME=my-service
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4317
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
beacon uvicorn myapp:app在应用的虚拟环境中安装，并选择对应框架的 extra。此处为 FastAPI 示例，应用及其依赖需已安装。
完整接入指南 Node.js / v1.3.0
npm install @beacon-observability/nodejs@1.3.0
export OTEL_SERVICE_NAME=my-service
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4317
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
node --import @beacon-observability/nodejs/register app.js通过预加载启动应用。零代码接入与 Security 的运行时要求不同，请按对应指南选择 Node.js 版本。
完整接入指南 .NET / v1.0.0
# 安装对应平台的 Beacon .NET 软件包后
beacon-dotnet status
export OTEL_SERVICE_NAME=my-service
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4317
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
beacon-dotnet run dotnet MyApp.dll先从发布页安装对应系统及架构的安装包，再启动应用；run 只对其子进程启用探针。
完整接入指南 PHP / v1.1.2
# 安装原生扩展及 Composer 包后
export OTEL_PHP_AUTOLOAD_ENABLED=true
export OTEL_SERVICE_NAME=my-php-service
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
vendor/bin/beacon-php doctor
php public/index.phpPHP 8.2+，需原生扩展 1.0.1 与 Composer 包 1.1.2。先按文档安装匹配环境的扩展及框架探针。
完整接入指南示例使用本机 OTLP 接收地址。请替换为你的服务名、应用路径和接收端；Profile 需单独配置接收地址。
你的技术栈。
连接已有观测链路。
沿用标准协议与配置，
让应用信号接入已有观测系统。
Application应用
Beacon采集 · 关联
Guance / OTLP观测系统
OTLP 遥测 / 独立 Profile 导出
- 沿用开放协议
- 使用 OTEL 配置和 OTLP 遥测协议，可对接支持的接收端。Profile 按语言提供 JFR 或 pprof 等导出方式，与已有观测链路衔接。
- 为应用兼容性做设计
- Java 沿用 Muzzle 兼容性检查与类加载隔离，在运行时跳过不匹配的插桩；.NET 的 run 命令仅为子进程启用 Agent，便于控制接入范围。
- 来源与交付可追溯
- 各语言独立维护上游来源、版本与发布记录。Java 正式发布提供校验和、SPDX SBOM 与构建来源证明，便于核验下载的制品。
Java v1.3.0
Java Agent字节码自动插桩；Spring AI / Alibaba Agent 扩展Profile：实验性 JFR · Security：可选开启
GitHub ReleasesPython v1.2.0
CLI + 按需插件调用栈、内存、锁与异常 Profile 按需采集Profile：可选 pprof · Security：可选开启
GitHub ReleasesNode.js v1.3.0
模块预加载wall-time / heap Profile；限定源码范围的 SecurityProfile：可选 pprof · Security：可选开启
GitHub Releases.NET v1.0.0
启动包装器CLR 自动插桩；run 隔离启用范围到子进程Profile：— · Security：—
GitHub ReleasesPHP v1.1.2
原生扩展 + SDK原生 Hook 与官方 OpenTelemetry Composer 生态组合Profile：— · Security：—
GitHub Releases版本核验于 2026-10-21，各语言独立发布。PHP 另需原生扩展 1.0.1；“—”表示当前未提供对应的已发布用户能力。完整兼容性以各语言发布说明为准。
从你的应用，
开始观测。
选择适合技术栈的接入方式，
让每一次请求，都留下可追溯的线索。