CosmosDiagnostics.ToString Método

Definição

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Pacote:

Microsoft.Azure.Cosmos v3.39.0

Origem:

CosmosDiagnostics.cs

Obtém a instância do campo CosmosDiagnostics de cadeia de caracteres no serviço de banco de dados do Azure Cosmos DB.

public abstract string ToString ();

override this.ToString : unit -> string

Public MustOverride Function ToString () As String

Retornos

String

A instância do campo CosmosDiagnostics de cadeia de caracteres no serviço de banco de dados do Azure Cosmos DB.

Exemplos

Não materialize ansiosamente o diagnóstico até o momento do consumo para evitar alocações desnecessárias, deixe o ToString ser chamado somente quando necessário. Você pode capturar diagnóstico condicionalmente, com base na latência ou nos erros:

try
{
    ItemResponse<Book> response = await container.CreateItemAsync<Book>(item: testItem);
    if (response.Diagnostics.GetClientElapsedTime() > ConfigurableSlowRequestTimeSpan)
    {
        // Log the diagnostics and add any additional info necessary to correlate to other logs 
        logger.LogInformation("Operation took longer than expected, Diagnostics: {Diagnostics}");
    }
}
catch (CosmosException cosmosException)
{
    // Log the full exception including the stack trace 
    logger.LogError(cosmosException);
    // The Diagnostics can be logged separately if required.
    logger.LogError("Cosmos DB call failed with {StatusCode}, {SubStatusCode}, Diagnostics: {Diagnostics}", cosmosException.StatusCode, cosmosException.SubStatusCode, cosmosException.Diagnostics);
}

Comentários

CosmosDiagnostics implementa a materialização lenta e só se materializa quando ToString() é chamado.