Managed Service for OpenTelemetry：通過OpenTelemetry上報Node.js應用資料

背景資訊

OpenTelemetry提供了若干自動埋點外掛程式，支援為常見架構自動建立Span，支援的架構列表如下，完整資訊請參見OpenTelemetry官方文檔。

樣本Demo

範例程式碼倉庫地址：opentelemetry-nodejs-demo

方法一：自動埋點（推薦）

1. 下載運行專案所需的依賴。

   cd auto-instrumentation
   
   npm init -y
   npm install express
   npm install axios

2. 下載OpenTelemetry自動埋點所需的依賴。

   npm install --save @opentelemetry/api
   npm install --save @opentelemetry/auto-instrumentations-node

3. 編寫應用代碼。

   以下代碼是通過Express實現的簡單應用樣本：

   "use strict";
   
   const axios = require("axios").default;
   const express = require("express");
   const app = express();
   
   app.get("/", async (req, res) => {
     const result = await axios.get("http://localhost:7001/hello");
     return res.status(201).send(result.data);
   });
   
   app.get("/hello", async (req, res) => {
     console.log("hello world!")
     res.json({ code: 200, msg: "success" });
   });
   
   app.use(express.json());
   
   app.listen(7001, () => {
     console.log("Listening on http://localhost:7001");
   });

4. 通過環境變數設定OpenTelemetry參數並運行應用。

   請將${httpEndpoint}替換為前提條件中擷取的HTTP存取點，請將${serviceName}替換為您的應用程式名稱。

   export OTEL_TRACES_EXPORTER="otlp"
   export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${httpEndpoint}"
   export OTEL_NODE_RESOURCE_DETECTORS="env,host,os"
   export OTEL_SERVICE_NAME="${serviceName}"
   export NODE_OPTIONS="--require @opentelemetry/auto-instrumentations-node/register"
   node main.js

   說明

   有關OpenTelemetry環境變數的說明，請參見OpenTelemetry Node.js自動埋點配置。

5. 訪問應用。

   通過以下命令訪問應用，或者直接在瀏覽器中訪問該地址，即可產生調用鏈並上報至Managed Service for OpenTelemetry。

   curl localhost:7001/hello

方法二：手動埋點

1. 在package.json中配置對OpenTelemetry的依賴。

    "dependencies": {
       "@opentelemetry/api": "^1.0.4",
       "@opentelemetry/exporter-trace-otlp-grpc": "^0.27.0",
       "@opentelemetry/instrumentation": "^0.27.0",
       "@opentelemetry/instrumentation-express": "^0.27.0",
       "@opentelemetry/instrumentation-http": "^0.27.0",
       "@opentelemetry/resources": "^1.0.1",
       "@opentelemetry/sdk-trace-base": "^1.0.1",
       "@opentelemetry/sdk-trace-node": "^1.0.1"
     }

2. 建立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可替換為任意名稱。
     }),
   });

3. 通過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],
   });

4. 配置Exporter，匯出資料到Managed Service for OpenTelemetry。

   請將下面代碼中的<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();

5. 可選：添加自訂事件和屬性。

   說明

   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

在可觀測鏈路 OpenTelemetry 版控制台的應用列表頁面選擇目標應用，查看鏈路資料。