.NET Aspire Redis®^* Ausgabe-Caching-Integration

2025-05-20

Enthält: Hosting-Integration —&— Client Integration

Erfahren Sie, wie Sie die Ausgabe-Cache-Integration von .NET AspireRedis verwenden. Die Aspire.StackExchange.Redis.OutputCaching Clientintegration wird verwendet, um einen ASP.NET Core Output-Caching-Anbieter zu registrieren, der durch einen Redis Server mit dem docker.io/library/redis Containerimage unterstützt wird.

Erfahren Sie, wie Sie die Ausgabe-Cache-Integration von .NET AspireRedis verwenden. Die Aspire.StackExchange.Redis.OutputCaching-Clientintegration wird verwendet, um einen ASP.NET Core-Ausgabezwischenspeicherungsanbieter zu registrieren, der von einem Garnet-Server mit dem ghcr.io/microsoft/garnet-Containerimage unterstützt wird.

Erfahren Sie, wie Sie die Ausgabe-Cache-Integration von .NET AspireRedis verwenden. Die Aspire.StackExchange.Redis.OutputCaching Clientintegration wird genutzt, um einen ASP.NET Core Anbieter für Ausgabe-Caching zu registrieren, der von einem Valkey-Server mit dem docker.io/valkey/valkey Container-Image unterstützt wird.

Hosting-Integration

Die Redis Hostintegration modelliert eine Redis Ressource als RedisResource Typ. Um auf diesen Typ und diese APIs zuzugreifen, um sie als Ressourcen in Ihrem App-Hostprojekt darzustellen, fügen Sie das 📦Aspire.Hosting.Redis NuGet-Paket hinzu.

.NET CLI
PaketReferenz

dotnet add package Aspire.Hosting.Redis

<PackageReference Include="Aspire.Hosting.Redis"
                  Version="*" />

Weitere Informationen finden Sie unter dotnet add package oder Verwalten von Paketabhängigkeiten in .NET-Anwendungen.

Die Ressource Redis hinzufügen

Rufen Sie AddRedis auf der builder-Instanz in Ihrem App-Hostprojekt auf, um eine Redis-Ressource hinzuzufügen.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wenn .NET.NET Aspire dem App-Host ein Containerimage hinzufügt, wie im vorherigen Beispiel mit dem docker.io/Redis/Redis-Image gezeigt, wird eine neue Redis Instanz auf dem lokalen Computer erstellt. Zum Rediswird ein Verweis auf die cache Ressource (die Variable ExampleProject) hinzugefügt.

Die WithReference-Methode konfiguriert eine Verbindung im ExampleProject namens "cache". Weitere Informationen finden Sie unter Container-Ressourcenlebenszyklus.

Tipp

Wenn Sie lieber eine Verbindung mit einer vorhandenen Redis Instanz herstellen möchten, rufen Sie stattdessen AddConnectionString auf. Weitere Informationen finden Sie unter Verweisen auf vorhandene Ressourcen.

Fügen Sie mit Redis Insights die Redis Resource hinzu

Um die Redis Insights zur Redis Ressource hinzuzufügen, rufen Sie die Methode WithRedisInsight auf.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithRedisInsight();

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Redis Insights ist eine kostenlose grafische Oberfläche zur Analyse von Redis-Daten auf allen Betriebssystemen und in allen Redis-Bereitstellungen mithilfe unseres KI-Assistenten, Redis Copilot. .NET .NET Aspire fügt dem App-Host, der die Commander-App ausführt, ein weiteres Containerimage docker.io/redis/redisinsight hinzu.

Anmerkung

Um den Hostport für die RedisInsightResource-Kette zu konfigurieren, führen Sie einen Aufruf an die WithHostPort-API durch und geben Sie die gewünschte Portnummer an.

Füge Redis Ressource mit Redis Commander hinzu

Um den Redis Commander zur Redis Ressource hinzuzufügen, rufen Sie die Methode auf WithRedisCommander.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithRedisCommander();

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Redis Commander ist eine Node.js Webanwendung, die zum Anzeigen, Bearbeiten und Verwalten einer Redis Datenbank verwendet wird. .NET .NET Aspire fügt dem App-Host, der die Commander-App ausführt, ein weiteres Containerimage docker.io/rediscommander/redis-commander hinzu.

Tipp

Um den Hostport für die RedisCommanderResource-Kette zu konfigurieren, führen Sie einen Aufruf an die WithHostPort-API durch und geben Sie die gewünschte Portnummer an.

Fügen Sie die Redis-Ressource mit Datenvolumen hinzu

Rufen Sie die Redis-Methode für die WithDataVolume-Ressource auf, um der Redis-Ressource ein Datenvolume hinzuzufügen:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Das Datenvolume wird verwendet, um die Redis Daten außerhalb des Lebenszyklus des Containers zu speichern. Das Datenvolumen wird im Container /data an dem Pfad Redis bereitgestellt, und wenn kein name-Parameter angegeben wird, wird der Name zufällig generiert. Weitere Informationen zu Datenvolumes und Details dazu, warum sie gegenüber Bind-Mounts bevorzugt werden, finden Sie unter Docker Dokumentation: Volumes.

Ressource mit Daten-Bind-Mount hinzufügen Redis

Rufen Sie die Redis-Methode auf, um der WithDataBindMount-Ressource eine Datenbindung hinzuzufügen:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataBindMount(
                       source: @"C:\Redis\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wichtig

Datenbindungs-Mounts verfügen über eingeschränkte Funktionalität im Vergleich zu Volumes, die eine bessere Leistung, Portabilität und Sicherheit bieten, wodurch sie für Produktionsumgebungen besser geeignet sind. Bind-Mounts ermöglichen jedoch direkten Zugriff und Änderung von Dateien auf dem Hostsystem, ideal für Entwicklung und Tests, bei denen Echtzeitänderungen vorgenommen werden müssen.

Datenbindungs-Bereitstellungen basieren auf dem Dateisystem des Hostcomputers, um die Redis Daten über Containerneustarts hinweg beizubehalten. Das Daten-Bind-Mount wird auf dem C:\Redis\Data-Pfad unter Windows (oder /Redis/Data auf Unix) auf dem Hostrechner im Container Redis bereitgestellt. Weitere Informationen zu Daten-Bind-Mounts finden Sie in der Docker Dokumentation: Bind mounts.

Fügen Sie die Redis-Ressource mit Persistenz hinzu.

Rufen Sie zum Hinzufügen der Persistenz zur Ressource Redis die Methode WithPersistence entweder mit dem Datenvolume oder dem Datenbind-Mount auf.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Der vorhergehende Code fügt der Ressource Redis Persistenz hinzu, indem Momentaufnahmen der Daten von Redis in einem angegebenen Intervall und bei einem bestimmten Schwellenwert erstellt werden. Der interval ist die Zeit zwischen Momentaufnahme-Exporten und keysChangedThreshold ist die Anzahl der Schlüsseländerungsvorgänge, die zum Auslösen einer Momentaufnahme erforderlich sind. Weitere Informationen zur Persistenz finden Sie unter Redis Docs: Persistenz.

Die Garnet-Hostingintegration modelliert eine Garnet-Ressource als GarnetResource-Typ. Um auf diesen Typ und seine APIs zuzugreifen, die Ihnen ermöglichen, ihn Ihrem 📦AspireHosting.Garnet-NuGet-Paket im App-Host-Projekt hinzuzufügen.

.NET CLI
PaketReferenz

dotnet add package Aspire.Hosting.Garnet

<PackageReference Include="Aspire.Hosting.Garnet"
                  Version="*" />

Weitere Informationen finden Sie unter dotnet add package oder Verwalten von Paketabhängigkeiten in .NET-Anwendungen.

Garnet-Ressource hinzufügen

Rufen Sie in Ihrem App-Hostprojekt AddGarnet in der builder Instanz auf, um eine Garnet-Ressource hinzuzufügen:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wenn .NET.NET Aspire dem App-Host ein Containerimage hinzufügt, wie anhand des vorherigen Beispiels mit dem ghcr.io/microsoft/garnet-Image gezeigt, wird eine neue Garnet-Instanz auf dem lokalen Computer erstellt. Dem cachewird ein Verweis auf Ihre Garnet-Ressource hinzugefügt (die ExampleProject-Variable).

Die WithReference-Methode konfiguriert eine Verbindung im ExampleProject namens "cache". Weitere Informationen finden Sie unter Container-Ressourcenlebenszyklus.

Tipp

Wenn Sie lieber eine Verbindung mit einer vorhandenen Garnet-Instanz herstellen möchten, rufen Sie stattdessen AddConnectionString auf. Weitere Informationen finden Sie unter Verweisen auf vorhandene Ressourcen.

Hinzufügen einer Garnet-Ressource mit Datenvolume

Um der Garnet-Ressource ein Datenvolume hinzuzufügen, rufen Sie die AddGarnet-Methode für die Garnet-Ressource auf:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Das Datenvolume wird verwendet, um die Garnet-Daten außerhalb des Lebenszyklus des Containers zu speichern. Das Datenvolumen wird am Pfad /data im Garnet-Container bereitgestellt und wenn kein name-Parameter angegeben wird, wird der Name zufällig generiert. Weitere Informationen zu Datenvolumes und Details dazu, warum sie gegenüber Bind-Mounts bevorzugt werden, finden Sie unter Docker Dokumentation: Volumes.

Hinzufügen einer Garnet-Ressource mit Datenbindungs-Bereitstellung

Um ein Datenbindungs-Mount zur Garnet-Ressource hinzuzufügen, rufen Sie die WithDataBindMount-Methode auf.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataBindMount(
                       source: @"C:\Garnet\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wichtig

Datenbindungs-Einhängepunkte basieren auf dem Dateisystem des Hosts, um die Garnet-Daten über Neustarts des Containers hinweg zu speichern. Die Datenbindemontage wird im Garnet-Container auf dem Hostcomputer auf dem Pfad C:\Garnet\Data unter Windows (oder /Garnet/Data auf Unix) eingehängt. Weitere Informationen zu Daten-Bind-Mounts finden Sie in der Docker Dokumentation: Bind mounts.

Hinzufügen einer Garnetressource mit Persistenz

Um der Garnet-Ressource Persistenz zu verleihen, rufen Sie die WithPersistence-Methode entweder mit dem Datenvolumen oder dem Datenbindungs-Mount auf:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Der vorangegangene Code fügt der Redis Ressource Persistenz hinzu, indem Momentaufnahmen der Garnet-Daten in einem angegebenen Intervall und bei einem Schwellenwert erstellt werden. Der interval ist die Zeit zwischen Momentaufnahme-Exporten und keysChangedThreshold ist die Anzahl der Schlüsseländerungsvorgänge, die zum Auslösen einer Momentaufnahme erforderlich sind. Weitere Informationen zur Persistenz finden Sie unter Redis Docs: Persistenz.

Die Valkey-Hostingintegration modelliert eine Valkey-Ressource als den Typ ValkeyResource. Um auf diesen Typ und diese APIs zuzugreifen, die es Ihnen ermöglichen, ihn zu Ihrem 📦Aspire.Hosting.Valkey-NuGet-Paket im App-Hostprojekt hinzuzufügen.

.NET CLI
PaketReferenz

dotnet add package Aspire.Hosting.Valkey

<PackageReference Include="Aspire.Hosting.Valkey"
                  Version="*" />

Weitere Informationen finden Sie unter dotnet add package oder Verwalten von Paketabhängigkeiten in .NET-Anwendungen.

Valkey-Ressource hinzufügen

Rufen Sie in Ihrem App-Hostprojekt AddValkey an der builder-Instanz auf, um eine Valkey-Ressource hinzuzufügen.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wenn .NET.NET Aspire dem Anwendungshost ein Containerimage hinzufügt, wie im vorherigen Beispiel mit dem docker.io/valkey/valkey-Image gezeigt, wird eine neue Valkey-Instanz auf dem lokalen Computer erstellt. Ein Verweis auf die Valkey-Ressource (die cache Variable) wird dem ExampleProjecthinzugefügt.

Die WithReference-Methode konfiguriert eine Verbindung im ExampleProject namens "cache". Weitere Informationen finden Sie unter Container-Ressourcenlebenszyklus.

Tipp

Wenn Sie lieber eine Verbindung mit einer vorhandenen Valkey-Instanz herstellen möchten, rufen Sie stattdessen AddConnectionString auf. Weitere Informationen finden Sie unter Verweisen auf vorhandene Ressourcen.

Hinzufügen einer Valkey-Ressource mit Datenvolume

Um der Valkey-Ressource ein Datenvolume hinzuzufügen, rufen Sie die AddValkey-Methode für die Valkey-Ressource auf:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Das Datenvolume wird verwendet, um die Valkey-Daten außerhalb des Lebenszyklus des Containers zu speichern. Das Datenvolumen wird im Valkey-Container am /data-Pfad bereitgestellt, und wenn kein name-Parameter angegeben wird, generiert sich der Name zufällig. Weitere Informationen zu Datenvolumes und Details dazu, warum sie gegenüber Bind-Mounts bevorzugt werden, finden Sie unter Docker Dokumentation: Volumes.

Hinzufügen einer Valkey-Ressource mit Datenbindungs-Bereitstellung

Rufen Sie die WithDataBindMount-Methode auf, um der Valkey-Ressource einen Daten-Bindungspunkt hinzuzufügen.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataBindMount(
                       source: @"C:\Valkey\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wichtig

Datenbindungs-Bereitstellungen basieren auf dem Dateisystem des Hostcomputers, um die Valkey-Daten über Containerneustarts hinweg beizubehalten. Das Daten-Bindemount ist auf dem C:\Valkey\Data unter Windows (oder /Valkey/Data auf Unix) Pfad auf dem Hostcomputer im Valkey-Container bereitgestellt. Weitere Informationen zu Daten-Bind-Mounts finden Sie in der Docker Dokumentation: Bind mounts.

Hinzufügen einer Valkey-Ressource mit Persistenz

Rufen Sie zum Hinzufügen der Persistenz zur Valkey-Ressource die WithPersistence-Methode entweder mit dem Datenvolume oder dem Datenbindungs-Mount auf:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Der vorangehende Code fügt der Redis-Ressource Persistenz hinzu, indem Momentaufnahmen der Valkey-Daten in einem angegebenen Intervall und Schwellenwert erstellt werden. Der interval ist die Zeit zwischen Momentaufnahme-Exporten und keysChangedThreshold ist die Anzahl der Schlüsseländerungsvorgänge, die zum Auslösen einer Momentaufnahme erforderlich sind. Weitere Informationen zur Persistenz finden Sie unter Redis Docs: Persistenz.

Durchführen von Integrations-Gesundheitsprüfungen

Die Redis Hostingintegration fügt automatisch eine Integritätsprüfung für den entsprechenden Ressourcentyp hinzu. Die Gesundheitsprüfung überprüft, ob der Server läuft und ob eine Verbindung hergestellt werden kann.

Die Hostingintegration basiert auf aspNetCore.HealthChecks📦.Redis NuGet-Paket.

Client Integration

Um mit der Integration des .NET Aspire Stack Exchange-Ausgabezwischenspeicherungsclients Redis zu beginnen, installieren Sie die 📦Aspire. StackExchange.Redis. OutputCaching NuGet-Paket im clientverwendenden Projekt, d. h. das Projekt für die Anwendung, die den Ausgabezwischenspeicherungsclient verwendet. Die Integration des Redis-Ausgabezwischenspeicherungsclients registriert die Dienste, die erforderlich sind, um CacheOutput-Methodenaufrufe zu aktivieren und das [OutputCache]-Attribut zu verwenden, indem Redis als Zwischenspeicherungsmechanismus genutzt wird.

.NET CLI
PaketReferenz

dotnet add package Aspire.StackExchange.Redis.OutputCaching

<PackageReference Include="Aspire.StackExchange.Redis.OutputCache"
                  Version="*" />

Ausgabe-Cache hinzufügen

Rufen Sie in der Datei Program.cs Ihres Client-konsumierenden Projekts die AddRedisOutputCache-Erweiterungsmethode bei jedem IHostApplicationBuilder auf, um die erforderlichen Dienste für die Ausgabezwischenspeicherung zu registrieren.

builder.AddRedisOutputCache(connectionName: "cache");

Tipp

Der parameter connectionName muss mit dem Namen übereinstimmen, der beim Hinzufügen der Redis-Ressource im App-Hostprojekt verwendet wird. Weitere Informationen finden Sie unter "Ressource hinzufügenRedis".

Tipp

Der parameter connectionName muss mit dem Namen übereinstimmen, der beim Hinzufügen der Garnet-Ressource im App-Hostprojekt verwendet wird. Weitere Informationen finden Sie unter "Garnet-Ressource hinzufügen".

Tipp

Der parameter connectionName muss mit dem Namen übereinstimmen, der beim Hinzufügen der Valkey-Ressource im App-Hostprojekt verwendet wird. Weitere Informationen finden Sie unter "Valkey-Ressource hinzufügen".

Fügen Sie die Middleware zur Anforderungsverarbeitungspipeline hinzu, indem Sie UseOutputCache(IApplicationBuilder)aufrufen:

var app = builder.Build();

app.UseOutputCache();

Konfigurieren Sie für minimale API-Apps einen Endpunkt für die Zwischenspeicherung durch Aufrufen CacheOutputoder Anwenden des OutputCacheAttributeEndpunkts, wie in den folgenden Beispielen gezeigt:

app.MapGet("/cached", () => "Hello world!")
   .CacheOutput();

app.MapGet(
    "/attribute",
    [OutputCache] () => "Hello world!");

Wenden Sie für Apps mit Controllern das attribut [OutputCache] auf die Aktionsmethode an. Wenden Sie für Razor Pages-Apps das Attribut auf die Razor-Seitenklasse an.

Konfiguration

Die .NET Aspire Stack Exchange Redis Ausgabezwischenspeicherungsintegration bietet mehrere Optionen zum Konfigurieren der Redis Verbindung basierend auf den Anforderungen und Konventionen Ihres Projekts.

Eine Verbindungszeichenfolge verwenden

Wenn Sie eine Verbindungszeichenfolge aus dem Konfigurationsabschnitt ConnectionStrings verwenden, können Sie beim Aufrufen von AddRedisOutputCacheden Namen der Verbindungszeichenfolge angeben:

builder.AddRedisOutputCache(connectionName: "cache");

Anschließend wird die Verbindungszeichenfolge aus dem Konfigurationsabschnitt ConnectionStrings abgerufen:

{
  "ConnectionStrings": {
    "cache": "localhost:6379"
  }
}

Weitere Informationen zum Formatieren dieser Verbindungszeichenfolge finden Sie in den Dokumentationen zur Stack Exchange-KonfigurationRedis.

Verwenden Sie Konfigurationsanbieter

Die .NET Aspire Stack Exchange Redis Output-Caching-Integration unterstützt Microsoft.Extensions.Configuration. Sie lädt StackExchangeRedisSettings mithilfe des Schlüssels Aspire:StackExchange:Redis aus der Konfiguration ein. Beispiel appsettings.json, das einige der Optionen konfiguriert:

{
  "Aspire": {
    "StackExchange": {
      "Redis": {
        "ConfigurationOptions": {
          "ConnectTimeout": 3000,
          "ConnectRetry": 2
        },
        "DisableHealthChecks": true,
        "DisableTracing": false
      }
    }
  }
}

Das vollständige Redis Integrationsschema für den Ausgabezwischenspeicherungsclient JSON finden Sie unter Aspire. StackExchange.Redis. OutputCaching/ConfigurationSchema.json.

Inline-Delegaten verwenden

Sie können auch den Delegaten Action<StackExchangeRedisSettings> configurationSettings übergeben, um einige oder alle Optionen direkt im Code einzurichten, z. B. um Gesundheitsprüfungen aus dem Code zu deaktivieren.

builder.AddRedisOutputCache(
    "cache",
    static settings => settings.DisableHealthChecks  = true);

Sie können die ConfigurationOptions auch mithilfe des Action<ConfigurationOptions> configureOptions Delegatparameters der AddRedisOutputCache Methode einrichten. Beispiel: Festlegen des Verbindungstimeouts:

builder.AddRedisOutputCache(
    "cache",
    static settings => settings.ConnectTimeout = 3_000);

Client Integrationsgesundheitsprüfungen

Standardmäßig sind für alle Dienste .NET aktiviert..NET Aspire Ebenso aktivieren viele .NET.NET AspireHosting-Integrationen auch Gesundheitsprüfungsendpunkte. Weitere Informationen finden Sie unter:

Die .NET Aspire Stack Exchange Redis Ausgabe-Cache-Integration behandelt Folgendes:

Fügt die Integritätsprüfung hinzu, wenn StackExchangeRedisSettings.DisableHealthChecksfalse ist und versucht, eine Verbindung mit der Containerinstanz herzustellen.
Integriert in den /health HTTP-Endpunkt, der angibt, dass alle registrierten Gesundheitsprüfungen erfolgreich sein müssen, damit die App als bereit zur Annahme von Datenverkehr gilt.

Observability und Telemetrie

.NET .NET Aspire Integrationen richten automatisch Protokollierungs-, Ablaufverfolgungs- und Metrikkonfigurationen ein, die manchmal als Säulen der Observability bezeichnet werden. Weitere Informationen zur Integrationsbeobachtbarkeit und Telemetrie finden Sie in.NET.NET Aspire der Übersicht über Integrationen. Abhängig vom Unterstützungsdienst könnten einige Integrationen nur einige dieser Funktionen unterstützen. Beispielsweise unterstützen einige Integrationen Protokollierung und Ablaufverfolgung, aber keine Metriken. Telemetriefeatures können auch mithilfe der im Abschnitt "Konfiguration " dargestellten Techniken deaktiviert werden.

Protokollierung

Die Integration von .NET Aspire Stack Exchange Redis Ausgabecaching verwendet die folgenden Protokollkategorien:

Aspire.StackExchange.Redis
Microsoft.AspNetCore.OutputCaching.StackExchangeRedis

Nachverfolgung

Die Stack Exchange-Ausgabecaching-Integration wird die folgenden Tracing-Aktivitäten unter Verwendung von .NET Aspire ausgeben:

OpenTelemetry.Instrumentation.StackExchangeRedis

Metriken

Die Integration der Ausgabezwischenspeicherung durch .NET Aspire Stack Exchange Redis unterstützt standardmäßig keine Metriken aufgrund von Einschränkungen durch die StackExchange.Redis-Bibliothek.

Siehe auch

*: Redis ist eine eingetragene Marke von Redis Ltd. Alle dort enthaltenen Rechte sind Redis Ltd. vorbehalten. Jede Verwendung durch Microsoft dient nur zu referenziellen Zwecken und gibt keine Unterstützung, Bestätigung oder Zugehörigkeit zwischen Redis und Microsoft an. Zurück zum Anfang

Freigeben über

.NET Aspire Redis®* Ausgabe-Caching-Integration

Hosting-Integration

Die Ressource Redis hinzufügen

Fügen Sie mit Redis Insights die Redis Resource hinzu

Füge Redis Ressource mit Redis Commander hinzu

Fügen Sie die Redis-Ressource mit Datenvolumen hinzu

Ressource mit Daten-Bind-Mount hinzufügen Redis

Fügen Sie die Redis-Ressource mit Persistenz hinzu.

Garnet-Ressource hinzufügen

Hinzufügen einer Garnet-Ressource mit Datenvolume

Hinzufügen einer Garnet-Ressource mit Datenbindungs-Bereitstellung

Hinzufügen einer Garnetressource mit Persistenz

Valkey-Ressource hinzufügen

Hinzufügen einer Valkey-Ressource mit Datenvolume

Hinzufügen einer Valkey-Ressource mit Datenbindungs-Bereitstellung

Hinzufügen einer Valkey-Ressource mit Persistenz

Durchführen von Integrations-Gesundheitsprüfungen

Client Integration

Ausgabe-Cache hinzufügen

Konfiguration

Eine Verbindungszeichenfolge verwenden

Verwenden Sie Konfigurationsanbieter

Inline-Delegaten verwenden

Client Integrationsgesundheitsprüfungen

Observability und Telemetrie

Protokollierung

Nachverfolgung

Metriken

Siehe auch

Zusätzliche Ressourcen

.NET Aspire Redis®^* Ausgabe-Caching-Integration