Menjelajahi dasbor .NET.NET Aspire
Di bagian mendatang, Anda menemukan cara membuat proyek .NET.NET Aspire dan memulai tugas berikut:
Selidiki kemampuan dasbor dengan menggunakan aplikasi yang dihasilkan dari templat proyek seperti yang dijelaskan dalam mulai cepat : Bangun proyek .NET.NET Aspire pertama Anda.
Pelajari fitur aplikasi dasbor .NET.NET Aspire.
Cuplikan layar yang ditampilkan dalam artikel ini menampilkan tema gelap. Untuk informasi selengkapnya tentang pemilihan tema, lihat pilihan Tema .
Autentikasi dasbor
Saat Anda menjalankan host aplikasi .NET.NET Aspire, orkestrator memulai semua sumber daya dependen aplikasi lalu membuka jendela browser ke dasbor. Dasbor .NET.NET Aspire memerlukan autentikasi berbasis token untuk penggunanya karena menampilkan variabel lingkungan dan informasi sensitif lainnya.
Ketika dasbor diluncurkan dari Visual Studio atau Visual Studio Code (dengan ekstensi C# Dev Kit), browser secara otomatis masuk, dan dasbor terbuka secara langsung. Ini adalah pengalaman pengembang yang khas
Namun, jika Anda memulai host aplikasi dari baris perintah, Anda disajikan dengan halaman masuk. Jendela konsol menampilkan URL yang dapat Anda pilih untuk membuka dasbor di browser Anda.
URL berisi string kueri token (dengan nilai token yang dipetakan ke bagian nama t
) yang digunakan untuk masuk ke dasbor. Jika konsol mendukungnya, Anda dapat menahan kunci Ctrl lalu memilih tautan untuk membuka dasbor di browser Anda. Metode ini lebih mudah daripada menyalin token dari konsol dan menempelkannya ke halaman login. Jika Anda berakhir di halaman masuk dasbor tanpa salah satu metode yang dijelaskan sebelumnya, Anda selalu dapat kembali ke konsol untuk menyalin token.
Halaman masuk menerima token dan memberikan instruksi bermanfaat tentang cara mendapatkan token, seperti yang ditunjukkan pada cuplikan layar berikut:
Setelah menyalin token dari konsol dan menempelkannya ke halaman login, pilih tombol Masuk.
Dasbor mempertahankan token sebagai browser persisten cookie, yang tetap berlaku selama tiga hari. Cookie persisten memiliki tanggal kedaluwarsa dan tetap valid bahkan setelah menutup browser. Ini berarti bahwa pengguna tidak perlu masuk lagi jika mereka menutup dan membuka kembali browser. Untuk informasi selengkapnya, lihat pertimbangan Keamanan untuk menjalankan dasbor .NET.NET Aspire dokumentasi.
Halaman sumber daya
Halaman Sumber Daya
- apiservice: Proyek API back-end yang dibangun menggunakan API Minimal.
- webfrontend : Proyek antarmuka pengguna front-end yang dibangun menggunakan Blazor.
Dasbor juga menyediakan detail penting tentang setiap sumber daya:
- Jenis: Menampilkan apakah sumber daya adalah proyek, kontainer, atau dapat dieksekusi.
- Nama: Nama sumber daya.
- Status: Menampilkan apakah sumber daya sedang berjalan atau tidak.
- Waktu mulai: Saat sumber daya mulai berjalan.
- Sumber : Lokasi sumber daya pada perangkat.
- Titik Akhir: Satu atau beberapa URL untuk menjangkau sumber daya yang sedang berjalan secara langsung.
- Log: Tautan ke halaman log sumber daya.
-
Tindakan: Serangkaian tindakan yang dapat dilakukan pada sumber daya:
- Hentikan / Mulai: Hentikan (atau Mulai) sumber daya—tergantung pada status saat ini.
- Konsol: Navigasikan ke log konsol sumber daya.
-
Elipsis: Submenu dengan tindakan spesifik sumber daya tambahan:
- Lihat detail: Lihat detail sumber daya.
- Konsol: Navigasikan ke log konsol sumber daya.
- Log terstruktur: Navigasikan ke log terstruktur sumber daya.
- Jejak: Navigasikan ke jejak sumber daya.
- Metrik: Navigasikan ke metrik sumber daya.
- Mulai ulang: Hentikan lalu mulai sumber daya.
Pertimbangkan cuplikan layar halaman sumber daya berikut:
Tindakan sumber daya
Setiap sumber daya memiliki serangkaian tindakan yang tersedia yang diaktifkan secara kondisional berdasarkan status sumber daya saat ini. Misalnya, jika sumber daya berjalan, tindakan Hentikan diaktifkan. Jika sumber daya dihentikan, tindakan Mulai
Menghentikan atau Memulai sumber daya
Dasbor .NET.NET Aspire memungkinkan Anda menghentikan atau memulai sumber daya dengan memilih tombol Hentikan atau Mulai di kolom Tindakan. Pertimbangkan cuplikan layar halaman sumber daya berikut dengan tombol Hentikan dipilih:
Saat Anda memilih Hentikan, sumber daya berhenti berjalan, dan status pembaruan kolom untuk mencerminkan perubahan.
Nota
Untuk sumber daya proyek, ketika debugger dilampirkan, debugger dipasang kembali saat dimulai ulang.
Tombol Mulai kemudian diaktifkan, memungkinkan Anda untuk memulai sumber daya lagi. Selain itu, dasbor menampilkan pemberitahuan toast dari hasil tindakan:
Saat sumber daya dalam status tidak berjalan, tombol Mulai diaktifkan. Memilih
Ujung
Sumber daya yang bergantung pada sumber daya lain yang dihentikan, atau dimulai ulang, mungkin mengalami kesalahan sementara. Ini adalah perilaku yang diharapkan dan biasanya diselesaikan ketika sumber daya dependen berada dalam status Berjalan sekali lagi.
Tindakan submenu sumber daya
Memilih ikon elipsis horizontal di kolom Tindakan membuka submenu dengan tindakan khusus sumber daya tambahan. Selain tindakan submenu sumber daya bawaan, Anda juga dapat menentukan tindakan sumber daya kustom dengan menentukan perintah kustom. Untuk informasi selengkapnya, lihat perintah sumber daya kustom di .NET.NET Aspire. Untuk tindakan submenu sumber daya bawaan, pertimbangkan cuplikan layar berikut:
Tindakan submenu berikut ini tersedia:
- Lihat detail: Lihat detail sumber daya.
- Konsol: Navigasikan ke log konsol sumber daya.
- Log terstruktur: Navigasikan ke log terstruktur sumber daya.
- Jejak: Navigasikan ke jejak sumber daya.
- Metrik: Navigasikan ke metrik sumber daya.
- Mulai ulang: Hentikan lalu mulai sumber daya.
Penting
Mungkin ada sumber daya dengan tindakan submenu yang dinonaktifkan. Mereka berwarna abu-abu saat dinonaktifkan. Misalnya, cuplikan layar berikut menunjukkan tindakan submenu yang dinonaktifkan:
Salin atau Buka di visualizer teks
Untuk melihat visualisasi teks
- Salin ke clipboard
- Buka di visualizer teks
Pertimbangkan cuplikan layar opsi menu elipsis berikut:
Saat Anda memilih opsi Buka di visualizer teks, dialog modal terbuka dengan teks yang ditampilkan dalam format yang lebih besar. Pertimbangkan cuplikan layar dialog modal visualizer teks berikut:
Beberapa nilai diformat sebagai JSON atau XML. Dalam kasus ini, visualizer teks memungkinkan Pilih format dropdown untuk beralih di antara format yang berbeda.
Detail sumber daya
Anda bisa mendapatkan detail lengkap tentang setiap sumber daya dengan memilih tombol elipsis di kolom Tindakan
Bilah pencarian di kanan atas dasbor juga menyediakan opsi untuk memfilter daftar, yang berguna untuk .NET.NET Aspire proyek dengan banyak sumber daya. Untuk memilih tipe sumber daya yang ditampilkan, turunkan panah di sebelah kiri kotak teks filter:
Dalam contoh ini, hanya kontainer yang ditampilkan dalam daftar. Misalnya, jika Anda mengaktifkan Gunakan Redis untuk penembolokan saat membuat proyek .NET Aspire, Anda akan melihat kontainer Redis tercantum:
Executable adalah proses yang berdiri sendiri. Anda dapat mengonfigurasi proyek .NET.NET Aspire untuk menjalankan executable yang berdiri sendiri selama startup, meskipun templat starter default tidak menyertakan executable secara default.
Cuplikan layar berikut menunjukkan contoh proyek yang memiliki kesalahan:
Memilih lencana jumlah kesalahan menavigasi ke halaman log terstruktur
Untuk melihat entri log secara rinci untuk kesalahan, pilih tombol Tampilkan untuk membuka jendela di bawah daftar dengan detail entri log terstruktur:
Untuk informasi selengkapnya dan contoh log Terstruktur, lihat bagian halaman log Terstruktur
Nota
Halaman sumber daya tidak tersedia jika dasbor dimulai tanpa layanan sumber daya yang dikonfigurasi. Dasbor dimulai pada halaman log terstruktur sebagai gantinya. Ini adalah pengalaman default saat dasbor dijalankan dalam mode mandiri tanpa konfigurasi tambahan.
Untuk informasi selengkapnya tentang mengonfigurasi layanan sumber daya, lihat konfigurasi Dasbor .
Halaman pemantauan
Dasbor .NET.NET Aspire menyediakan berbagai cara untuk melihat log, jejak, dan metrik untuk aplikasi Anda. Informasi ini memungkinkan Anda melacak perilaku dan performa aplikasi Anda dan mendiagnosis masalah apa pun yang muncul.
Halaman log konsol
Halaman log Konsol
Saat membuka halaman Log konsol, Anda harus memilih sumber di daftar drop-down Pilih sumber daya.
Jika Anda memilih proyek, log langsung dirender dengan sekumpulan warna bergaya yang sesuai dengan tingkat keparahan log; hijau untuk informasi sebagai contoh. Pertimbangkan contoh cuplikan layar log proyek berikut dengan proyek apiservice
dipilih:
Saat kesalahan terjadi, kesalahan tersebut ditata dalam log sehingga mudah diidentifikasi. Pertimbangkan contoh cuplikan layar log proyek berikut dengan kesalahan:
Jika Anda memilih kontainer atau dapat dieksekusi, pemformatan berbeda dari proyek tetapi informasi perilaku verbose masih tersedia. Pertimbangkan contoh cuplikan layar log kontainer berikut dengan kontainer cache
dipilih:
Replika sumber daya
Saat sumber daya proyek direplikasi menggunakan API WithReplicas, sumber daya diwakili dalam pemilih sumber daya di bawah entri sumber daya bernama tingkat atas dengan ikon ke indikator. Setiap sumber daya yang direplikasi tercantum di bawah entri sumber daya tingkat atas, dengan nama unik yang sesuai. Pertimbangkan contoh cuplikan layar berikut dari sumber daya proyek yang direplikasi:
Cuplikan layar sebelumnya menunjukkan proyek catalogservice (application)
dengan dua replika, catalogservice-2bpj2qdq6k
dan catalogservice-6ljdin0hc0
. Setiap replika memiliki sekumpulan log sendiri yang dapat dilihat dengan memilih nama replika.
Halaman log terstruktur
.NET Aspire secara otomatis mengonfigurasi proyek Anda dengan pengelogan menggunakan OpenTelemetry. Navigasikan ke halaman log terstruktur
- Resource: Sumber daya asal log.
- Level: Tingkat log entri, seperti informasi, peringatan, atau kesalahan.
- Tanda Waktu: Waktu log terjadi.
- Pesan : Detail log.
- Lacak: Tautan ke jejak yang relevan untuk log, jika berlaku.
- Detail: Detail atau metadata tambahan tentang entri log.
Pertimbangkan contoh cuplikan layar log semantik berikut:
Memfilter log terstruktur
Halaman log terstruktur juga menyediakan bilah pencarian untuk memfilter log menurut layanan, tingkat, atau pesan. Anda menggunakan menu drop-down Tingkat
Pertimbangkan cuplikan layar berikut yang menunjukkan log terstruktur, difilter untuk menampilkan item dengan "Hosting" dalam teks pesan:
Halaman jejak
Navigasi ke halaman Jejak
- Timestamp: Ketika jejak selesai.
- Nama: Nama jejak, diawali dengan nama proyek.
- Rentang: Sumber daya yang terlibat dalam permintaan.
- Durasi: Waktu yang diperlukan untuk menyelesaikan permintaan. Kolom ini menyertakan ikon radial yang mengilustrasikan durasi permintaan dibandingkan dengan yang lain dalam daftar.
Memfilter jejak
Halaman jejak juga menyediakan bilah pencarian untuk memfilter jejak menurut nama atau rentang. Terapkan filter, dan perhatikan bahwa hasil pelacakan segera diperbarui. Pertimbangkan cuplikan layar jejak berikut dengan filter yang diterapkan ke weather
dan perhatikan bagaimana istilah pencarian disorot dalam hasil:
Saat memfilter jejak dalam dialog http.route
dipilih:
Menggabungkan telemetri dari beberapa sumber daya
Saat sumber daya memiliki beberapa replika, Anda dapat memfilter telemetri untuk melihat data dari semua instans sekaligus. Pilih sumber daya induk, berlabel (application)
, seperti yang diperlihatkan dalam cuplikan layar berikut:
Setelah memilih sumber daya induk, halaman jejak menampilkan telemetri dari semua instans sumber daya.
Detail pelacakan
Halaman detail pelacakan berisi berbagai detail yang berkaitan dengan permintaan, termasuk:
- Detail Pelacakan : Saat pelacakan dimulai.
- Durasi: Waktu yang diperlukan untuk menyelesaikan permintaan.
- Sumber Daya: Jumlah sumber daya yang terlibat dalam permintaan.
- Kedalaman : Jumlah lapisan yang terlibat dalam permintaan.
- Total Rentang: Jumlah total rentang yang terlibat dalam permintaan.
Setiap rentang direpresentasikan sebagai baris dalam tabel, dan berisi nama . Rentang juga menampilkan ikon kesalahan jika terjadi kesalahan dalam rentang tertentu dari jejak. Rentang yang memiliki jenis klien/konsumen, tetapi tidak memiliki rentang di server, tampilkan ikon panah lalu alamat tujuan. Ini mewakili panggilan klien ke sistem di luar proyek .NET.NET Aspire. Misalnya, HTTP meminta API web eksternal, atau panggilan database.
Dalam halaman detail pelacakan, ada tombol Tampilkan Log yang membawa Anda ke halaman log terstruktur dengan filter yang diterapkan untuk hanya menampilkan log yang relevan dengan permintaan. Pertimbangkan contoh cuplikan layar yang menggambarkan halaman log terstruktur dengan filter yang diterapkan untuk memperlihatkan hanya log yang relevan dengan jejak:
Halaman log terstruktur dibahas secara lebih rinci di halaman log terstruktur bagian.
Contoh pelacakan
Setiap jejak memiliki warna, yang dihasilkan untuk membantu membedakan antara rentang—satu warna untuk setiap sumber daya. Warna-warna tercermin dalam halaman jejak dan halaman detail pelacakan . Ketika jejak menggambarkan ikon panah, ikon tersebut juga diwarnai agar sesuai dengan rentang pelacakan target. Pertimbangkan contoh cuplikan layar jejak berikut:
Anda juga dapat memilih tombol Lihat untuk menavigasi ke tampilan terperinci permintaan dan durasi waktu yang dihabiskan bepergian melalui setiap lapisan aplikasi. Pertimbangkan contoh pilihan jejak untuk melihat detailnya:
Untuk setiap rentang dalam pelacakan, pilih Tampilkan untuk melihat detail selengkapnya:
Gulir ke bawah dalam rentang nyeri detail untuk melihat informasi lengkap. Di bagian bawah panel detail rentang, beberapa jenis rentang, seperti panggilan ini ke cache, memperlihatkan rentang waktu peristiwa:
Saat terjadi kesalahan, halaman akan merender ikon kesalahan di samping nama pelacakan. Pertimbangkan contoh cuplikan layar jejak dengan kesalahan:
Dan tampilan terperinci yang sesuai dari jejak dengan kesalahan:
Halaman metrik
Navigasi ke halaman Metrik
Setiap proyek penerbitan metrik di aplikasi Anda memiliki metriknya sendiri. Halaman metrik menampilkan panel pilihan untuk setiap meter tingkat atas dan instrumen terkait yang dapat Anda pilih untuk melihat metrik.
Pertimbangkan contoh cuplikan layar halaman metrik berikut, dengan proyek webfrontend
dipilih dan metrik System.Net.Http
meter http.client.request.duration
dipilih:
Selain bagan metrik, halaman metrik menyertakan opsi untuk menampilkan data sebagai tabel sebagai gantinya. Pertimbangkan cuplikan layar halaman metrik berikut dengan tampilan tabel dipilih:
Di bawah bagan, ada daftar filter yang bisa Anda terapkan untuk fokus pada data yang menarik bagi Anda. Misalnya, dalam cuplikan layar berikut, bidang
Anda juga dapat memilih untuk memilih hitungan metrik yang ditampilkan pada akses vertikal, bukan nilainya:
Untuk informasi selengkapnya tentang metrik, lihat metrik bawaan di .NET.
Pengecualian
Dasbor .NET Aspire mendukung dan menampilkan OpenTelemetryExemplars. Pengecualian menautkan titik data metrik ke operasi yang merekamnya, berfungsi sebagai jembatan antara metrik dan jejak.
Pengecualian berguna karena memberikan konteks tambahan tentang mengapa nilai metrik tertentu direkam. Misalnya, jika Anda melihat lonjakan latensi dalam metrik http.client.request.duration
, pengecualian dapat menunjuk ke jejak atau rentang tertentu yang menyebabkan lonjakan, membantu Anda memahami akar penyebabnya.
Pengecualian ditampilkan dalam bagan metrik sebagai titik bulat kecil di samping titik data. Saat Anda mengarahkan mouse ke atas indikator, tipsalat menampilkan detail pengecualian seperti yang ditunjukkan pada cuplikan layar berikut:
Cuplikan layar sebelumnya menunjukkan detail pengecualian untuk metrik http.client.request.duration
. Detail pengecualian meliputi:
- Nama sumber daya.
- Operasi yang dilakukan, dalam hal ini HTTP GET ke
/catalog/images/{id}
. - Nilai yang sesuai dan stempel waktu.
Memilih indikator pengecualian akan membuka halaman detail pelacakan, di mana Anda dapat melihat jejak yang terkait, misalnya pertimbangkan cuplikan layar berikut:
Untuk informasi selengkapnya, lihat Dokumen OpenTelemetry: Pengecualian.
Pilihan tema
Secara default, tema diatur untuk mengikuti tema Sistem, yang berarti dasbor menggunakan tema yang sama dengan sistem operasi Anda. Anda juga dapat memilih tema Light atau Dark untuk mengambil alih tema sistem. Pilihan tema tetap ada.
Cuplikan layar berikut menunjukkan dialog pemilihan tema, dengan tema Sistem default dipilih:
Jika Anda lebih suka tema Terang, Anda dapat memilihnya dari dialog pemilihan tema:
Pintasan dasbor
Dasbor .NET.NET Aspire menyediakan berbagai pintasan untuk membantu Anda menavigasi dan mengontrol berbagai bagian dasbor. Untuk menampilkan pintasan keyboard, tekan Shift + ?, atau pilih ikon tanda tanya di sudut kanan atas dasbor:
Pintasan berikut ini tersedia:
Panel
- +: Meningkatkan ukuran panel.
- -: Kurangi ukuran panel.
- Shift + r: Rukuran panel eset.
- shift + t: Torientasi panel oggle.
- Shift + x: Tutup panel.
navigasi Halaman :
- r: Buka Resources.
- c: Buka Clog.
: BukaLog terstruktur S .- t: Buka balapan T.
- m: Buka Metrics.
navigasi seluruh situs
- ?: Harus Bantuan.
Shift s : BukaS ettings .
Langkah berikutnya
dasbor
.NET Aspire