Tek başına .NET.NET Aspire panosu

.NET .NET Aspire panosu telemetri verilerini görüntülemek için harika bir kullanıcı arabirimi sağlar. Pano:

• OpenTelemetry etkin herhangi bir uygulamayla kullanılabilecek bir kapsayıcı görüntüsü olarak gemiler.
• rest .NET Aspire olmadan tek başına kullanılabilir.

Panoyu başlatma

Pano, Docker komut satırı kullanılarak başlatılır.

docker run --rm -it -d \
    -p 18888:18888 \
    -p 4317:18889 \
    --name aspire-dashboard \
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

docker run --rm -it -d `
    -p 18888:18888 `
    -p 4317:18889 `
    --name aspire-dashboard `
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

Önceki Docker komutu:

• mcr.microsoft.com/dotnet/aspire-dashboard:9.0 görüntüsünden bir kapsayıcı başlatır.
• Kapsayıcı iki bağlantı noktasını kullanıma sunar:
  • Panonun OTLP bağlantı noktası 188894317konağın bağlantı noktasıyla eşleme. Bağlantı noktası 4317 uygulamalardan OpenTelemetry verileri alır. Uygulamalar OpenTelemetry Protokolü (OTLP)kullanarak veri gönderir.
  • Panonun bağlantı noktası 1888818888konağın bağlantı noktasıyla eşleme. Bağlantı noktası 18888 pano kullanıcı arabirimine sahiptir. Panoyu görüntülemek için tarayıcıda http://localhost:18888 gidin.

Panoda oturum açma

Panoda görüntülenen veriler hassas olabilir. Varsayılan olarak, panonun güvenliği oturum açmak için bir belirteç gerektiren kimlik doğrulamasıyla sağlanır.

Pano tek başına bir kapsayıcıdan çalıştırıldığında, oturum açma belirteci kapsayıcı günlüklerine yazdırılır. Vurgulanan belirteci oturum açma sayfasına kopyaladıktan sonra oturum açma düğmesini seçin.

Panoda oturum açma hakkında daha fazla bilgi için bkz. Pano kimlik doğrulaması.

Panoyu keşfetme

Pano telemetri verilerini görüntülemek için bir kullanıcı arabirimi sunar. Telemetri işlevselliğini keşfetmek için belgelere bakın:

• yapılandırılmış günlükler sayfasını
• İzlemeler sayfası
• Ölçümler sayfası

Panonun nerede çalıştırıldığıyla ilgili bir kısıtlama olmasa da, pano bir geliştirme ve kısa vadeli tanılama aracı olarak tasarlanmıştır. Pano, bellek içinde telemetriyi kalıcı hale getirerek bazı sınırlamalar oluşturur:

• telemetri sınırları aşılırsa telemetri otomatik olarak kaldırılır.
• Pano yeniden başlatıldığında telemetri kalıcı olmaz.

Pano ayrıca .NET.NET Aspire kaynaklarını görüntülemeye yönelik işlevlere sahiptir. Pano kaynak özellikleri tek başına modda çalıştırıldığında devre dışı bırakılır. Kaynak kullanıcı arabirimini etkinleştirmek için bir kaynak hizmeti için yapılandırma ekleyin.

Panoya telemetri gönderme

Uygulamalar OpenTelemetry Protokolü (OTLP)kullanarak panoya telemetri gönderir. Panonun OpenTelemetry verileri almak için bir bağlantı noktası kullanıma sunması gerekir ve uygulamalar bu adrese veri gönderecek şekilde yapılandırılır.

Panoyubaşlatmak için daha önce bir komutu gösterildi. Kapsayıcıyı OpenTelemetrybağlantı noktası üzerinde 4317 veri alacak şekilde yapılandırdı. OTLP uç noktasının tam adresi http://localhost:4317.

OpenTelemetry SDK'sı yapılandırma

Uygulamalar, dillerinin OpenTelemetry SDK'sınıkullanarak telemetri toplar ve gönderir.

Yapılandırmak için önemli OpenTelemetry SDK seçenekleri:

• OTLP uç noktası; örneğin http://localhost:4317panonun yapılandırmasıyla eşleşmelidir.
• OTLP protokolü, pano şu anda yalnızca OTLP/gRPC protokoldestekler. Uygulamaları grpc protokollerini kullanacak şekilde yapılandırın.

Uygulamaları yapılandırmak için:

• Uygulama içinde OpenTelemetry SDK API'lerini kullanın veya
• uygulamayıbilinen ortam değişkenleriyle başlatın:
  • OTEL_EXPORTER_OTLP_PROTOCOLdeğeriyle grpc.
  • OTEL_EXPORTER_OTLP_ENDPOINTdeğeriyle http://localhost:4317.

Örnek

Tek başına panoyu kullanma örneği içinTek başına pano örnek uygulamasına bakın.

Sonraki adımlar