Mulai cepat: Memantau aplikasi end-to-end

Artikel
03/08/2024

Catatan

Azure Spring Apps adalah nama baru untuk layanan Azure Spring Cloud. Meskipun layanan memiliki nama baru, Anda akan melihat nama lama di beberapa tempat untuk sementara saat kami berupaya memperbarui aset seperti cuplikan layar, video, dan diagram.

Artikel ini berlaku untuk:❌ Basic/Standard ✔️ Enterprise

Mulai cepat ini menunjukkan kepada Anda cara memantau aplikasi yang menjalankan paket Azure Spring Apps Enterprise dengan menggunakan Application Insights dan Log Analytics.

Catatan

Anda dapat memantau beban kerja Spring anda secara menyeluruh dengan menggunakan alat dan platform apa pun pilihan Anda, termasuk App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic, atau Splunk. Untuk informasi selengkapnya, lihat Bekerja dengan alat pemantauan lainnya nanti di artikel ini.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Pahami dan penuhi bagian Persyaratan paket Enterprise di Marketplace Azure.
Azure CLI versi 2.45.0 atau yang lebih tinggi.
Git.
Ekstensi paket Azure Spring Apps Enterprise. Gunakan perintah berikut untuk menghapus versi sebelumnya dan menginstal ekstensi paket Enterprise terbaru. Jika sebelumnya Anda menginstal ekstensi spring-cloud, hapus instalannya untuk menghindari ketidakcocokan konfigurasi dan versi.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Sumber daya untuk dipantau, seperti yang dibuat dalam mulai cepat berikut:

Memperbarui aplikasi

Anda harus memberikan string koneksi Application Insights secara manual ke aplikasi Order Service (ASP.NET core) dan Cart Service (python). Instruksi berikut menjelaskan cara memberikan string koneksi ini dan meningkatkan tingkat pengambilan sampel ke Application Insights.

Catatan

Saat ini hanya buildpack untuk aplikasi Java dan NodeJS yang mendukung instrumentasi Application Insights.

Buat variabel untuk menahan nama sumber daya dengan menggunakan perintah berikut. Pastikan untuk mengganti placeholder dengan nilai Anda sendiri. Nama instans layanan Azure Spring Apps Anda harus panjangnya antara 4 dan 32 karakter dan hanya dapat berisi huruf kecil, angka, dan tanda hubung. Karakter pertama dari nama layanan harus berupa huruf dan karakter terakhir harus berupa huruf atau angka.
```
export RESOURCE_GROUP="<resource-group-name>"
export APP_INSIGHTS_NAME="<app-insights-name>"
export KEY_VAULT_NAME="<key-vault-name>"
export AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME="<Azure-Spring-Apps-service-instance-name>"
```
Catatan

Secara default, APP_INSIGHTS_NAME sama dengan AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME.

Gunakan perintah berikut untuk mengambil string koneksi Application Insights dan mengaturnya di Key Vault:

export CONNECTION_STRING=$(az monitor app-insights component show \
    --resource-group ${RESOURCE_GROUP} \
    --app ${APP_INSIGHTS_NAME} \
    --query "connectionString" \
    --output tsv)

az keyvault secret set \
    --vault-name ${KEY_VAULT_NAME} \
    --name "ApplicationInsights--ConnectionString" \
    --value ${CONNECTION_STRING}

Gunakan perintah berikut untuk memperbarui laju pengambilan sampel untuk pengikatan Application Insights untuk meningkatkan jumlah data yang tersedia:

az spring build-service builder buildpack-binding set \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --builder-name default \
    --name default \
    --type ApplicationInsights \
    --properties sampling-rate=100 connection_string=${CONNECTION_STRING}

Gunakan perintah berikut untuk memulai ulang aplikasi untuk memuat ulang konfigurasi:

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name cart-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name order-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name catalog-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name frontend

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name payment-service

Jika Anda telah mengonfigurasi akses menyeluruh, gunakan perintah berikut untuk memulai ulang aplikasi untuk memuat ulang konfigurasi aplikasi layanan identitas:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
Untuk aplikasi Java dan NodeJS, menghidupkan ulang akan memungkinkan laju pengambilan sampel baru berlaku. Untuk aplikasi non-Java, menghidupkan ulang akan memungkinkan mereka mengakses Kunci Instrumentasi yang baru ditambahkan dari Key Vault.

Menampilkan log

Ada dua cara untuk melihat log di Azure Spring Apps: streaming log log real-time per instans aplikasi atau Log Analytics untuk log agregat dengan kemampuan kueri tingkat lanjut

Menggunakan streaming log

Hasilkan lalu lintas dalam aplikasi dengan berpindah melalui aplikasi, melihat katalog, dan menempatkan pesanan. Gunakan perintah berikut untuk menghasilkan lalu lintas terus menerus, hingga dibatalkan:

export GATEWAY_URL=$(az spring gateway show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --query "properties.url" \
    --output tsv)

export GATEWAY_URL=https://${GATEWAY_URL} 

cd azure-spring-apps-enterprise/load-test/traffic-generator
./gradlew gatlingRun-com.vmware.acme.simulation.GuestSimulation.java

Gunakan perintah berikut untuk mendapatkan 100 baris terbaru log konsol aplikasi dari aplikasi Catalog Service:

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --lines 100

Dengan menambahkan --follow opsi , Anda bisa mendapatkan streaming log real-time dari aplikasi. Gunakan perintah berikut untuk mencoba streaming log untuk aplikasi Catalog Service:

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --follow

Tip

Anda dapat menggunakan log --help aplikasi az spring untuk menjelajahi lebih banyak parameter dan fungsionalitas aliran log.

Gunakan Analitik Log

Navigasi ke portal Azure dan buka instans Log Analytics yang Anda buat. Anda dapat menemukan instans Analitik Log di grup sumber daya yang sama tempat Anda membuat instans layanan Azure Spring Apps.

Pada halaman Analitik Log, pilih panel Log dan jalankan salah satu kueri sampel berikut untuk Azure Spring Apps.

Ketik dan jalankan kueri Kusto berikut untuk melihat log aplikasi:

AppPlatformLogsforSpring
| where TimeGenerated > ago(24h)
| limit 500
| sort by TimeGenerated
| project TimeGenerated, AppName, Log