Gunakan SkyWalking untuk melaporkan data aplikasi Node.js - Managed Service for OpenTelemetry

Setelah Anda menggunakan SkyWalking untuk menginstrumentasikan aplikasi dan melaporkan data jejak ke konsol Managed Service for OpenTelemetry, Managed Service for OpenTelemetry mulai memantau aplikasi tersebut. Kemudian, Anda dapat melihat data pemantauan aplikasi, seperti topologi aplikasi, jejak, transaksi abnormal, transaksi lambat, dan analisis SQL. Topik ini menjelaskan cara menggunakan skywalking-backend-js untuk melakukan instrumentasi otomatis dan melaporkan data aplikasi Node.js.

Prasyarat

Memperoleh titik akhir

Konsol baru

Masuk ke konsol Managed Service for OpenTelemetry. Di panel navigasi sebelah kiri, klik Integration Center.
Di halaman Pusat Integrasi, klik kartu SkyWalking di bagian Open Source Frameworks.
Di panel SkyWalking, klik tab Mulai Integrasi, lalu pilih wilayah tempat Anda ingin melaporkan data.
Catatan
Saat mengakses wilayah untuk pertama kalinya, sumber daya akan diinisialisasi secara otomatis.
Konfigurasikan parameter Tipe Koneksi dan salin sebuah titik akhir.
Jika layanan Anda diterapkan di Alibaba Cloud dan berada di wilayah yang dipilih, atur parameter ini ke Alibaba Cloud VPC Network. Jika tidak, atur ke Public Network.

Konsol lama

Masuk ke konsol Managed Service for OpenTelemetry.
Di panel navigasi sebelah kiri, klik Cluster Configurations. Pada halaman yang muncul, klik tab Access point information.
Di bilah navigasi atas, pilih wilayah tempat Anda ingin melaporkan data. Di bagian Cluster Information, aktifkan Show Token.
Atur parameter Client ke SkyWalking.
Di kolom Related Information tabel, salin sebuah titik akhir.
Catatan
Jika aplikasi Anda diterapkan di lingkungan produksi Alibaba Cloud, gunakan titik akhir VPC. Jika tidak, gunakan titik akhir publik.

Informasi latar belakang

SkyWalking adalah layanan pemantauan kinerja aplikasi (APM) populer yang dikembangkan di Tiongkok. SkyWalking dirancang untuk layanan mikro, arsitektur cloud-native, dan kontainer seperti Docker, Kubernetes, dan Mesos. SkyWalking juga merupakan sistem pelacakan terdistribusi.

skywalking-backend-js adalah repositori agen Node.js resmi dari SkyWalking dan dapat dihubungkan ke aplikasi Node.js untuk memantau aplikasi tersebut. Anda dapat menggunakan skywalking-backend-js untuk secara otomatis menginstrumentasikan beberapa repositori pihak ketiga, seperti MySQL, Redis, dan RabbitMQ.

Catatan

skyapm-nodejs adalah versi sebelumnya dari repositori agen Node.js resmi dan sudah tidak digunakan lagi. Kami sarankan Anda menggunakan skywalking-backend-js, versi terbaru dari repositori agen Node.js resmi, untuk memantau aplikasi Node.js.

Tabel berikut menjelaskan repositori pihak ketiga yang dapat dipantau dengan menggunakan skywalking-backend-js.

Repositori	Plug-in
Modul HTTP dan HTTPS bawaan	http / https
Express	express
Axios	axios
MySQL	mysql
MySQL	mysql2
PostgreSQL	pg
pg-cursor	pg-cursor
MongoDB	mongodb
Mongoose	mongoose
RabbitMQ	amqplib
Redis	ioredis
AWS2DynamoDB	aws-sdk
AWS2Lambda	aws-sdk
AWS2SNS	aws-sdk
AWS2SQS	aws-sdk

Kode contoh

Untuk informasi lebih lanjut tentang repositori kode contoh, lihat demo skywalking di GitHub.

Gunakan SkyWalking untuk menginstrumentasikan aplikasi Node.js

Jalankan perintah berikut untuk menginstal agen Node.js SkyWalking:
```
npm install --save skywalking-backend-js
```

Konfigurasikan agen Node.js SkyWalking di proyek Node.js.

const {default: agent} = require("skywalking-backend-js");
agent.start({})

Konfigurasikan parameter agen Node.js SkyWalking.

Anda dapat mengonfigurasi parameter untuk mengkode keras agen Node.js SkyWalking ke dalam proyek Node.js atau mengonfigurasi agen Node.js SkyWalking dengan mendefinisikan variabel lingkungan.

Konfigurasikan parameter untuk mengkode keras agen Node.js SkyWalking ke dalam proyek Node.js

agent.start({
  serviceName: <your-service-name>,                     // Nama layanan, yang digunakan untuk mengidentifikasi aplikasi.
  collectorAddress: <collector-backend-address>,        // Titik akhir kolektor.
  authorization: <collector-token>                      //Token yang digunakan untuk mengakses kolektor.
});

Konfigurasikan agen Node.js SkyWalking dengan mendefinisikan variabel lingkungan

# <endpoint>: titik akhir kolektor. <token>: token otentikasi kolektor. <service-name>: nama aplikasi.

export SW_AGENT_COLLECTOR_BACKEND_SERVICES=<endpoint>
export SW_AGENT_AUTHENTICATION=<token>
export SW_AGENT_NAME=<service-name>

Mulai ulang aplikasi.