Önálló .NET.NET Aspire irányítópult

Az .NET.NET Aspire irányítópult nagyszerű felhasználói felületet biztosít a telemetriai adatok megtekintéséhez. Az irányítópult:

• Tárolórendszerképként szolgál, amely bármely OpenTelemetry engedélyezett alkalmazással használható.
• Önállóan is használható, a többi .NET.NET Aspirenélkül.

Az irányítópult indítása

Az irányítópult a Docker parancssort használja.

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

Az előző Docker parancs:

• Elindít egy tárolót a mcr.microsoft.com/dotnet/aspire-dashboard:9.0 rendszerképből.
• A tároló két portot tesz elérhetővé:
  • Az irányítópult OTLP-portjának 18889 leképezése a gazdagép portjának 4317. A port 4317OpenTelemetry adatokat fogad az alkalmazásoktól. Az alkalmazások OpenTelemetry Protokoll (OTLP)használatával küldenek adatokat.
  • Az irányítópult portjának 18888 leképezése a gazdagép portjának 18888. A Port 18888 rendelkezik az irányítópult felhasználói felületével. Az irányítópult megtekintéséhez keresse meg a böngészőben a http://localhost:18888.

Bejelentkezés az irányítópultra

Az irányítópulton megjelenített adatok bizalmasak lehetnek. Alapértelmezés szerint az irányítópult hitelesítéssel van védve, amelyhez jogkivonat szükséges a bejelentkezéshez.

Ha az irányítópult önálló tárolóból fut, a bejelentkezési jogkivonatot a rendszer a tárolónaplókba nyomtatja. Miután átmásolta a kiemelt jogkivonatot a bejelentkezési lapra, válassza a Bejelentkezési gombot.

További információ az irányítópultra való bejelentkezésről: Irányítópult-hitelesítés.

Az irányítópult felfedezése

Az irányítópult egy felhasználói felületet kínál a telemetriai adatok megtekintéséhez. A telemetriai funkciók megismeréséhez tekintse meg a dokumentációt:

• Strukturált naplók lap
• Nyomkövetés lap
• Metrikák lap

Bár az irányítópult futtatásának helye nincs korlátozva, az irányítópult fejlesztési és rövid távú diagnosztikai eszközként lett kialakítva. Az irányítópult megőrzi a memóriában lévő telemetriát, ami bizonyos korlátozásokat hoz létre:

• A telemetriai adatok automatikusan törlődnek, ha telemetriakorlátok túllépik.
• Az irányítópult újraindításakor a telemetriai adatok nem maradnak meg.

Az irányítópult .NET.NET Aspire erőforrások megtekintésére is használható. Az irányítópult erőforrás-funkciói le vannak tiltva, ha önálló módban fut. Az erőforrások felhasználói felületének engedélyezéséhez adja hozzá az erőforrás-szolgáltatáskonfigurációját.

Telemetriai adatok küldése az irányítópultra

Az alkalmazások telemetriát küldenek az irányítópultra OpenTelemetry Protokoll (OTLP)használatával. Az irányítópultnak közzé kell tennie egy portot OpenTelemetry adatok fogadásához, és az alkalmazások úgy vannak konfigurálva, hogy adatokat küldjenek erre a címre.

Korábban egy parancs jelenik meg az irányítópultelindításához. Úgy konfigurálta a tárolót, hogy OpenTelemetry adatokat fogadjon a port 4317. Az OTLP-végpont teljes címe http://localhost:4317.

OpenTelemetry SDK konfigurálása

Az alkalmazások telemetriát gyűjtenek és küldenek nyelvük OpenTelemetry SDK-.

Fontos OpenTelemetry SDK-beállítások konfigurálása:

• OTLP-végpont, amelynek meg kell egyeznie az irányítópult konfigurációjával, például http://localhost:4317.
• OTLP protokoll, amelynek irányítópultja jelenleg csak az OTLP/gRPC protokollt támogatja. Alkalmazások konfigurálása a grpc protokoll használatára.

Alkalmazások konfigurálása:

• Használja az OpenTelemetry SDK API-kat az alkalmazásban, vagy
• Indítsa el az alkalmazást ismert környezeti változókkal:
  • OTEL_EXPORTER_OTLP_PROTOCOL grpcértékkel.
  • OTEL_EXPORTER_OTLP_ENDPOINT http://localhost:4317értékkel.

Minta

Az önálló irányítópult használatáról az Különálló .NET.NET Aspire irányítópult mintaalkalmazáscímű témakörben olvashat.

Következő lépések