integracja .NET AspireAzure Cosmos DB

Artykuł
03/05/2025

obejmuje: integracja hostingu oraz integracja Client

Azure Cosmos DB to w pełni zarządzana usługa bazy danych NoSQL na potrzeby nowoczesnego tworzenia aplikacji. Integracja .NET AspireAzure Cosmos DB umożliwia łączenie się z istniejącymi wystąpieniami Cosmos DB lub tworzenie nowych wystąpień z .NET za pomocą emulatora Azure Cosmos DB.

Integracja hostingu

Model integracji hostingu .NET.NET AspireAzure Cosmos DB przedstawia różne zasoby Cosmos DB jako następujące typy:

AzureCosmosDBResource: reprezentuje zasób AzureAzure Cosmos DB.
AzureCosmosDBEmulatorResource: reprezentuje zasób emulatora AzureAzure Cosmos DB.

Aby uzyskać dostęp do tych typów i powiązanych z nimi interfejsów API, dodaj pakiet NuGet 📦Aspire.Hosting.Azure.CosmosDB do projektu hosta aplikacji .

.NET CLI
PackageReference

dotnet add package Aspire.Hosting.Azure.CosmosDB

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

Aby uzyskać więcej informacji, zobacz dotnet add package lub zarządzanie zależnościami pakietów w aplikacjach .NET.

Dodawanie zasobu AzureAzure Cosmos DB

W projekcie hosta aplikacji wywołaj AddAzureCosmosDB, aby dodać i zwrócić AzureAzure Cosmos DB twórcę zasobów.

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db");

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

Po dodaniu AzureCosmosDBResource do hosta aplikacji, udostępnia on inne przydatne interfejsy API do dodawania baz danych i kontenerów. Innymi słowy, należy dodać AzureCosmosDBResource przed dodaniem jakiegokolwiek innego Cosmos DB zasobu.

Ważny

Podczas wywoływania AddAzureCosmosDB, automatycznie wywołuje AddAzureProvisioning, co dodaje wsparcie dla dynamicznego generowania zasobów Azure podczas uruchamiania aplikacji. Aplikacja musi skonfigurować odpowiednią subskrypcję i lokalizację. Aby uzyskać więcej informacji, zobacz Lokalne przygotowanie: Konfiguracja.

Wygenerowana konfiguracja Bicep

Jeśli jesteś nowy w korzystaniu z Bicep, jest to język specyficzny dla domeny wykorzystywany do definiowania zasobów Azure. W przypadku .NET.NET Aspirenie musisz pisać Bicep ręcznie, ponieważ interfejsy API do aprowizacji generują Bicep za Ciebie. Podczas publikowania aplikacji wygenerowany Bicep zostaje wyświetlony wraz z plikiem manifestu. Po dodaniu zasobu AzureAzure Cosmos DB zostanie wygenerowany następujący kod Bicep:

@description('The location for the resource(s) to be deployed.')
param location string = resourceGroup().location

param principalType string

param principalId string

resource cosmos 'Microsoft.DocumentDB/databaseAccounts@2024-08-15' = {
  name: take('cosmos-${uniqueString(resourceGroup().id)}', 44)
  location: location
  properties: {
    locations: [
      {
        locationName: location
        failoverPriority: 0
      }
    ]
    consistencyPolicy: {
      defaultConsistencyLevel: 'Session'
    }
    databaseAccountOfferType: 'Standard'
    disableLocalAuth: true
  }
  kind: 'GlobalDocumentDB'
  tags: {
    'aspire-resource-name': 'cosmos'
  }
}

resource cosmos_roleDefinition 'Microsoft.DocumentDB/databaseAccounts/sqlRoleDefinitions@2024-08-15' existing = {
  name: '00000000-0000-0000-0000-000000000002'
  parent: cosmos
}

resource cosmos_roleAssignment 'Microsoft.DocumentDB/databaseAccounts/sqlRoleAssignments@2024-08-15' = {
  name: guid(principalId, cosmos_roleDefinition.id, cosmos.id)
  properties: {
    principalId: principalId
    roleDefinitionId: cosmos_roleDefinition.id
    scope: cosmos.id
  }
  parent: cosmos
}

output connectionString string = cosmos.properties.documentEndpoint

Powyższy Bicep to moduł, który dostarcza następujące wartości domyślne dla konta AzureAzure Cosmos DB.

kind: rodzaj konta Cosmos DB. Wartość domyślna to GlobalDocumentDB.
consistencyPolicy: polityka spójności konta Cosmos DB. Wartość domyślna to Session.
locations: lokalizacje konta Cosmos DB. Wartość domyślna to lokalizacja grupy zasobów.

Oprócz konta Cosmos DB dodaje również bieżącą aplikację do roli Data Contributor dla konta Cosmos DB. Wygenerowany Bicep jest punktem wyjścia i ma wpływ na zmiany w infrastrukturze aprowizacji w języku C#. Modyfikacje pliku Bicep, które zostaną wprowadzone bezpośrednio, będą nadpisane. Dlatego należy wprowadzać je za pośrednictwem interfejsów API aprowizowania w języku C#, aby zapewnić, że zostaną odzwierciedlone w wygenerowanych plikach.

Dostosowywanie infrastruktury aprowizacji

Wszystkie zasoby .NET AspireAzure to podklasy typu AzureProvisioningResource. Ten typ umożliwia dostosowanie wygenerowanego kodu Bicep poprzez zapewnienie płynnego interfejsu API do konfigurowania zasobów Azure przy użyciu API ConfigureInfrastructure<T>(IResourceBuilder<T>, Action<AzureResourceInfrastructure>). Można na przykład skonfigurować kind, consistencyPolicy, locationsi więcej. W poniższym przykładzie pokazano, jak dostosować zasób AzureAzure Cosmos DB:

builder.AddAzureCosmosDB("cosmos-db")
    .ConfigureInfrastructure(infra =>
    {
        var cosmosDbAccount = infra.GetProvisionableResources()
                                   .OfType<CosmosDBAccount>()
                                   .Single();

        cosmosDbAccount.Kind = CosmosDBAccountKind.MongoDB;
        cosmosDbAccount.ConsistencyPolicy = new()
        {
            DefaultConsistencyLevel = DefaultConsistencyLevel.Strong,
        };
        cosmosDbAccount.Tags.Add("ExampleKey", "Example value");
    });

Powyższy kod:

Łańcuch wywołania interfejsu API ConfigureInfrastructure:
- Parametr infra jest wystąpieniem typu AzureResourceInfrastructure.
- Zasoby możliwe do aprowizacji są pobierane przez wywołanie metody GetProvisionableResources().
- Pobierana jest pojedyncza CosmosDBAccount.
- CosmosDBAccount.ConsistencyPolicy jest przypisywany do DefaultConsistencyLevel.Strong.
- Tag jest dodawany do konta Cosmos DB z kluczem ExampleKey i wartością Example value.

Dostępnych jest wiele opcji konfiguracji umożliwiających dostosowanie zasobu AzureAzure Cosmos DB. Aby uzyskać więcej informacji, zobacz Azure.Provisioning.CosmosDB. Aby uzyskać więcej informacji, zobacz Azure. Dostosowywanie provisioningu.

Nawiązywanie połączenia z istniejącym kontem AzureAzure Cosmos DB

Być może masz istniejące konto AzureAzure Cosmos DB, z którym chcesz nawiązać połączenie. Zamiast reprezentować nowy zasób AzureAzure Cosmos DB, można dodać ciąg połączenia do hosta aplikacji. Aby dodać połączenie z istniejącym kontem AzureAzure Cosmos DB, wywołaj metodę AddConnectionString:

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddConnectionString("cosmos-db");

builder.AddProject<Projects.WebApplication>("web")
       .WithReference(cosmos);

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

Notatka

Parametry połączenia służą do reprezentowania szerokiego zakresu informacji o połączeniu, w tym połączeń z bazą danych, brokerów komunikatów, identyfikatorów URI punktów końcowych i innych usług. W .NET.NET Aspire nomenklaturze termin "parametry połączenia" służy do reprezentowania wszelkich informacji o połączeniu.

Ciąg połączenia jest konfigurowany w konfiguracji hosta aplikacji, zazwyczaj w obszarze Tajne dane użytkownika, w sekcji ConnectionStrings. Host aplikacji wprowadza te parametry połączenia jako zmienną środowiskową do wszystkich zasobów zależnych, na przykład:

{
    "ConnectionStrings": {
        "cosmos-db": "AccountEndpoint=https://{account_name}.documents.azure.com:443/;AccountKey={account_key};"
    }
}

Zasób zależny może uzyskać dostęp do wstrzykiwanych parametrów połączenia, wywołując metodę GetConnectionString i przekazując nazwę połączenia jako parametr, w tym przypadku "cosmos-db". Interfejs API GetConnectionString to skrót od IConfiguration.GetSection("ConnectionStrings")[name].

Dodawanie AzureAzure Cosmos DB zasobów bazy danych i kontenerów

Aby dodać zasób bazy danych AzureAzure Cosmos DB, wywołaj metodę AddCosmosDatabase w wystąpieniu IResourceBuilder<AzureCosmosDBResource>:

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db");
cosmos.AddCosmosDatabase("db");

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

Podczas wywoływania AddCosmosDatabaseprogram dodaje bazę danych o nazwie db do zasobów Cosmos DB i zwraca nowo utworzony zasób bazy danych. Baza danych jest tworzona na koncie Cosmos DB, które jest reprezentowane przez AzureCosmosDBResource, który został dodany wcześniej. Baza danych jest kontenerem logicznym dla kolekcji i użytkowników.

Kontener AzureAzure Cosmos DB to miejsce przechowywania danych. Podczas tworzenia kontenera należy podać klucz partycji.

Aby dodać zasób kontenera AzureAzure Cosmos DB, wywołaj metodę AddContainer w wystąpieniu IResourceBuilder<AzureCosmosDBDatabaseResource>:

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db");
var db = cosmos.AddCosmosDatabase("db");
db.AddContainer("entries", "/id");

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

Kontener jest tworzony w bazie danych, którą reprezentuje wcześniej dodany AzureCosmosDBDatabaseResource.

Aby uzyskać więcej informacji, zobacz Bazy danych, kontenery i elementy w AzureAzure Cosmos DB.

Dodawanie zasobu emulatora AzureAzure Cosmos DB

Aby dodać zasób emulatora AzureAzure Cosmos DB, zlinkuj wywołanie IResourceBuilder<AzureCosmosDBResource> z interfejsem API RunAsEmulator.

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db")
                    .RunAsEmulator();

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

Podczas wywoływania RunAsEmulatorprogram konfiguruje zasoby Cosmos DB do uruchamiania lokalnego przy użyciu emulatora. Emulator w tym przypadku to AzureAzure Cosmos DB Emulator. Emulator Azure Cosmos DB zapewnia bezpłatne środowisko lokalne do testowania aplikacji Azure Cosmos DB i jest doskonałym towarzyszem integracji .NET AspireAzure hostingu. Emulator nie jest zainstalowany, a zamiast tego jest dostępny do .NET.NET Aspire jako kontener. Po dodaniu kontenera do hosta aplikacji, jak pokazano w poprzednim przykładzie z obrazem mcr.microsoft.com/cosmosdb/emulator, tworzy i uruchamia kontener po uruchomieniu hosta aplikacji. Aby uzyskać więcej informacji, zobacz Cykl życia zasobów kontenera.

Konfigurowanie kontenera emulatora Cosmos DB

Istnieją różne konfiguracje dostępne dla zasobów kontenera. Na przykład można skonfigurować porty kontenera, zmienne środowiskowe, jego żywotnośći nie tylko.

Konfigurowanie portu bramy kontenera emulatora Cosmos DB

Domyślnie kontener emulatora Cosmos DB skonfigurowany przez .NET Aspireuwidacznia następujące punkty końcowe:

Punkt końcowy	Port kontenerowy	Port hosta
`https`	8081	dynamiczny

Port, na który nasłuchuje, jest domyślnie dynamiczny. Po uruchomieniu kontenera port jest mapowany na losowy port na maszynie hosta. Aby skonfigurować port punktu końcowego, użyj sekwencji wywołań na budowniczym zasobów kontenera dostarczonym przez metodę RunAsEmulator, jak pokazano w poniższym przykładzie:

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db").RunAsEmulator(
                     emulator =>
                     {
                         emulator.WithGatewayPort(7777);
                     });

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

Powyższy kod konfiguruje istniejący punkt końcowy Cosmos DB kontenera emulatora https do nasłuchiwania na porcie 8081. Port kontenera emulatora Cosmos DB jest mapowany na port hosta, jak pokazano w poniższej tabeli:

Nazwa punktu końcowego	Mapowanie portów (`container:host`)
`https`	`8081:7777`

Konfigurowanie kontenera emulatora Cosmos DB z trwałym okresem istnienia

Aby skonfigurować kontener emulatora Cosmos DB z trwałym okresem istnienia, wywołaj metodę WithLifetime w zasobie kontenera emulatora Cosmos DB i przekaż ContainerLifetime.Persistent:

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db").RunAsEmulator(
                     emulator =>
                     {
                         emulator.WithLifetime(ContainerLifetime.Persistent);
                     });

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

Aby uzyskać więcej informacji, zobacz okres istnienia zasobu kontenera.

Konfigurowanie kontenera emulatora Cosmos DB za pomocą woluminu danych

Aby dodać wolumin danych do zasobu emulatora AzureAzure Cosmos DB, wywołaj metodę WithDataVolume w zasobie emulatora AzureAzure Cosmos DB:

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db").RunAsEmulator(
                     emulator =>
                     {
                         emulator.WithDataVolume();
                     });

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

Wolumin danych służy do utrwalania danych emulatora Cosmos DB poza cyklem życia kontenera. Wolumen danych jest zamontowany na ścieżce /tmp/cosmos/appdata w kontenerze emulatora Cosmos DB, a gdy nie podano parametru name, generowana jest nazwa. Emulator ma zmienną środowiskową AZURE_COSMOS_EMULATOR_ENABLE_DATA_PERSISTENCE ustawioną na true. Aby uzyskać więcej informacji na temat wolumenów danych i szczegółów na temat tego, dlaczego są preferowane nad podmontowaniami wiążącymi, zobacz dokumentację Docker: Wolumeny.

Konfigurowanie liczby partycji kontenera emulatora Cosmos DB

Aby skonfigurować liczbę partycji kontenera emulatora Cosmos DB, wywołaj metodę WithPartitionCount:

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db").RunAsEmulator(
                     emulator =>
                     {
                         emulator.WithPartitionCount(100); // Defaults to 25
                     });

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

Powyższy kod konfiguruje kontener emulatora Cosmos DB tak, aby miał liczbę partycji 100. Jest to skrót do ustawiania zmiennej środowiskowej AZURE_COSMOS_EMULATOR_PARTITION_COUNT.

Korzystanie z emulatora opartego na Linux(wersja zapoznawcza)

emulator nowej generacji AzureAzure Cosmos DB jest całkowicie oparty na Linuxi jest dostępny w kontenerze Docker. Obsługuje on uruchamianie na wielu różnych procesorach i systemach operacyjnych.

Aby użyć wersji zapoznawczej emulatora Cosmos DB, wywołaj metodę RunAsPreviewEmulator. Ponieważ ta funkcja jest dostępna w wersji zapoznawczej, musisz jawnie wyrazić zgodę na jej użycie, pomijając eksperymentalną diagnostykę ASPIRECOSMOSDB001.

Emulator wersji zapoznawczej obsługuje również uwidacznianie punktu końcowego "Eksplorator danych", który umożliwia wyświetlanie danych przechowywanych w emulatorze Cosmos DB za pośrednictwem internetowego interfejsu użytkownika. Aby włączyć Eksplorator danych, wywołaj metodę WithDataExplorer.

#pragma warning disable ASPIRECOSMOSDB001

var builder = DistributedApplication.CreateBuilder(args);

var cosmos = builder.AddAzureCosmosDB("cosmos-db").RunAsPreviewEmulator(
                     emulator =>
                     {
                         emulator.WithDataExplorer();
                     });

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

Powyższy kod konfiguruje podglądowy kontener emulatora oparty na Linux, z punktem końcowym eksploratora danych Cosmos DB, do użycia podczas działania.

Sprawdzanie stanu integracji hostingu

Integracja hostowania Azure Cosmos DB automatycznie dodaje kontrolę kondycji zasobu Cosmos DB. Kontrola stanu sprawdza, czy Cosmos DB jest uruchomione i czy można nawiązać z nim połączenie.

Integracja hostingu opiera się na pakiecie NuGet 📦 AspNetCore.HealthChecks.CosmosDb.

Client integracja

Aby rozpocząć pracę z integracją klienta .NET AspireAzure Cosmos DB, zainstaluj pakiet NuGet 📦Aspire.Microsoft.Azure.Cosmos w projekcie aplikacji korzystającej z klienta Cosmos DB. Integracja klienta Cosmos DB rejestruje wystąpienie CosmosClient, którego można użyć do interakcji z Cosmos DB.

.NET CLI
PackageReference

dotnet add package Aspire.Microsoft.Azure.Cosmos

<PackageReference Include="Aspire.Microsoft.Azure.Cosmos"
                  Version="*" />

Dodaj klienta Cosmos DB

W pliku Program.cs projektu wykorzystującego klienta, wywołaj metodę rozszerzenia AddAzureCosmosClient na dowolnym IHostApplicationBuilder, aby zarejestrować CosmosClient do użycia za pośrednictwem kontenera wstrzykiwania zależności. Metoda przyjmuje parametr nazwy połączenia.

builder.AddAzureCosmosClient(connectionName: "cosmos-db");

Napiwek

Parametr connectionName musi być zgodny z nazwą używaną podczas dodawania zasobu Cosmos DB w projekcie hosta aplikacji. Innymi słowy, podczas wywoływania AddAzureCosmosDB, podając nazwę cosmos-db, tej samej nazwy należy użyć podczas wywoływania AddAzureCosmosClient. Aby uzyskać więcej informacji, zobacz Dodawanie zasobu AzureAzure Cosmos DB.

Następnie za pomocą wstrzykiwania zależności można uzyskać instancję CosmosClient. Aby na przykład pobrać połączenie z przykładowej usługi:

public class ExampleService(CosmosClient client)
{
    // Use client...
}

Aby uzyskać więcej informacji o wstrzykiwaniu zależności, odwiedź stronę .NETwstrzykiwanie zależności.

Dodaj klienta Cosmos DB z kluczem

Mogą wystąpić sytuacje, w których chcesz zarejestrować wiele wystąpień CosmosClient z różnymi nazwami połączeń. Aby zarejestrować klientów powiązanych z kluczem Cosmos DB, wywołaj metodę AddKeyedAzureCosmosClient.

builder.AddKeyedAzureCosmosClient(name: "mainDb");
builder.AddKeyedAzureCosmosClient(name: "loggingDb");

Ważny

W przypadku korzystania z usług opierających się na kluczach oczekuje się, że zasób Cosmos DB skonfigurował dwie nazwane bazy danych, jedną dla mainDb i drugą dla loggingDb.

Następnie można za pomocą wstrzykiwania zależności uzyskać wystąpienia CosmosClient. Aby na przykład pobrać połączenie z przykładowej usługi:

public class ExampleService(
    [FromKeyedServices("mainDb")] CosmosClient mainDbClient,
    [FromKeyedServices("loggingDb")] CosmosClient loggingDbClient)
{
    // Use clients...
}

Aby uzyskać więcej informacji na temat usług powiązanych z kluczami, zobacz .NET wstrzykiwanie zależności: usługi powiązane z kluczami.

Konfiguracja

Integracja .NET AspireAzure Cosmos DB udostępnia wiele opcji konfigurowania połączenia na podstawie wymagań i konwencji projektu.

Użyj łańcucha połączenia

W przypadku używania parametrów połączenia z sekcji konfiguracji ConnectionStrings podczas wywoływania metody AddAzureCosmosClient można podać nazwę parametrów połączenia:

builder.AddAzureCosmosClient("cosmos-db");

Następnie parametry połączenia są pobierane z sekcji konfiguracji ConnectionStrings:

{
  "ConnectionStrings": {
    "cosmos-db": "AccountEndpoint=https://{account_name}.documents.azure.com:443/;AccountKey={account_key};"
  }
}

Aby uzyskać więcej informacji na temat formatowania tych parametrów połączenia, zobacz dokumentację ConnectionString.

Korzystanie z dostawców konfiguracji

Integracja .NET AspireAzure Cosmos DB obsługuje Microsoft.Extensions.Configuration. Ładuje MicrosoftAzureCosmosSettings z konfiguracji, używając klucza Aspire:Microsoft:Azure:Cosmos. Poniższy fragment kodu to przykład pliku appsettings.json, który konfiguruje niektóre opcje:

{
  "Aspire": {
    "Microsoft": {
      "Azure": {
        "Cosmos": {
          "DisableTracing": false,
        }
      }
    }
  }
}

Aby uzyskać pełny schemat integracji klienta Cosmos DBJSON, zobacz Aspire.Microsoft.Azure.Cosmos/ConfigurationSchema.json.

Użyj delegatów liniowych

Możesz również przekazać delegata Action<MicrosoftAzureCosmosSettings> configureSettings, aby skonfigurować niektóre lub wszystkie opcje bezpośrednio w kodzie, na przykład w celu wyłączenia śledzenia:

builder.AddAzureCosmosClient(
    "cosmos-db",
    static settings => settings.DisableTracing = true);

Można również skonfigurować Microsoft.Azure.Cosmos.CosmosClientOptions przy użyciu opcjonalnego parametru Action<CosmosClientOptions> configureClientOptions metody AddAzureCosmosClient. Aby na przykład ustawić sufiks nagłówka CosmosClientOptions.ApplicationName user-agent dla wszystkich żądań wydawanych przez tego klienta:

builder.AddAzureCosmosClient(
    "cosmosConnectionName",
    configureClientOptions:
        clientOptions => clientOptions.ApplicationName = "myapp");

Client kontrole stanu integracji

Integracja klienta .NET AspireCosmos DB obecnie nie implementuje kontroli stanu zdrowia, ale może to ulec zmianie w przyszłych wersjach.

Obserwowanie i telemetria

.NET .NET Aspire integracje automatycznie konfigurują ustawienia rejestrowania, śledzenia i metryk, które są czasami nazywane filarami obserwowalności. Aby uzyskać więcej informacji na temat możliwości obserwacji integracji i telemetrii, zobacz omówienie integracji .NET.NET Aspire. W zależności od usługi pomocniczej niektóre integracje mogą obsługiwać tylko niektóre z tych funkcji. Na przykład niektóre integracje obsługują rejestrowanie i śledzenie, ale nie metryki. Funkcje telemetrii można również wyłączyć przy użyciu technik przedstawionych w sekcji konfiguracji .

Logowanie

Integracja .NET AspireAzure Cosmos DB używa następujących kategorii dzienników:

Azure-Cosmos-Operation-Request-Diagnostics

Poza uzyskaniem diagnostyki Azure Cosmos DB dla żądań zakończonych niepowodzeniem, można skonfigurować progi opóźnienia, aby określić, które diagnostyki dotyczące pomyślnych żądań Azure Cosmos DB zostaną zarejestrowane. Wartości domyślne to 100 ms dla operacji punktów i 500 ms dla operacji innych niż punkt.

builder.AddAzureCosmosClient(
    "cosmosConnectionName",
    configureClientOptions:
        clientOptions => {
            clientOptions.CosmosClientTelemetryOptions = new()
            {
                CosmosThresholdOptions = new()
                {
                    PointOperationLatencyThreshold = TimeSpan.FromMilliseconds(50),
                    NonPointOperationLatencyThreshold = TimeSpan.FromMilliseconds(300)
                }
            };
        });

Śledzenie

Integracja .NET AspireAzure Cosmos DB spowoduje emitowanie następujących działań śledzenia przy użyciu OpenTelemetry:

Azure.Cosmos.Operation

Azure Azure Cosmos DB śledzenie jest obecnie w wersji zapoznawczej, dlatego należy ustawić przełącznik eksperymentalny, aby upewnić się, że ślady są emitowane.

AppContext.SetSwitch("Azure.Experimental.EnableActivitySource", true);

Aby uzyskać więcej informacji, zobacz AzureAzure Cosmos DB obserwowalność SDK: atrybuty śledzenia.

Metryki

Integracja .NET AspireAzure Cosmos DB obecnie nie obsługuje metryk domyślnie z powodu ograniczeń SDK Azure.

Zobacz też

Azure Cosmos DB
.NET Aspire Cosmos DB Entity Framework Core integracja
Omówienie integracji .NET.NET Aspire
Omówienie integracji .NET AspireAzure
.NET Aspire GitHub repozytorium

Udostępnij za pośrednictwem