CosmosDiagnostics.ToString メソッド

定義

名前空間:

Microsoft.Azure.Cosmos

アセンブリ:

Microsoft.Azure.Cosmos.Client.dll

パッケージ:

Microsoft.Azure.Cosmos v3.39.0

ソース:

CosmosDiagnostics.cs

Azure Cosmos DB データベース サービスの文字列フィールド インスタンスを取得します CosmosDiagnostics 。

public abstract string ToString ();

override this.ToString : unit -> string

Public MustOverride Function ToString () As String

戻り値

String

Azure Cosmos DB データベース サービスの文字列フィールド CosmosDiagnostics インスタンス。

例

不要な割り当てを回避するために、消費の瞬間まで診断を熱心に具体化しないでください。必要な場合にのみ ToString を呼び出します。 待機時間またはエラーに基づいて、条件付きで診断をキャプチャできます。

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);
}

注釈

CosmosDiagnostics は遅延具体化を実装し、 が呼び出された場合 ToString() にのみ具体化されます。