Application Real-Time Monitoring Service:Laporkan data aplikasi .NET dengan SkyWalking

Informasi latar belakang

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

Prasyarat

Dapatkan titik akhir SkyWalking dan token otentikasi dari Konsol ARMS:

1. Masuk ke Konsol Managed Service for OpenTelemetry.

2. Di panel navigasi kiri, klik Cluster Configurations. Lalu, klik tab Access point information.

3. Di bilah navigasi atas, pilih Wilayah. Di bagian Cluster Information, aktifkan Show Token.

4. Di bagian Client, klik SkyWalking.

5. Salin titik akhir dan token dari kolom Related Information.

   

Instal agen

Dari direktori root Proyek .NET Anda, instal paket NuGet SkyAPM dan atur variabel lingkungan yang diperlukan:

# Install the SkyAPM agent package
dotnet add package SkyAPM.Agent.AspNetCore

# Set the required environment variables
export ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore
export SKYWALKING__SERVICENAME=<your-service-name>

Ganti <your-service-name> dengan nama yang mengidentifikasi aplikasi Anda di Konsol ARMS (misalnya, my-dotnet-app).

Konfigurasi agen

Buat file konfigurasi skyapm.json untuk menentukan titik akhir pelaporan. Pilih salah satu metode berikut:

# Install the CLI tool
dotnet tool install -g SkyAPM.DotNet.CLI

# Add the tool to your PATH (replace /path/to with the actual path to your .dotnet directory)
export PATH="$PATH:/path/to/.dotnet/tools/"

# Generate skyapm.json
dotnet skyapm config <your-service-name> <your-endpoint>

{
  "SkyWalking": {
    "ServiceName": "<your-service-name>",
    "Namespace": "",
    "HeaderVersions": [
      "sw8"
    ],
    "Sampling": {
      "SamplePer3Secs": -1,
      "Percentage": -1.0,
      "LogSqlParameterValue": false
    },
    "Logging": {
      "Level": "Information",
      "FilePath": "logs/skyapm-{Date}.log"
    },
    "Transport": {
      "Interval": 3000,
      "ProtocolVersion": "v8",
      "QueueSize": 30000,
      "BatchSize": 3000,
      "gRPC": {
        "Servers": "<your-endpoint>",
        "Authentication": "<your-token>",
        "Timeout": 100000,
        "ConnectTimeout": 100000,
        "ReportTimeout": 600000
      }
    }
  }
}

Jalankan aplikasi dan verifikasi

1. Jalankan (atau restart) aplikasi .NET Anda:

   dotnet run

2. Kirim beberapa permintaan ke aplikasi Anda untuk menghasilkan data jejak.

3. Masuk ke Konsol Managed Service for OpenTelemetry dan periksa apakah data jejak muncul.

Pemecahan masalah dengan log agen

Jika tidak ada data jejak yang muncul di Konsol, periksa file log agen di logs/skyapm-<date>.log di direktori proyek Anda. File ini mencatat upaya koneksi, error, dan aktivitas pelaporan data.

Bangun agen dari kode sumber (opsional)

Untuk membangun agen SkyAPM .NET dari kode sumber:

# Clone the source repository
git clone https://github.com/SkyAPM/SkyAPM-dotnet.git

# Navigate to the project root
cd SkyAPM-dotnet/

# Check out the desired version tag
git checkout <tag-name>

# Initialize and update submodules
git submodule init
git submodule update

# Restore dependencies and build
dotnet restore
dotnet build src/SkyApm.Transport.Grpc.Protocol
dotnet build skyapm-dotnet.sln

Kode contoh

Untuk contoh lengkap yang berfungsi, lihat repositori skywalking-demo di GitHub.

FAQ

Perintah dotnet skyapm config gagal menghasilkan file skyapm.json. Bagaimana cara memperbaikinya?

Coba salah satu solusi berikut:

• Buat file skyapm.json secara manual (disarankan): Tool CLI hanya menghasilkan file konfigurasi. Ikuti petunjuk di Metode 2: Buat secara manual untuk membuat file dan mengonfigurasi parameter yang diperlukan secara langsung.

• Beralih ke .NET 6.0: Tool CLI mungkin tidak kompatibel dengan versi .NET yang sedang Anda gunakan. Instal dan gunakan .NET 6.0 untuk menjalankan tool CLI tersebut.