Bagikan melalui

Membaca data aplikasi real time dengan Dasbor .NET Aspire di Azure Container Apps (pratinjau)

  • Artikel

Dasbor .NET Aspire menampilkan data langsung tentang bagaimana aplikasi dan sumber daya lain berjalan dalam lingkungan.

Gambar berikut adalah cuplikan layar visualisasi pelacakan yang dihasilkan oleh Dasbor .NET Aspire.

Cuplikan layar jendela pelacakan Dasbor .NET Aspire.

Informasi yang ditampilkan di dasbor berasal dari dua sumber:

  • OpenTelemetry (OTel), pustaka sumber terbuka untuk melacak jejak, metrik, dan log untuk aplikasi Anda. Dokumentasi ini menyediakan informasi selengkapnya tentang bagaimana dasbor Aspire terintegrasi dengan OTel.

    • Jejak melacak siklus hidup permintaan - bagaimana permintaan diterima dan diproses saat bergerak di antara berbagai bagian aplikasi. Informasi ini berguna untuk mengidentifikasi hambatan dan masalah lainnya.
    • Metrik adalah pengukuran real time dari kesehatan umum dan performa infrastruktur - misalnya, berapa banyak sumber daya CPU yang digunakan dan berapa banyak transaksi yang ditangani aplikasi per detik. Informasi ini berguna untuk memahami respons aplikasi Anda atau mengidentifikasi tanda peringatan dini masalah performa.
    • Log merekam semua peristiwa dan kesalahan yang terjadi selama menjalankan aplikasi. Informasi ini berguna untuk menemukan kapan masalah terjadi dan berkorelasi peristiwa.

  • API Kubernetes menyediakan informasi tentang pod Kubernetes yang mendasar tempat aplikasi Anda berjalan dan lognya.

Dasbor diamankan terhadap akses dan modifikasi yang tidak sah. Untuk menggunakan dasbor, pengguna harus memiliki izin 'Tulis' atau lebih tinggi - dengan kata lain, mereka harus menjadi Kontributor atau Pemilik di lingkungan.

Aktifkan dasbor

Tip

Meskipun Anda memiliki portal sebagai opsi, pendekatan yang disarankan untuk mengaktifkan dasbor Anda adalah dengan azd. Jika Anda mengalami masalah menggunakan portal, buat masalah di repositori GitHub Container Apps.

Anda dapat mengaktifkan Dasbor .NET Aspire pada aplikasi kontainer yang ada menggunakan langkah-langkah berikut.

  1. Buka portal Azure.

  2. Telusuri ke aplikasi kontainer Anda.

  3. Di halaman Gambaran Umum , temukan label Dasbor .NET Aspire, dan pilih aktifkan. Tindakan ini membuka halaman pengaturan Dasbor .NET Aspire.

  4. Di halaman pengaturan, di samping label Dasbor .NET Aspire, pilih kotak centang Diaktifkan . Anda dapat mengabaikan pengaturan lain di halaman ini, karena berkaitan dengan pengelogan daripada ke Dasbor .NET Aspire.

  5. Di halaman Gambaran Umum untuk aplikasi kontainer Anda, temukan label Dasbor .NET Aspire. Tautan aktifkan telah digantikan oleh tautan Buka dasbor. Pilih tautan ini. Anda mungkin perlu memuat ulang halaman Gambaran Umum agar tautan muncul.

Anda juga dapat menemukan pengaturan Dasbor .NET Aspire dengan menelusuri ke lingkungan Aplikasi Kontainer Anda dan memilih opsi Pemantauan Pengelogan>.

Anda dapat mengaktifkan Dasbor .NET Aspire pada lingkungan aplikasi kontainer yang ada dengan menggunakan perintah berikut. <PLACEHOLDERS> Ganti dengan nilai Anda.

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name aspire-dashboard \
  --resource-group <RESOURCE_GROUP_NAME>

Perintah create mengembalikan URL dasbor yang dapat Anda buka di browser.

Anda dapat mengaktifkan Dasbor .NET Aspire pada aplikasi kontainer yang ada menggunakan langkah-langkah berikut.

dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up

Perintah up mengembalikan URL dasbor yang dapat Anda buka di browser.

Pemecahan Masalah

Lihat item berikut jika Anda mengalami masalah saat mengaktifkan dasbor Anda:

  • Portal dapat memakan waktu hingga dua menit agar dasbor diaktifkan. Jika Anda mencoba masuk ke dasbor sebelum siap, server mengembalikan 404 kesalahan atau 421 .

  • Jika Anda mengalami 421 kesalahan "Permintaan yang Salah Diarahkan", tutup jendela browser, tunggu beberapa menit, dan coba lagi.

  • Anda mungkin menerima kesalahan autentikasi saat mengakses dasbor yang berbunyi, "Tidak dapat mengautentikasi pengguna dengan sumber daya yang diminta."

    Masalah ini terjadi karena izin grup keamanan tidak menyebar ke Lingkungan Aplikasi Kontainer. Untuk mengatasi masalah ini, pastikan Anda secara eksplisit memberikan peran Kontributor atau Pemilik pada lingkungan Container Apps Anda. Hal ini dapat dilakukan melalui langkah-langkah berikut:

    • Navigasi ke Sumber Daya:
      • Buka Portal Microsoft Azure dan cari lingkungan aplikasi kontainer Anda.
    • Akses Bilah Kontrol Akses (IAM):
      • Klik Access Control (IAM) untuk lingkungan aplikasi kontainer.
    • Verifikasi Penetapan Peran yang Ada:
      • Periksa apakah Anda (atau akun Anda) diberi peran apa pun. Perhatikan bahwa izin saat ini tidak disebarluaskan melalui kelompok keamanan.
      • Jika tidak, ikuti langkah-langkah yang tersisa untuk menetapkan peran.
    • Penetapan Peran Eksplisit: - Klik Tambahkan > penetapan peran. - Pilih Peran: Kontributor atau Pemilik, sesuai untuk tingkat akses yang diperlukan. - Tetapkan peran secara eksplisit ke akun pengguna Anda (misalnya, youremail@domain.com).
    • Simpan dan Konfirmasi:
      • Simpan perubahan. Pastikan peran terlihat di bawah bagian Penetapan Peran.
    • Verifikasi Akses Dasbor:
      • Uji dengan mencoba mengakses dasbor Aspire. Jika Anda terus mendapatkan kesalahan, silakan hubungi tim kami.

Konten terkait

Gambaran umum dasbor .NET Aspire