Az Azure Cosmos DB SDK megfigyelhetősége

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Az Azure Cosmos DB .NET és Java SDK-k támogatják az elosztott nyomkövetést az alkalmazások figyeléséhez. A kérések folyamatának nyomon követése hasznos a hibakeresésben, a késés és a teljesítmény elemzésében, valamint a diagnosztikák gyűjtésében. Eszközkövetés az alkalmazásokhoz az OpenTelemetria használatával, amely szállítósemleges, és szemantikai konvenciók készletével biztosítja a szabványosított adatformátumot a választott exportőrtől függetlenül, vagy az Application Insights SDK vagy az Azure Monitor OpenTelemetry Distro használatával.

Első lépések

Az elosztott nyomkövetés a következő SDK-kban érhető el:

Nyomkövetési attribútumok

Az Azure Cosmos DB-nyomkövetések az OpenTelemetry-adatbázis specifikációját követik, és számos egyéni attribútumot is biztosítanak. A kérés működésétől függően különböző attribútumokat láthat, és ezek az attribútumok az összes kérés alapvető attribútumai.

Diagnosztikák gyűjtése

Ha naplókat konfigurált a nyomkövetési szolgáltatóban, automatikusan lekérheti a sikertelen vagy nagy késésű Azure Cosmos DB-kérelmek diagnosztikáit . Ezek a naplók segítenek diagnosztizálni a sikertelen és lassú kérelmeket anélkül, hogy egyéni kódokat kellene rögzíteniük.

CosmosClientOptions options = new CosmosClientOptions()
{
    CosmosClientTelemetryOptions = new CosmosClientTelemetryOptions()
    {
        DisableDistributedTracing = false,
        CosmosThresholdOptions = new CosmosThresholdOptions()
        {
            PointOperationLatencyThreshold = TimeSpan.FromMilliseconds(100),
            NonPointOperationLatencyThreshold = TimeSpan.FromMilliseconds(500)
        }
    },
};

{ 
    "Logging": {​
        "LogLevel": {​
            "Azure-Cosmos-Operation-Request-Diagnostics": "Information"​
        }​
    }
}

    CosmosAsyncClient client = new CosmosClientBuilder()
            .endpoint("<Your account endpoint>")
            .key("<Your account key>")
            .clientTelemetryConfig(new CosmosClientTelemetryConfig()
                .diagnosticsThresholds(
                    new CosmosDiagnosticsThresholds()
                        .setPointOperationLatencyThreshold(Duration.ofMillis(100))
                        .setNonPointOperationLatencyThreshold(Duration.ofMillis(2000))
                        .setRequestChargeThreshold(100)))
            .buildAsyncClient();

OpenTelemetria konfigurálása

Az OpenTelemetria Azure Cosmos DB SDK-kkal való használatához adja hozzá a forrást a Azure.Cosmos.Operation nyomkövetési szolgáltatóhoz. Az OpenTelemetria számos olyan exportőrrel kompatibilis, amelyek betölthetik az adatokat. Az alábbi minta a Azure Monitor OpenTelemetry Exporter, de ön dönthet úgy, hogy konfigurálja a kívánt exportőrt. A választott exportőrtől függően előfordulhat, hogy az adatok betöltése akár néhány percig is eltarthat.

Ez a minta bemutatja, hogyan konfigurálhatja az OpenTelemetryt egy .NET-konzolalkalmazáshoz. Tekintse meg a teljes mintát a GitHubon.

ResourceBuilder resource = ResourceBuilder.CreateDefault().AddService(
            serviceName: serviceName,
            serviceVersion: "1.0.0");

// Set up logging to forward logs to chosen exporter
using ILoggerFactory loggerFactory
    = LoggerFactory.Create(builder => builder
                                        .AddConfiguration(configuration.GetSection("Logging"))
                                        .AddOpenTelemetry(options =>
                                        {
                                            options.IncludeFormattedMessage = true;
                                            options.SetResourceBuilder(resource);
                                            options.AddAzureMonitorLogExporter(o => o.ConnectionString = aiConnectionString); // Set up exporter of your choice
                                        }));
/*.AddFilter(level => level == LogLevel.Error) // Filter  is irrespective of event type or event name*/

AzureEventSourceLogForwarder logforwader = new AzureEventSourceLogForwarder(loggerFactory);
logforwader.Start();

// Configure OpenTelemetry trace provider
AppContext.SetSwitch("Azure.Experimental.EnableActivitySource", true);
_traceProvider = Sdk.CreateTracerProviderBuilder()
    .AddSource("Azure.Cosmos.Operation", // Cosmos DB source for operation level telemetry
               "Sample.Application") 
    .AddAzureMonitorTraceExporter(o => o.ConnectionString = aiConnectionString) // Set up exporter of your choice
    .AddHttpClientInstrumentation() // Added to capture HTTP telemetry
    .SetResourceBuilder(resource)
    .Build();

Az Application Insights SDK konfigurálása

Az Application Insights számos különböző módon konfigurálható attól függően, hogy az alkalmazás milyen nyelven van megírva, valamint a számítási környezettől függően. További információkért tekintse meg az Application Insights dokumentációját. Az adatok Application Insightsba való betöltése akár néhány percet is igénybe vehet.

Az alábbi minta bemutatja, hogyan konfigurálhatja az Application Insightst egy .NET-konzolalkalmazáshoz. Tekintse meg a teljes mintát a GitHubon.

IServiceCollection services = new ServiceCollection();
services.AddApplicationInsightsTelemetryWorkerService((ApplicationInsightsServiceOptions options) => options.ConnectionString = aiConnectionString);

IServiceProvider serviceProvider = services.BuildServiceProvider();
telemetryClient = serviceProvider.GetRequiredService<TelemetryClient>();

Miután a nyomkövetési adatokat betölti az Application Insightsba, vizualizálhatja őket az Azure Portalon, hogy megértse az alkalmazás kérési folyamatát. Íme egy példa egy partícióközi lekérdezésből származó nyomkövetési adatokra az Azure Portal bal oldali navigációs sávjának tranzakciókeresésében.

Következő lépések

• A .NET SDK használatának első lépései
• A Java SDK használatának első lépései
• Az Azure Cosmos DB monitorozása