Menjelajahi dasbor .NET.NET Aspire

Di bagian mendatang, Anda menemukan cara membuat proyek .NET.NET Aspire dan memulai tugas berikut:

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 F5, dan alur masuk autentikasi diotomatisasi oleh alat .

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 adalah beranda default dasbor . Halaman ini mencantumkan semua proyek, kontainer, dan executable .NET yang disertakan dalam solusi .NET Aspire Anda. Misalnya, aplikasi pemula mencakup dua proyek:

• 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.
  • Kesalahan: Dalam kolom Status , kesalahan ditampilkan sebagai lencana dengan jumlah kesalahan. Berguna untuk memahami dengan cepat sumber daya apa yang melaporkan kesalahan. Memilih lencana akan membawa Anda ke log semantik untuk sumber daya tersebut dengan filter pada tingkat kesalahan.
• 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 diaktifkan. Demikian juga, beberapa tindakan dinonaktifkan saat tidak tersedia, misalnya, beberapa sumber daya tidak memiliki log terstruktur. Dalam situasi ini, tindakan log Terstruktur dinonaktifkan.

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.

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 Mulai memulai sumber daya, dan pembaruan kolom Status untuk mencerminkan perubahan. Tombol Hentikan kemudian diaktifkan, memungkinkan Anda menghentikan sumber daya lagi. Dasbor menampilkan pemberitahuan toast dari hasil tindakan:

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.

Salin atau Buka di visualizer teks

Untuk melihat visualisasi teks kolom tertentu, arahkan kursor ke ikon elipsis vertikal. Pilih ikon untuk menampilkan opsi yang tersedia:

• 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 lalu memilih Lihat detail. Halaman Detail menyediakan tampilan komprehensif sumber daya:

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 dengan filter yang diterapkan untuk memperlihatkan hanya log yang relevan dengan sumber daya:

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 .

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 menampilkan teks yang telah dikirim setiap sumber daya di aplikasi Anda ke output standar. Log adalah cara yang berguna untuk memantau kesehatan aplikasi Anda dan mendiagnosis masalah. Log ditampilkan secara berbeda tergantung pada sumbernya, seperti proyek, kontainer, atau dapat dieksekusi.

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:

dasbor

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 untuk melihat log semantik untuk proyek Anda. Semantic, atau pengelogan terstruktur memudahkan untuk menyimpan dan mengkueri peristiwa log, karena log-event message-template dan message-parameters dipertahankan, alih-alih hanya mengubahnya menjadi pesan yang diformat. Anda melihat struktur bersih untuk berbagai log yang ditampilkan di halaman menggunakan kolom:

• 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 untuk memfilter menurut tingkat log. Anda juga dapat memfilter menurut properti log apa pun dengan memilih tombol ikon filter, yang membuka dialog filter tingkat lanjut.

Pertimbangkan cuplikan layar berikut yang menunjukkan log terstruktur, difilter untuk menampilkan item dengan "Hosting" dalam teks pesan:

Halaman jejak

Navigasi ke halaman Jejak untuk melihat semua jejak untuk aplikasi Anda. .NET .NET Aspire secara otomatis mengonfigurasi pelacakan untuk berbagai proyek di aplikasi Anda. Pelacakan terdistribusi adalah teknik diagnostik yang membantu teknisi melokalisasi kegagalan dan masalah performa dalam aplikasi, terutama yang mungkin didistribusikan di beberapa mesin atau proses. Untuk informasi selengkapnya, lihat .NET pelacakan terdistribusi. Teknik ini melacak permintaan melalui aplikasi dan menghubungkan pekerjaan yang dilakukan oleh integrasi aplikasi yang berbeda. Jejak juga membantu mengidentifikasi berapa lama berbagai tahap permintaan selesai. Halaman jejak menampilkan informasi berikut:

• 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 Tambahkan filter, setelah memilih Parameter danKondisi terkait , pilihan Nilai telah diisi sebelumnya dengan nilai yang tersedia untuk parameter yang dipilih. Pertimbangkan cuplikan layar dialog Tambahkan filter berikut dengan parameter 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:

sumber daya

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 untuk melihat metrik untuk aplikasi Anda. .NET .NET Aspire secara otomatis mengonfigurasi metrik untuk berbagai proyek di aplikasi Anda. Metrik adalah cara untuk mengukur kesehatan aplikasi Anda dan dapat digunakan untuk memantau performa aplikasi Anda dari waktu ke waktu.

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 http.request.method difilter untuk hanya menampilkan permintaan GET :

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:

dasbor

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:

dasbor

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.
• Shifts: BukaSettings .

Langkah berikutnya