.NET .NET Aspire panosunu keşfetme
Sonraki bölümlerde, bir .NET.NET Aspire projesi oluşturmayı ve aşağıdaki görevlere nasıl binmeyi öğreneceksiniz:
.NET .NET Aspire pano uygulamasının özelliklerini inceleyin.
Bu makalede öne çıkan ekran görüntüleri koyu temayı gösterir. Tema seçimi hakkında daha fazla bilgi için bkz. Tema seçimi.
Pano kimlik doğrulaması
bir .NET.NET Aspire uygulama konağı çalıştırdığınızda, düzenleyici uygulamanın tüm bağımlı kaynaklarını başlatır ve ardından panoya bir tarayıcı penceresi açar. .NET .NET Aspire panosu, ortam değişkenlerini ve diğer hassas bilgileri görüntülediğinden kullanıcıları için belirteç tabanlı kimlik doğrulaması gerektirir.
Pano Visual Studio veya Visual Studio Code 'den başlatıldığında (C# Dev Kit uzantısı), tarayıcı otomatik olarak oturum açar ve pano doğrudan açılır. Bu tipik bir geliştirici F5 deneyimidir ve kimlik doğrulama oturum açma akışı .NET.NET Aspire araçları tarafından otomatikleştirilir.
Ancak, uygulama ana bilgisayarını komut satırından başlatırsanız oturum açma sayfası gösterilir. Konsol penceresinde, panoyu tarayıcınızda açmak için seçebileceğiniz bir URL görüntülenir.
URL, panoda oturum açmak
Oturum açma sayfası bir belirteci kabul eder ve aşağıdaki ekran görüntüsünde gösterildiği gibi belirtecin nasıl edinileceğini gösteren yararlı yönergeler sağlar:
Belirteci edinme yönergelerini içeren pano oturum açma sayfasını
Belirteci konsoldan kopyalayıp oturum açma sayfasına yapıştırdıktan sonra Oturum aç düğmesini seçin.
Belirtecin metin kutusuna yapıştırılmış olduğu pano oturum açma sayfasını
Pano, belirteci tarayıcı kalıcı cookieolarak korur ve üç gün boyunca geçerli kalır. Kalıcı tanımlama bilgilerinin son kullanma tarihi vardır ve tarayıcı kapatıldıktan sonra bile geçerli kalır. Bu, kullanıcıların tarayıcıyı kapatıp yeniden açmaları durumunda yeniden oturum açmalarına gerek olmadığı anlamına gelir. Daha fazla bilgi için
Kaynaklar sayfası
Kaynaklar sayfası, .NET.NET Aspire panosunun varsayılan giriş sayfasıdır. Bu sayfada, .NET çözümünüzde bulunan tüm .NET Aspire projeleri, kapsayıcılar ve yürütülebilir dosyalar listelenir. Örneğin, başlangıç uygulaması iki proje içerir:
- apiservice
: En Az API kullanılarak oluşturulmuş bir arka uç API projesi. - webfrontend
: kullanılarak oluşturulan ön uç kullanıcı arabirimi projesi.
Pano ayrıca her kaynakla ilgili temel ayrıntıları da sağlar:
- Tür: Kaynağın proje, kapsayıcı veya yürütülebilir dosya olup olmadığını görüntüler.
- Adı: Kaynağın adı.
-
Durum: Kaynağın şu anda çalışıp çalışmadığını görüntüler.
-
Hataları: Durumu sütununda hatalar, hata sayısına sahip bir rozet olarak görüntülenir. Hangi kaynakların hata bildiriyor olduğunu hızlı bir şekilde anlamak yararlıdır. Rozetin seçilmesi, filtrenin hata düzeyinde olduğu kaynak için
anlam günlüklerine götürür.
-
Hataları: Durumu sütununda hatalar, hata sayısına sahip bir rozet olarak görüntülenir. Hangi kaynakların hata bildiriyor olduğunu hızlı bir şekilde anlamak yararlıdır. Rozetin seçilmesi, filtrenin hata düzeyinde olduğu kaynak için
- Başlangıç saati: Kaynak çalışmaya başladığında.
- Kaynak: Kaynağın cihazdaki konumu.
- Uç Noktaları: Çalışan kaynağa doğrudan ulaşmak için bir veya daha fazla URL.
- Günlükler: Kaynak günlükleri sayfasının bağlantısı.
-
Eylemler: Kaynakta gerçekleştirilebilecek bir eylem kümesi:
- Durdur / Başlat: Geçerli Durumubağlı olarak kaynağı durdurun (veya Başlatın).
- konsol günlüklerini
: Kaynağın konsol günlüklerine gidin. -
Üç Nokta: Kaynağa özgü ek eylemler içeren bir alt menü:
- Ayrıntıları görüntüle: Kaynak ayrıntılarını görüntüleyin.
- Konsol günlüğü: Kaynağın konsol günlüklerine gidin.
- Yapılandırılmış günlükler: Kaynağın yapılandırılmış günlüklerine gidin.
- İzlemeler: Kaynağın izlemelerine gidin.
- Ölçümler: Kaynağın ölçümlerine gidin.
- Yeniden Başlat: Kaynağı durdurun ve başlatın.
Kaynaklar sayfasının aşağıdaki ekran görüntüsünü göz önünde bulundurun:
Kaynak eylemleri
Her kaynak, kaynağın geçerli durumuna göre koşullu olarak etkinleştirilmiş bir dizi kullanılabilir eyleme sahiptir. Örneğin, bir kaynak çalışıyorsa, Durdur eylemi etkinleştirilir. Kaynak durdurulursa başlangıç
Kaynağı durdurma veya başlatma
.NET .NET Aspire panosu, Eylemler sütunundaki Durdur veya Başlat düğmesini seçerek bir kaynağı durdurmanıza veya başlatmanıza olanak tanır. Durdur düğmesinin seçili olduğu kaynaklar sayfasının aşağıdaki ekran görüntüsünü göz önünde bulundurun:
Durdurseçtiğinizde kaynak çalışmayı durdurur ve Durumu sütunu değişikliği yansıtacak şekilde güncelleştirilir.
Not
Proje kaynakları için, hata ayıklayıcı eklendiğinde yeniden başlatıldığında yeniden eklenir.
Başlangıç düğmesi etkinleştirilir ve kaynağı yeniden başlatmanıza olanak sağlar. Ayrıca, pano eylemin sonucunun bildirim bildirimini görüntüler:
Kaynak çalışmama durumundayken Başlat düğmesi etkinleştirilir. Başlangıç
Bahşiş
Durdurulan veya yeniden başlatılan diğer kaynaklara bağımlı olan kaynaklar geçici hatalara neden olabilir. Bu beklenen bir davranıştır ve genellikle bağımlı kaynaklar bir kez daha Çalışıyor durumunda olduğunda çözülür.
Kaynak alt menüsü eylemleri
Eylemler sütununda yatay üç nokta simgesinin seçilmesi, kaynağa özgü ek eylemlerin olduğu bir alt menü açar. Yerleşik kaynak alt menüsü eylemlerine ek olarak, özel komutlar tanımlayarak özel kaynak eylemleri de tanımlayabilirsiniz. Daha fazla bilgi için bkz.
Pano kaynağı alt menüsü eylemlerini
Aşağıdaki alt menü eylemleri kullanılabilir:
- Ayrıntıları görüntüle: Kaynak ayrıntılarını görüntüleyin.
- Konsol günlüğü: Kaynağın konsol günlüklerine gidin.
- Yapılandırılmış günlükler: Kaynağın yapılandırılmış günlüklerine gidin.
- İzlemeler: Kaynağın izlemelerine gidin.
- Ölçümler: Kaynağın ölçümlerine gidin.
- Yeniden Başlat: Kaynağı durdurun ve başlatın.
Önemli
Devre dışı bırakılmış alt menü eylemleri olan kaynaklar olabilir. Devre dışı bırakıldığında gri görünürler. Örneğin, aşağıdaki ekran görüntüsünde devre dışı bırakılan alt menü eylemleri gösterilmektedir:
Metin görselleştiricisinde kopyalama veya açma
Belirli sütunların
- Panoya kopyala
- Metin görselleştiricisinde aç
Üç nokta menü seçeneklerinin aşağıdaki ekran görüntüsünü göz önünde bulundurun:
Metin görselleştiricisinde aç seçeneğini belirlediğinizde, metnin daha büyük bir biçimde görüntülendiği kalıcı bir iletişim kutusu açılır. Metin görselleştiricisi kalıcı iletişim kutusunun aşağıdaki ekran görüntüsünü göz önünde bulundurun:
Bazı değerler JSON veya XML olarak biçimlendirilir. Bu gibi durumlarda, metin görselleştiricisi Biçim seçin açılan menüsünün farklı biçimler arasında geçiş yapmalarını sağlar.
Kaynak ayrıntıları
Panonun sağ üst kısmındaki arama çubuğu, listeyi filtreleme seçeneği de sağlar. Bu seçenek, birçok kaynağı olan .NET.NET Aspire projeler için kullanışlıdır. Görüntülenen kaynak türlerini seçmek için, filtre metin kutusunun solundaki oku aşağı bırakın:
Bu örnekte, listede yalnızca kapsayıcılar görüntülenir. Örneğin, bir
Yürütülebilir dosyalar tek başına işlemlerdir. Başlangıç sırasında tek başına yürütülebilir dosya çalıştırmak için bir .NET.NET Aspire proje yapılandırabilirsiniz, ancak varsayılan başlangıç şablonları varsayılan olarak herhangi bir yürütülebilir dosya içermez.
Aşağıdaki ekran görüntüsünde, hataları olan bir proje örneği gösterilmektedir:
Hata sayısı rozeti seçildiğinde, yalnızca kaynakla ilgili günlükleri göstermek için filtre uygulanmış Yapılandırılmış günlükler sayfasına gider:
Hatanın günlük girdisini ayrıntılı olarak görmek için Görünüm düğmesini seçerek listenin altında yapılandırılmış günlük girişi ayrıntılarını içeren bir pencere açın:
Yapılandırılmış günlükler hakkında daha fazla bilgi ve örnek için Yapılandırılmış günlükler sayfası bölümüne bakın.
Not
Pano yapılandırılmış bir kaynak hizmeti olmadan başlatılırsa kaynaklar sayfası kullanılamaz. Pano, Yapılandırılmış günlükler sayfasından başlar. Bu, pano ek yapılandırma olmadan tek başına modda çalıştırıldığında varsayılan deneyimdir.
Kaynak hizmetini yapılandırma hakkında daha fazla bilgi için bkz. Pano yapılandırması.
İzleme sayfaları
.NET .NET Aspire panosu, uygulamanızın günlüklerini, izlemelerini ve ölçümlerini görüntülemek için çeşitli yollar sağlar. Bu bilgiler uygulamanızın davranışını ve performansını izlemenize ve ortaya çıkan sorunları tanılamanıza olanak tanır.
Konsol günlükleri sayfası
Konsolu günlükleri sayfasında uygulamanızdaki her kaynağın standart çıktıya gönderdiği metin görüntülenir. Günlükler, uygulamanızın durumunu izlemek ve sorunları tanılamak için kullanışlı bir yoldur. Günlükler projeye, kapsayıcıya veya yürütülebilir dosyaya bağlı olarak farklı şekilde görüntülenir.
Konsol günlükleri sayfasını açtığınızda, Kaynak seçin açılan listesinden bir kaynak seçmeniz gerekir.
Bir proje seçerseniz, canlı günlükler günlüğün önem derecesine karşılık gelen stilize bir renk kümesiyle işlenir; örnek olarak bilgi için yeşil.
apiservice
proje seçili durumdayken proje günlüklerinin aşağıdaki örnek ekran görüntüsünü göz önünde bulundurun:
Hatalar oluştuğunda, bunlar kolayca tanımlanabilecek şekilde günlüklerde stillendirilir. Hata içeren proje günlüklerinin aşağıdaki örnek ekran görüntüsünü göz önünde bulundurun:
Bir kapsayıcı veya yürütülebilir dosya seçerseniz, biçimlendirme bir projeden farklıdır ancak ayrıntılı davranış bilgileri hala kullanılabilir durumdadır.
cache
kapsayıcısının seçili olduğu bir kapsayıcı günlüğünün aşağıdaki örnek ekran görüntüsünü göz önünde bulundurun:
Kaynak çoğaltmaları
Proje kaynakları WithReplicas API'sini kullanarak çoğaltıldığında, bunlar kaynak seçicide, gösterge simgesi bulunan bir üst düzey adlı kaynak girdisinin altında gösterilir. Çoğaltılan her kaynak, en üst düzey kaynak girdisinin altında, karşılık gelen benzersiz adıyla listelenir. Çoğaltılmış proje kaynağının aşağıdaki örnek ekran görüntüsünü göz önünde bulundurun:
Yukarıdaki ekran görüntüsünde, catalogservice (application)
ve catalogservice-2bpj2qdq6k
iki çoğaltmaya sahip catalogservice-6ljdin0hc0
projesi gösterilmektedir. Her çoğaltmanın, çoğaltma adı seçilerek görüntülenebilen kendi günlük kümesi vardır.
Yapılandırılmış günlükler sayfası
.NET Aspire, OpenTelemetrykullanarak projelerinizi günlüğe kaydetme ile otomatik olarak yapılandırıyor.
.NET projenizin anlam günlüklerini görüntülemek için .NET Aspire sayfasına gidin. Anlamsal veya yapılandırılmış günlüğe kaydetme
- Kaynak: Günlüğün kaynaklandığı kaynak.
- Düzeyi: Girdinin bilgi, uyarı veya hata gibi günlük düzeyi.
- Zaman Damgası: Günlüğün oluştuğu saat.
- İleti: Günlüğün ayrıntıları.
- İzleme: Varsa günlük için ilgili izlemenin bağlantısı.
- Ayrıntılar: Günlük girdisi hakkında ek ayrıntılar veya meta veriler.
Anlam günlüklerinin aşağıdaki örnek ekran görüntüsünü göz önünde bulundurun:
Yapılandırılmış günlükleri filtreleme
Yapılandırılmış günlükler sayfası ayrıca günlükleri hizmete, düzeye veya iletiye göre filtrelemek için bir arama çubuğu sağlar. Günlük düzeyine göre filtrelemek için Düzeyi açılan listesini kullanırsınız. Ayrıca, gelişmiş filtre iletişim kutusunu açan filtre simgesi düğmesini seçerek herhangi bir günlük özelliğine göre filtreleyebilirsiniz.
İleti metninde "Barındırma" içeren öğeleri görüntülemek için filtrelenmiş yapılandırılmış günlükleri gösteren aşağıdaki ekran görüntülerini göz önünde bulundurun:
İzlemeler sayfası
Uygulamanızın tüm izlemelerini görüntülemek için İzlemeler sayfasına gidin.
.NET
.NET Aspire uygulamanızdaki farklı projeler için izlemeyi otomatik olarak yapılandırıyor. Dağıtılmış izleme, mühendislerin uygulamalardaki hataları ve performans sorunlarını, özellikle birden çok makineye veya işleme dağıtılmış olabilecekleri yerelleştirmelerine yardımcı olan bir tanılama tekniğidir. Daha fazla bilgi için bkz. dağıtılmış izleme
- Zaman Damgası: İzleme tamamlandığında.
- Adı: Proje adıyla önekli izlemenin adı.
- Spans: İstekte yer alan kaynaklar.
- Süre: İsteği tamamlamak için geçen süre. Bu sütun, listedeki diğerleriyle karşılaştırıldığında isteğin süresini gösteren radyal bir simge içerir.
İzlemeleri filtreleme
İzlemeler sayfası, izlemeleri ada veya yayılma alanına göre filtrelemek için bir arama çubuğu da sağlar. Bir filtre uygulayın ve izleme sonuçlarının hemen güncelleştirildiğinden dikkat edin.
weather
uygulanmış bir filtreyle izlemelerin aşağıdaki ekran görüntüsünü göz önünde bulundurun ve sonuçlarda arama teriminin nasıl vurgulandığına dikkat edin:
Filtre ekle iletişim kutusundaki izlemeler filtrelenirken, Parametre ve karşılık gelen Koşuluseçildikten sonra, Değer seçimi seçilen parametre için kullanılabilir değerlerle önceden doldurulur.
parametresi seçili http.route
iletişim kutusunun aşağıdaki ekran görüntüsünü göz önünde bulundurun:
Birden çok kaynaktan gelen telemetriyi birleştirme
Bir kaynağın birden çok çoğaltması olduğunda, tüm örneklerden gelen verileri aynı anda görüntülemek için telemetriyi filtreleyebilirsiniz. Aşağıdaki ekran görüntüsünde gösterildiği gibi (application)
etiketli üst kaynağı seçin:
tüm örneklerine göre filtreleme
Üst kaynağı seçtikten sonra, izlemeler sayfasında kaynağın tüm örneklerinden telemetri görüntülenir.
İzleme ayrıntıları
İzleme ayrıntıları sayfası, istekle ilgili çeşitli ayrıntıları içerir, örneğin:
- İzleme Ayrıntısı: İzleme başlatıldığında.
- Süre: İsteği tamamlamak için geçen süre.
- Kaynaklar: İstekte yer alan kaynakların sayısı.
- Derinlik: İstekte yer alan katman sayısı.
- Toplam Yayılma Alanları: İstekte yer alan toplam yayılma alanı sayısı.
Her yayılma alanı tabloda bir satır olarak temsil edilir ve Adıiçerir. Spans, izlemenin söz konusu yayılma alanı içinde bir hata oluştuysa hata simgesini de görüntüler. İstemci/tüketici türüne sahip olan ancak sunucuda yayılma alanı olmayan yayılma alanları, bir ok simgesi ve ardından hedef adresi gösterir. Bu, .NET.NET Aspire projesi dışındaki bir sisteme yapılan istemci çağrısını temsil eder. Örneğin, bir HTTP dış web API'sini veya veritabanı çağrısını ister.
İzleme ayrıntıları sayfasında, sizi yalnızca istekle ilgili günlükleri gösterecek şekilde filtre uygulanmış yapılandırılmış günlükler sayfasına götüren bir Günlükleri Görüntüle düğmesi vardır. Yalnızca izlemeyle ilgili günlükleri göstermek için filtre uygulanmış yapılandırılmış günlükler sayfasını gösteren örnek bir ekran görüntüsü düşünün:
Yapılandırılmış günlükler sayfası, Yapılandırılmış günlükler sayfası bölümünde daha ayrıntılı olarak ele alınmıştı.
İzleme örnekleri
Her izlemenin bir rengi vardır ve bu renk, her kaynak için bir renk olmak üzere yayılma alanları arasında ayrım yapmaya yardımcı olmak için oluşturulur. Renkler hem izlemeler sayfası hem de izleme ayrıntı sayfasınayansıtılır. İzlemelerde ok simgesi gösterildiğinde, bu simgeler hedef izlemenin yayılma alanıyla eşleşecek şekilde renklendirilir. İzlemelerin aşağıdaki örnek ekran görüntüsünü göz önünde bulundurun:
ayrıca Görünüm düğmesini seçerek isteğin ayrıntılı bir görünümüne ve her uygulama katmanında yolculuk için harcadığı süreye gidebilirsiniz. Ayrıntılarını görüntülemek için bir izlemenin örnek seçimini göz önünde bulundurun:
İzlemedeki her bir yayılma alanı için Görünüm'ni seçerek daha fazla ayrıntıya bakın:
Tüm bilgileri görmek için span ayrıntılarında aşağı kaydırın. Span ayrıntıları bölmesinin en altında, önbelleğe yapılan bu çağrı gibi bazı span türleri span olay zamanlamalarını gösterir:
Hatalar olduğunda, sayfa izleme adının yanında bir hata simgesi oluşturur. Hata içeren izlemelerin örnek ekran görüntüsünü düşünün:
Ve hatalarla izlemenin ilgili ayrıntılı görünümü:
Ölçümler sayfası
Uygulamanızın ölçümlerini görüntülemek için Ölçümler sayfasına gidin. .NET .NET Aspire, uygulamanızdaki farklı projeler için ölçümleri otomatik olarak yapılandırıyor. Ölçümler, uygulamanızın durumunu ölçmenin bir yoludur ve uygulamanızın zaman içindeki performansını izlemek için kullanılabilir.
Uygulamanızdaki her ölçüm yayımlama projesinin kendi ölçümleri vardır. Ölçümler sayfasında, her üst düzey ölçüm için bir seçim bölmesi ve ölçümü görüntülemek için seçebileceğiniz ilgili araçlar görüntülenir.
ölçümler sayfasının aşağıdaki örnek ekran görüntüsünü ve webfrontend
projesinin ve System.Net.Http
ölçüm ölçümünün http.client.request.duration
ölçümünün seçili olduğunu düşünün:
Ölçüm grafiğine ek olarak, ölçümler sayfasında bunun yerine verileri tablo olarak görüntüleme seçeneği bulunur. Tablo görünümünün seçili olduğu ölçümler sayfasının aşağıdaki ekran görüntüsünü göz önünde bulundurun:
Grafiğin altında, ilginizi çeken verilere odaklanmak için uygulayabileceğiniz filtrelerin listesi bulunur. Örneğin, aşağıdaki ekran görüntüsünde http.request.method
Ayrıca, dikey erişimde görüntülenen ölçümün değerlerinin yerine sayısını seçebilirsiniz:
Ölçümler hakkında daha fazla bilgi için bkz.
Örnek olarak gösterilenler
.NET Aspire panosu OpenTelemetryExemplarsdestekler ve görüntüler. Örnek ölçüm veri noktasını bunu kaydeden işleme bağlar ve ölçümlerle izlemeler arasında köprü görevi görür.
Belirli bir ölçüm değerinin neden kaydedildiği hakkında ek bağlam sağladığından, örnek öğeler yararlıdır. Örneğin, http.client.request.duration
ölçümünde gecikme süresinde ani bir artış fark ederseniz, bir örnek ani artışa neden olan belirli bir izleme veya yayılma alanına işaret ederek kök nedeni anlamanıza yardımcı olabilir.
Ölçüm grafiğinde örnek görüntüler, veri noktasının yanında küçük bir yuvarlak nokta olarak görüntülenir. Göstergenin üzerine geldiğinizde, araç ipucu aşağıdaki ekran görüntüsünde gösterildiği gibi örnek ayrıntıları görüntüler:
Yukarıdaki ekran görüntüsünde http.client.request.duration
ölçümü için örnek ayrıntılar gösterilmektedir. Örnek ayrıntılar şunlardır:
- Kaynak adı.
- İşlem gerçekleştirildi, bu durumda
/catalog/images/{id}
için bir HTTP GET. - Karşılık gelen değer ve zaman damgası.
Örnek göstergeyi seçtiğinizde izleme ayrıntıları sayfası açılır ve burada ilişkili izlemeyi görüntüleyebilirsiniz, örneğin aşağıdaki ekran görüntüsünü göz önünde bulundurun:
Daha fazla bilgi için bkz. OpenTelemetry Docs: Exemplars.
Tema seçimi
Varsayılan olarak, tema Sistem temasını izleyecek şekilde ayarlanmıştır. Bu, panonun işletim sisteminizle aynı temayı kullandığı anlamına gelir. Sistem temasını geçersiz kılmak için Açık veya Koyu temasını da seçebilirsiniz. Tema seçimleri kalıcı hale gelir.
Aşağıdaki ekran görüntüsünde, varsayılan Sistem temasının seçili olduğu tema seçimi iletişim kutusu gösterilmektedir:
Açık temayı tercih ediyorsanız, tema seçimi iletişim kutusundan seçebilirsiniz:
Pano kısayolları
Pano Yardım kalıcı iletişim kutusunu
Aşağıdaki kısayollar kullanılabilir:
Paneller:
- +: Panel boyutunu artırın.
- -: Panel boyutunu küçültün.
- Shift + r: Reset panel boyutu.
- Shift + t: Toggle panel yönlendirmesi.
- Shift + x: Paneli kapatın.
sayfa gezinti
- r: Resourcesgidin.
- c: Console Logsgidin.
- : Skesilmiş Günlüklergidin.
: T yarışlarına gidin.- m: Metricsgidin.
site genelinde gezinti
? : yardımgerekiyor. - shift
: öğesine gidin.S
Sonraki adımlar
.NET Aspire