通過Jaeger為應用埋點并上報鏈路數據至可觀測鏈路 OpenTelemetry 版后,可觀測鏈路 OpenTelemetry 版即可開始監控應用,您可以查看應用拓撲、調用鏈路、異常事務、慢事務和SQL分析等一系列監控數據。本文介紹如何使用Jaeger客戶端埋點并上報Node.js應用數據。
重要
為獲得更豐富的功能、更先進的鏈路追蹤能力,以及最佳使用體驗,建議您使用OpenTelemetry協議將應用接入可觀測鏈路 OpenTelemetry 版。
我們為您提供了詳細的OpenTelemetry接入指南和最佳實踐,幫助您快速上手可觀測鏈路 OpenTelemetry 版。更多信息,請參見接入應用。
前提條件
在Node工程的Package中配置對Jaeger Client的依賴。
"dependencies": { "jaeger-client": "^3.12.0" }
登錄ARMS控制臺,在左側導航欄單擊接入中心。
在服務端應用區域單擊Jaeger卡片。
在彈出的Jaeger面板中選擇數據需要上報的地域。
說明初次接入的地域將會自動進行資源初始化。
選擇連接方式和上報方式,然后復制接入點信息。
連接方式:若您的服務部署在阿里云上,且所屬地域與選擇的接入地域一致,推薦使用阿里云內網方式,否則選擇公網方式。
上報方式:根據客戶端支持的協議類型選擇HTTP或gRPC協議上報數據。
背景信息
不通過Jaeger Agent而直接上報數據的原理如下圖所示。
通過Jaeger Agent上報數據的原理如下圖所示。
操作步驟
初始化配置。
說明請將
<endpoint>
替換成前提條件中獲取的接入點信息。const initTracer = require("jaeger-client").initTracer; const config = { serviceName: 'node-service', sampler: { type: "const", param: 1 }, reporter: { collectorEndpoint: "<endpoint>" }, };
創建Tracer實例對象。
const tracer = initTracer(config);
創建Span實例對象。
const span = tracer.startSpan("say-hello"); // 設置標簽(可選,支持多個) span.setTag("tagKey-01", "tagValue-01"); // 設置事件(可選,支持多個) span.log({event: "timestamp", value: Date.now()}); // 標記Span結束 span.finish();
登錄可觀測鏈路 OpenTelemetry 版控制臺并查看調用鏈。
基于Express的完整示例
const express = require("express");
const initTracer = require("jaeger-client").initTracer;
const app = express();
const config = {
serviceName: 'node-service',
sampler: {
type: "const",
param: 1
},
reporter: {
collectorEndpoint: "<endpoint>"
},
};
const tracer = initTracer(config);
app.all('*', function (req, res, next) {
req.span = tracer.startSpan("say-hello");
next();
});
app.get("/api", function (req, res) {
const span = req.span;
span.log({event: "timestamp", value: Date.now()});
req.span.finish();
res.send({code: 200, msg: "success"});
});
app.listen(3000, '127.0.0.1', function () {
console.log('start');
});
文檔內容是否對您有幫助?