Wuying GuestOS Observer JavaScript

功能

* 记录埋点和Trace数据
* 埋点的数据格式是JSON对象，包含埋点名称（eventName）、时间（time）、属性（properties）和一些其它的配置信息，比如实例名称、版本等信息。
* Trace数据格式是JSON对象，包含TraceID、SpanID、ParentSpanID、Name、Kind、StartTime、EndTime、Duration、Attributes、Events、Links、StatusCode、StatusMessage等信息。以SLS Trace数据格式输出到本地文件。

使用方法

1. 创建一个Node.js项目
2. 使用示例可以参考examples/demo.js

``javascript
const { init, shutdown, newSpanAsCurrent, newTrackPoint } = require('wobs-js');

if (require.main === module) {
// 初始化observer，指定trackpoint和trace文件存放目录，这里设置为当前路径，默认可不填，和C++、Golang版本保持一致
init("test", './', './');

// 创建一个span，并设置属性和事件
const span = newSpanAsCurrent("test_trace");
// 设置属性
span.setAttribute("key", "value");
// 添加事件
span.addEvent("event1", {"event_attr": "event_value"});
// 如果失败了，设置trace的状态和错误信息
span.setStatus(getStatus(false), "error message");
// 记录一个埋点
newTrackPoint("test_trace");
span.end();

// 程序结束后关闭observer，这一步是可选的
shutdown();
}
`

$3

创建span时，可以指定trace_id和span_id，这样trace_id和span_id就会作为span的父span，从而实现链路追踪。

`javascript
const span = newSpanAsCurrent("test_trace", "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "xxxxxxxxxxxxxxxx");
span.setAttribute("key", "value");
span.end();
`

$3


SDK 支持从配置文件 wobs.config.json 中动态读取 userAliUid，并自动将其附加到埋点数据中。

配置文件路径（根据平台自动选择）：
- 云手机（Android）: /data/vendor/log/wuying/wobs.config.json
- Windows: C:\ProgramData\wuying\wobs.config.json
- Linux/macOS: /var/log/wuying/wobs.config.json

配置文件格式：
`json
{
"userAliUid": "1234567890",
"appInstanceId": "ai-xxx",
"appInstanceGroupId": "aig-xxxx"
}
`

功能特性：
- SDK 初始化时自动读取配置文件中的 userAliUid、appInstanceId 和 appInstanceGroupId
- 使用 fs.watch() 实时监控配置文件变化（创建、修改、重命名）
- 无需重启程序，配置文件的修改会立即生效
- 所有字段自动附加到埋点数据的用户信息字段中

测试示例：
`bash
node examples/test_userAliUid.js
``

依赖

* Node.js >= 12.0.0

Windows平台支持

在Windows平台上，本SDK支持从注册表读取用户和系统信息，包括：
* 阿里云EDS Agent相关信息
* Windows版本信息
* 用户桌面和实例信息

注册表读取通过Node.js的child_process模块调用Windows的reg命令实现，无需额外的依赖包。