通过OpenTelemetry上报Node.js应用数据

步骤一：获取接入点信息

1. 登录ARMS控制台，在左侧导航栏选择应用监控 > 应用列表。
2. 在应用列表页面顶部选择目标地域，然后单击目标链路追踪应用名称。
   说明 语言列显示图标的应用为接入应用监控的应用，显示-图标的应用为接入链路追踪的应用。
3. 在弹出的页面中，单击左侧导航栏上方的图标，返回上一层。
4. 在左侧导航栏单击集群配置，然后在右侧页面单击接入点信息页签。
5. 在页面顶部选择需要接入的地域，然后在集群信息区域打开显示Token开关。
6. 在客户端采集工具区域单击OpenTelemetry。
7. 在下方表格的相关信息列中，获取接入点信息（Endpoint）和鉴权Token（Authentication）。
   

   说明 如果需要将应用部署于阿里云生产环境，则接入点选阿里云VPC网络下的Endpoint，否则选择公网Endpoint。

步骤二：部署应用

1. 创建Provider。

   const { Resource } = require("@opentelemetry/resources");
   const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");
   const {
     SemanticResourceAttributes,
   } = require("@opentelemetry/semantic-conventions");
   
   const provider = new NodeTracerProvider({
     resource: new Resource({
       [SemanticResourceAttributes.HOST_NAME]: require("os").hostname(),
       [SemanticResourceAttributes.SERVICE_NAME]: "opentelemetry-express",    //opentelemetry-express可替换为任意名称。
     }),
   });

2. 通过Provider注册HTTP和Express框架，自动监测并拦截HTTP和Express。
   说明 如需监测其他框架下的Node.js应用，请参见OpenTelemetry官方文档。

   const { registerInstrumentations } = require("@opentelemetry/instrumentation");
   const { HttpInstrumentation } = require("@opentelemetry/instrumentation-http");
   const {
     ExpressInstrumentation,
   } = require("@opentelemetry/instrumentation-express");
   
   registerInstrumentations({
     tracerProvider: provider,
     instrumentations: [new HttpInstrumentation(), ExpressInstrumentation],
   });

3. 配置Exporter，导出数据到ARMS链路追踪。
   请将下面代码中的<ENDPOINT>和<AUTHENTICATION>替换成步骤一中获取的Endpoint和Authentication。

   const metadata = new grpc.Metadata();
   metadata.set("Authentication", "<AUTHENTICATION>");
   
   const exporter = new OTLPTraceExporter({ url: "<ENDPOINT>", metadata });
   provider.addSpanProcessor(new SimpleSpanProcessor(exporter));
   provider.register();

4. 可选：添加自定义事件和属性。
   说明 OpenTelemetry API的使用方法，请参见OpenTelemetry官方文档。

   const api = require("@opentelemetry/api");
   const currentSpan = api.trace.getSpan(api.context.active());
   currentSpan.addEvent("timestamp", { value: Date.now() });
   currentSpan.setAttribute("tagKey-01", "tagValue-01");

在控制台查看Trace

登录ARMS控制台后，在应用监控 > 应用列表页面选择目标应用，查看链路数据。

说明 语言列显示图标的应用为接入应用监控的应用，显示-图标的应用为接入链路追踪的应用。