Aracılığıyla paylaş

Azure Container Apps'te .NET Aspire Panosu ile gerçek zamanlı uygulama verilerini okuma (önizleme)

  • Makale

.NET Aspire Panosu, uygulamaların ve diğer kaynakların bir ortamda nasıl çalıştığına ilişkin canlı verileri görüntüler.

Aşağıdaki görüntü, .NET Aspire Panosu tarafından oluşturulan bir izleme görselleştirmesinin ekran görüntüsüdür.

.NET Aspire Panosu izleme penceresinin ekran görüntüsü.

Panoda görüntülenen bilgiler iki kaynaktan gelir:

  • Uygulamalarınız için izlemeleri, ölçümleri ve günlükleri izlemeye yönelik açık kaynak bir kitaplık olan OpenTelemetry (OTel). Bu belge , Aspire panosunun OTel ile tümleştirilmesi hakkında daha fazla bilgi sağlar.

    • İzlemeler , isteklerin yaşam döngüsünü izler. Bir isteğin uygulamanın farklı bölümleri arasında hareket ettikçe nasıl alınıp işlendiği. Bu bilgiler performans sorunlarını ve diğer sorunları belirlemek için yararlıdır.
    • Ölçümler , altyapının genel durumunun ve performansının gerçek zamanlı ölçümleridir. Örneğin, tüketilen CPU kaynağı sayısı ve uygulamanın saniyede işlediği işlem sayısı. Bu bilgiler, uygulamanızın yanıt hızını anlamak veya performans sorunlarının erken uyarı işaretlerini belirlemek için kullanışlıdır.
    • Günlükler , uygulamanın çalıştırılması sırasında gerçekleşen tüm olayları ve hataları kaydeder. Bu bilgiler, bir sorunun oluştuğu zamanları ve bağıntılı olayları bulmak için yararlıdır.

  • Kubernetes API'sinde uygulamanızın üzerinde çalıştığı temel Kubernetes podları ve bunların günlükleri hakkında bilgi sağlanır.

Pano yetkisiz erişim ve değişikliklere karşı güvenlidir. Panoyu kullanmak için kullanıcının 'Yazma' veya daha yüksek izinleri olmalıdır; başka bir deyişle, ortamda Katkıda Bulunan veya Sahip olmalıdır.

Panoyu etkinleştirme

İpucu

Portala bir seçenek olarak sahip olmanıza karşın, panonuzu etkinleştirmek için önerilen yaklaşım azd iledir. Portalı kullanırken bir sorunla karşılaşırsanız, Container Apps GitHub deposunda bir sorun oluşturun.

Aşağıdaki adımları kullanarak .NET Aspire Panosu'nu mevcut herhangi bir kapsayıcı uygulamasında etkinleştirebilirsiniz.

  1. Azure portala gidin.

  2. Kapsayıcı uygulamanıza göz atın.

  3. Genel Bakış sayfasında .NET Aspire Panosu etiketini bulun ve etkinleştir'i seçin. Bu eylem .NET Aspire Panosu ayarları sayfasını açar.

  4. Ayarlar sayfasında, .NET Aspire Panosu etiketinin yanındaki Etkin onay kutusunu seçin. .NET Aspire Panosu yerine günlüğe kaydetmeyle ilgili olduğundan, bu sayfadaki diğer ayarları yoksayabilirsiniz.

  5. Kapsayıcı uygulamanızın Genel Bakış sayfasında .NET Aspire Panosu etiketini bulun. Etkinleştirme bağlantısının yerini panoyu aç bağlantısı almıştır. Bu bağlantıyı seçin. Bağlantının görünmesi için Genel Bakış sayfasını yeniden yüklemeniz gerekebilir.

Container Apps ortamınıza göz atıp İzleme>Günlüğü seçeneklerini belirleyerek .NET Aspire Panosu ayarlarını da bulabilirsiniz.

.NET Aspire Panosu'nu mevcut herhangi bir kapsayıcı uygulaması ortamında aşağıdaki komutları kullanarak etkinleştirebilirsiniz. değerini <PLACEHOLDERS> değerlerinizle değiştirin.

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

Komut, create tarayıcıda açabileceğiniz pano URL'sini döndürür.

Aşağıdaki adımları kullanarak .NET Aspire Panosu'nu mevcut herhangi bir kapsayıcı uygulamasında etkinleştirebilirsiniz.

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

Komut, up tarayıcıda açabileceğiniz pano URL'sini döndürür.

Sorun giderme

Panonuzu etkinleştirirken sorun yaşıyorsanız aşağıdaki öğelere bakın:

  • Panonun etkinleştirilmesi portalda iki dakika kadar sürebilir. Pano hazır olmadan önce panoya gitmeye çalışırsanız, sunucu bir 404 veya 421 hatası döndürür.

  • "Yanlış Yönlendirilmiş İstek" hatasıyla karşılaşırsanız 421 tarayıcı penceresini kapatın, birkaç dakika bekleyin ve yeniden deneyin.

  • "İstenen kaynakla kullanıcının kimliği doğrulanamadı" yazan panoya erişirken bir kimlik doğrulama hatası alabilirsiniz.

    Bu sorun, güvenlik grubu izinlerinin Kapsayıcı Uygulama Ortamına yayılmaması nedeniyle oluşur. Bu sorunu çözmek için, Container Apps ortamınızda kendinize açıkça Katkıda Bulunan veya Sahip rolü verdiğinizden emin olun. Bu, aşağıdaki adımlarla yapılabilir:

    • Kaynağa gidin:
      • Azure Portal'ı açın ve kapsayıcı uygulaması ortamınızı arayın.
    • Erişim Denetimi (IAM) Dikey Penceresine Erişme:
      • Kapsayıcı uygulaması ortamı için Erişim Denetimi'ne (IAM) tıklayın.
    • Mevcut Rol Atamalarını Doğrulama:
      • Size (veya hesabınıza) herhangi bir rol atanmış olup olmadığını denetleyin. İzinlerin şu anda güvenlik grupları aracılığıyla yayılmadığını unutmayın.
      • Değilseniz, rolü atamak için kalan adımları izleyin.
    • Açık Rol Ataması: - Rol ataması ekle'ye > tıklayın. - Gerekli erişim düzeyinize uygun olarak Rol: Katkıda Bulunan veya Sahip'i seçin. - Rolü kullanıcı hesabınıza açıkça atayın (ör. youremail@domain.com).
    • Kaydet ve Onayla:
      • Değişiklikleri kaydedin. Rolün Rol Atamaları bölümünde görünür olduğundan emin olun.
    • Pano Erişimini Doğrulama:
      • Aspire panosuna erişmeyi deneyerek test edin. Hatayı almaya devam ederseniz lütfen ekibimize ulaşın.

İlgili içerik

.NET Aspire panosuna genel bakış