通過SkyWalking為應用埋點并上報鏈路數據至可觀測鏈路 OpenTelemetry 版后,可觀測鏈路 OpenTelemetry 版即可開始監控應用,您可以查看應用拓撲、調用鏈路、異常事務、慢事務和SQL分析等一系列監控數據。本文介紹如何使用skywalking-backend-js進行自動埋點并上報應用數據。
前提條件
新版控制臺
登錄可觀測鏈路 OpenTelemetry 版控制臺,在左側導航欄單擊接入中心。
在開源框架區域單擊SkyWalking卡片。
在彈出的SkyWalking面板中選擇數據需要上報的地域。
說明初次接入的地域將會自動進行資源初始化。
選擇連接方式,然后復制接入點信息。
若您的服務部署在阿里云上,且所屬地域與選擇的接入地域一致,推薦使用阿里云內網方式,否則選擇公網方式。
舊版控制臺
在左側導航欄單擊集群配置,然后在右側頁面單擊接入點信息頁簽。
在頁面頂部選擇需要接入的地域,然后在集群信息區域打開顯示Token開關。
在客戶端采集工具區域單擊SkyWalking。
在相關信息列中,獲取接入點信息。
說明如果應用部署于阿里云生產環境,則選擇阿里云VPC網絡接入點,否則選擇公網接入點。
背景信息
SkyWalking是一款廣受歡迎的國產APM(Application Performance Monitoring,應用性能監控)產品,主要針對微服務、Cloud Native和容器化(Docker、Kubernetes、Mesos)架構的應用。SkyWalking的核心是一個分布式追蹤系統。
Skywalking-backend-js是SkyWalking的Node.js Agent官方庫,可以通過接入skywalking-backend-js實現對Node.js應用的監控,skywalking-backend-js支持MySQL、Redis、RabbitMQ等多種第三方庫的自動埋點。
SkyAPM-nodejs是舊版的官方庫,已棄用,請使用最新的官方庫skywalking-backend-js監控Node.js應用。
庫 | 插件名 |
built-in http and https module | http / https |
express | |
axios | |
mysql | |
mysql2 | |
pg | |
pg-cursor | |
mongodb | |
mongoose | |
amqplib | |
ioredis | |
aws-sdk | |
aws-sdk | |
aws-sdk | |
aws-sdk |
示例Demo
示例Demo倉庫地址:SkyWalking Demo
用SkyWalking為Node.js應用埋點
執行以下命令安裝skywalking-nodejs版Agent探針。
npm install --save skywalking-backend-js
項目引入Skywalking-NodeJS Agent。
const {default: agent} = require("skywalking-backend-js"); agent.start({})
配置Agent參數。
SkyWalking的Node.js版Agent支持硬編碼和環境變量兩種參數配置方式。
硬編碼
agent.start({ serviceName: <your-service-name>, // 服務名稱,標識應用 serviceInstance: <your-service-instance-name>, // 服務實例名稱 collectorAddress: <collector-backend-address>, // 數據上報collector接入點地址 authorization: <collector-token> // 接入點token });
環境變量配置參數
# <endpoint>: 接入點地址;<token>: 接入點鑒權token;<service-name>: 應用名稱。 export SW_AGENT_COLLECTOR_BACKEND_SERVICES=<endpoint> export SW_AGENT_AUTHENTICATION=<token> export SW_AGENT_NAME=<service-name>
重新啟動應用。