Freigeben über

.NET Aspire Redis®* Integration für verteiltes Caching

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

Erfahren Sie, wie Sie die .NET Aspire- undRedis-verteilte Caching-Integration verwenden. Die Aspire.StackExchange.Redis.DistributedCaching Bibliothek wird verwendet, um einen IDistributedCache-Anbieter zu registrieren, der von einem Redis Server mit dem docker.io/library/redis Containerimage unterstützt wird.

Erfahren Sie, wie Sie die .NET Aspire- undRedis-verteilte Caching-Integration verwenden. Die Aspire.StackExchange.Redis.DistributedCaching Bibliothek wird verwendet, um einen IDistributedCache-Anbieter zu registrieren, der von einem Garnet-Server mit dem ghcr.io/microsoft/garnet Containerimage unterstützt wird.

Erfahren Sie, wie Sie die .NET Aspire- undRedis-verteilte Caching-Integration verwenden. Die Aspire.StackExchange.Redis.DistributedCaching Bibliothek wird verwendet, um einen IDistributedCache-Anbieter zu registrieren, der von einem Valkey-Server mit dem docker.io/valkey/valkey Containerimage unterstützt wird.

Einbindung von Hosting

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

dotnet add package Aspire.Hosting.Redis

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

Hinzufügen einer Redis-Ressource

Rufen Sie in Ihrem App-Host-Projekt AddRedis in der builder-Instanz 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. Ein Verweis auf Ihre Redis Ressource (die cache Variable) wird dem ExampleProjecthinzugefügt.

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

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.

Ressource Redis mit Redis Insights hinzufügen

Rufen Sie die Redis-Methode auf, um die zur Redis Ressource hinzuzufügen.

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 zum Analysieren von Redis Daten auf allen Betriebssystemen und Redis Bereitstellungen mit Hilfe unseres KI-Assistenten, Redis Copilot. .NET .NET Aspire fügt dem App-Host, der die Commander-App ausführt, ein weiteres Container-Image docker.io/redis/redisinsight hinzu.

Anmerkung

Um den Hostport für die RedisInsightResource-Kette zu konfigurieren, rufen Sie die WithHostPort-API auf und geben Sie die gewünschte Portnummer an.

Ressource Redis mit Commander Redis hinzufügen

Rufen Sie die Methode Redis auf, um den Redis zur WithRedisCommander Ressource hinzuzufügen.

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 Container-Image docker.io/rediscommander/redis-commander hinzu.

Tipp

Um den Hostport für die RedisCommanderResource-Kette zu konfigurieren, rufen Sie die WithHostPort-API auf und geben Sie die gewünschte Portnummer an.

Redis Ressource mit Datenvolumen hinzufügen

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 Datenvolumen wird verwendet, um die Redis Daten außerhalb des Lebenszyklus des Containers zu speichern. Das Datenvolume wird am /data Pfad im container Redis bereitgestellt, und wenn kein name Parameter angegeben wird, wird der Name zufällig generiert. Weitere Informationen zu Datenvolumes und Einzelheiten, warum sie Bind-Mounts vorzuziehen sind, siehe Docker docs: Volumes.

Füge Redis-Ressource mit Datenbindemontage hinzu

Rufen Sie die Redis-Methode auf, um der WithDataBindMount-Ressource ein Datenbindungs-Mount 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 auf und Änderungen an Dateien auf dem Hostsystem, ideal für Entwicklung und Tests, bei denen Echtzeitänderungen nötig sind.

Daten-Bind-Mounts basieren auf dem Dateisystem des Hostcomputers, um die Redis Daten über Containerneustarts hinweg fortbestehen zu lassen. Die Daten-Bind-Mount wird auf dem C:\Redis\Data-Pfad unter Windows (oder auf dem /Redis/Data-Unix-Pfad) auf dem Hostcomputer im Container Redis bereitgestellt. Weitere Informationen zu 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 Redis Ressource die WithPersistence-Methode entweder mit dem Datenvolume oder dem Datenbindungs-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 vorangehende Code fügt der Redis Ressource Persistenz hinzu, indem Momentaufnahmen der Redis Daten in einem angegebenen Intervall und Schwellenwert erstellt werden. Die interval ist die Zeit zwischen Momentaufnahmenexporten und der keysChangedThreshold 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 den GarnetResource-Typ. Um auf diesen Typ und die APIs zuzugreifen, die es Ihnen ermöglichen, ihn Ihrem 📦Aspire.Hosting.Garnet NuGet-Paket im App-Hostprojekt hinzuzufügen.

dotnet add package Aspire.Hosting.Garnet

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 im obigen Beispiel mit dem ghcr.io/microsoft/garnet-Image gezeigt, wird eine neue Garnet-Instanz auf dem lokalen Computer erstellt. Ein Verweis auf Ihre Garnet-Ressource (cache-Variable) wird zu ExampleProjecthinzugefügt.

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

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 /data-Pfad im Garnet-Container bereitgestellt, und wenn kein name-Parameter angegeben wird, wird der Name zufällig generiert. Weitere Informationen zu Datenvolumes und Einzelheiten, warum sie Bind-Mounts vorzuziehen sind, siehe Docker docs: Volumes.

Hinzufügen einer Garnet-Ressource mit Datenbindungs-Bereitstellung

Um eine Datenbindung 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-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 auf und Änderungen an Dateien auf dem Hostsystem, ideal für Entwicklung und Tests, bei denen Echtzeitänderungen nötig sind.

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

Garnet-Ressource mit Persistenz hinzufügen

Um der Garnet-Ressource Persistenz hinzuzufügen, rufen Sie die WithPersistence-Methode entweder mit dem Datenvolume 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 vorangehende Code fügt der Redis Ressource Persistenz hinzu, indem Momentaufnahmen der Garnet-Daten in einem angegebenen Intervall und Schwellenwert erstellt werden. Die interval ist die Zeit zwischen Momentaufnahmenexporten und der keysChangedThreshold 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-Hosting-Integration modelliert eine Valkey-Ressource als Typ ValkeyResource. Um auf diesen Typ und diese APIs zuzugreifen, die es Ihnen ermöglichen, ihn Ihrem NuGet-Paket 📦Aspire.Hosting.Valkey im App-Hostprojekt hinzuzufügen.

dotnet add package Aspire.Hosting.Valkey

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-Host-Projekt die Methode AddValkey auf 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 App-Host ein Containerimage hinzufügt, wie im vorherigen Beispiel mit dem Image docker.io/valkey/valkey gezeigt wird, 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 Lebenszyklus von Container-Ressourcen.

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 am Pfad /data im Valkey-Container eingehängt und wenn kein Parameter name angegeben ist, wird der Name zufällig generiert. Weitere Informationen zu Datenvolumes und Einzelheiten, warum sie Bind-Mounts vorzuziehen sind, siehe Docker docs: Volumes.

Hinzufügen einer Valkey-Ressource mit Datenbindungs-Bereitstellung

Rufen Sie die WithDataBindMount-Methode auf, um der Valkey-Ressource eine Datenbindungsmontierung 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-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 auf und Änderungen an Dateien auf dem Hostsystem, ideal für Entwicklung und Tests, bei denen Echtzeitänderungen nötig sind.

Datenbindungs-Bereitstellungen basieren auf dem Dateisystem des Hostcomputers, um die Valkey-Daten über Containerneustarts hinweg beizubehalten. Die Datenbindung wird unter Windows an C:\Valkey\Data (oder auf /Valkey/Data und Unix) auf dem Hostcomputer im Valkey-Container eingehängt. Weitere Informationen zu 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 vorhergehende Code fügt der Redis-Ressource Persistenz hinzu, indem Momentaufnahmen der Valkey-Daten zu einem angegebenen Intervall und Schwellenwert erstellt werden. Die interval ist die Zeit zwischen Momentaufnahmenexporten und der keysChangedThreshold 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.

Integritätsprüfungen für Hosting-Integrationen

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 der .NET AspireRedis verteilten Zwischenspeicherung zu beginnen, installieren Sie die 📦Aspire. StackExchange.Redis. DistributedCaching NuGet-Paket im clientverwendenden Projekt, d. h. das Projekt für die Anwendung, die den Redis verteilten Cacheclient verwendet. Die Redis Clientintegration registriert eine IDistributedCache Instanz, die Sie für die Interaktion mit Redisverwenden können.

dotnet add package Aspire.StackExchange.Redis.DistributedCaching

Füge Redis-Kunden hinzu

Rufen Sie in der Program.cs Datei Ihres clientnutzenden Projekts die AddRedisDistributedCache Erweiterung auf, um die erforderlichen Dienste für das verteilte Caching zu registrieren und fügen Sie einen IDistributedCache zur Verwendung über den Dependency Injection Container hinzu.

builder.AddRedisDistributedCache(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".

Anschließend können Sie die IDistributedCache Instanz mithilfe der Abhängigkeitseinfügung abrufen. So rufen Sie beispielsweise den Cache aus einem Dienst ab:

public class ExampleService(IDistributedCache cache)
{
    // Use cache...
}

Weitere Informationen zur Abhängigkeitsinjektion finden Sie unter .NET Abhängigkeitsinjektion.

Gekennzeichneten Redis-Client hinzufügen

Aufgrund seiner Einschränkungen können Sie nicht mehrere IDistributedCache Instanzen gleichzeitig registrieren. Es kann jedoch Szenarien geben, in denen Sie mehrere Redis Clients registrieren und eine bestimmte IDistributedCache Instanz für einen bestimmten Verbindungsnamen verwenden müssen. Rufen Sie die Redis Methode auf, um einen schlüsselierten IDistributedCache Client zu registrieren, der für den AddKeyedRedisDistributedCache Dienst verwendet wird:

builder.AddKeyedRedisClient(name: "chat");
builder.AddKeyedRedisDistributedCache(name: "product");

Anschließend können Sie die Instanz mithilfe der IDistributedCache Abhängigkeitseinfügung abrufen. So rufen Sie beispielsweise die Verbindung aus einem Beispieldienst ab:

public class ExampleService(
    [FromKeyedServices("chat")] IConnectionMultiplexer chatConnectionMux,
    IDistributedCache productCache)
{
    // Use product cache...
}

Weitere Informationen zu schlüsselbasierten Diensten finden Sie unter .NET Abhängigkeitseinfügung: Schlüsseldienste.

Konfiguration

Die .NET AspireRedis Integration verteilter Zwischenspeicherung bietet mehrere Optionen zum Konfigurieren der Redis Verbindung basierend auf den Anforderungen und Konventionen Ihres Projekts.

Verwenden Sie eine Verbindungszeichenfolge

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

builder.AddRedisDistributedCache("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.

Konfigurationsanbieter verwenden

Die verteilte Caching-Integration von .NET Aspire Stack Exchange Redis unterstützt Microsoft.Extensions.Configuration. Sie lädt die StackExchangeRedisSettings aus der Konfiguration mithilfe des Aspire:StackExchange:Redis Schlüssels. 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 verteilte Cacheclients JSON finden Sie unter Aspire. StackExchange.Redis. DistributedCaching/ConfigurationSchema.json.

Inline-Delegaten verwenden

Sie können auch den Action<StackExchangeRedisSettings> Delegat übergeben, um einige oder alle Optionen inline einzurichten, z. B. zum Konfigurieren von DisableTracing:

builder.AddRedisDistributedCache(
    "cache",
    settings => settings.DisableTracing = true);

Sie können die ConfigurationOptions auch mithilfe des Action<ConfigurationOptions> configureOptions Delegatparameters der AddRedisDistributedCache Methode einrichten. Zum Beispiel, um das Verbindungstimeout festzulegen:

builder.AddRedisDistributedCache(
    "cache",
     null,
     static options => options.ConnectTimeout = 3_000);

Client Integrationsgesundheitsprüfungen

Standardmäßig sind die .NET.NET AspireKundenintegrationen so konfiguriert, dass Integritätsprüfungen für alle Dienste aktiviert sind. Ebenso aktivieren viele .NET.NET AspireHostingintegrationen auch Integritätsprüfungsendpunkte. Weitere Informationen finden Sie unter:

Die .NET AspireRedis Verteilte Cache-Integration behandelt Folgendes:

  • Fügt die Integritätsprüfung hinzu, wenn StackExchangeRedisSettings.DisableHealthChecksfalse ist, was versucht, eine Verbindung mit der Containerinstanz herzustellen.
  • Integriert sich in den /health HTTP-Endpunkt, der spezifiziert, dass alle registrierten Gesundheitsprüfungen erfolgreich sein müssen, damit die App bereit ist, Datenverkehr anzunehmen.

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 Integrations observability und Telemetrie finden Sie in.NET.NET Aspire der Übersicht über Integrationen. Abhängig vom Backend-Dienst unterstützen einige Integrationen möglicherweise nur einige dieser Funktionen. 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 .NET AspireRedis Integration verteilter Zwischenspeicherung verwendet die folgenden Protokollkategorien:

  • Aspire.StackExchange.Redis
  • Microsoft.Extensions.Caching.StackExchangeRedis

Nachverfolgung

Die .NET AspireRedis Integration für verteilte Caches wird die folgenden Tracing-Aktivitäten mithilfe von OpenTelemetryausgeben:

  • OpenTelemetry.Instrumentation.StackExchangeRedis

Kennzahlen

Die .NET AspireRedis-Integration der verteilten Zwischenspeicherung unterstützt Metriken derzeit nicht von Haus aus wegen Einschränkungen mit der 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 stellt keine Unterstützung, Bestätigung oder Zugehörigkeit zwischen Redis und Microsoft dar. Zurück zum Anfang?