Share via


Windows Azure In-Role Cache: Diagnostics Data Collection

 

If you are running into any issues with In-Role (Role-based) Windows Azure Cache, you can have the diagnostic data ready before you contact Windows Azure Support at Microsoft for help.

 

Here's the relevant MSDN document that describes how to enable client-side and server-side cache logging.

In-Role Cache Troubleshooting and Diagnostics

https://msdn.microsoft.com/en-us/library/windowsazure/hh914135.aspx

 

The table below shows the required configuration settings and startup code; to have the cache diagnostics enabled and transferred to the storage account.

 

 

Setting

Server/Client Role

Cscfg setting

Server: Microsoft.WindowsAzure.Plugins.Caching.DiagnosticLevel; value=1/2/3/ 4

 

Client:

Microsoft.WindowsAzure.Plugins.Caching.ClientDiagnosticLevel; value=1/2/3/ 4

 

Role start-up code

to transfer

Logs to storage

 

public override bool OnStart()

{

    DiagnosticMonitorConfiguration dmConfig = 

        DiagnosticMonitor.GetDefaultInitialConfiguration();

 

    // Configure the collection of cache diagnostic data.

    CacheDiagnostics.ConfigureDiagnostics(dmConfig);

 

    DiagnosticMonitor.Start("Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString", 

        dmConfig);

 

    return base.OnStart();

}

 

 

 

Once the diagnostics are enabled and issue has been reproduced, please download the tool from the link below that would help you collect the cache logs from the configured storage account.

Windows Azure In-Role Cache WAD Logs

 

Here's the KB that will help you with step by step instructions for the tool.

https://support.microsoft.com/kb/2937691

 

Information collected by the tool:

 

Location of cache diagnostic data in WAD storage

Log Type

Storage Type

Container/Table Name

ETW traces

Blob

wad-custom-logs

Performance Counters

Table

WADPerformanceCountersTable

Windows Event Logs

Table

WADWindowsEventLogsTable

Crash Dumps

Blob

wad-crash-dumps

Client Logs

Table

WADLogsTable

 

Diagnostic files collected in the package for Azure In-role cache

Description

File name

.zip file for all client trace files for In-role cache

accountName_ClientTraces.zip

.zip file for all crash dumps files for In-role cache

accountName_CrashDumps.zip

.zip file for all event log files for In-role cache

accountName_EventLogs.zip

.zip file for all PerfMon logs for In-role cache

accountName_PerfMonLogs.zip

.zip file for all Server logs for In-role cache

accountName_ServerLogs.zip

 

More Information: