Informationen zu „ClientDiagnosticLevel“ für Azure Managed Cache Service

  • Artikel

Hinweis

Anleitungen zum Auswählen des richtigen Azure Cache-Angebots für Ihre Anwendung finden Sie unter Welches Azure Cache-Angebot für mich geeignet ist?.

Managed Cache Service Clientanwendungen werden für die Diagnosedatensammlung mithilfe einer Diagnoseebene konfiguriert. Diese Diagnosestufe stellt eine Einstellung zum Konfigurieren der Stufe der Datenerfassung zur Verfügung. In diesem Thema finden Sie eine Übersicht über Schritte zur Problembehandlung und Diagnose für die Problembehandlung Managed Cache Service Anwendungen.

Wichtig

In der version Managed Cache Service gelten die in diesem Thema beschriebenen Clientschritte für ClientDiagnosticLevel und verwandte Clientschritte nur für rollenbasierte Clouddienstcacheclients.

Problembehandlung und Diagnose für Managed Cache Service Anwendungen

Anwendungen, die auf Azure ausgeführt werden, sind weit verteilt, Multiinstanzenanwendungen, die schwierig zu debuggen sein können. Diese Anwendungstypen erfordern weit mehr als Standardtandardtools und -konzepte für die Problembehandlung. Die Problembehandlung bei Azure-Anwendungen liegt über den Umfang dieses Themas hinaus, aber weitere Informationen sind in Diagnose und Debugging in Azure verfügbar.

Das Konfigurieren von Managed Cache Service Anwendungen zum Sammeln von Diagnosedaten für die Problembehandlung erfordert das Konfigurieren der Diagnoseebene und das Konfigurieren der Cachediagnose während des Rollenstarts. In diesem Thema finden Sie eine Übersicht über diese Schritte für Managed Cache Service Anwendungen.

  • Konfigurieren der Clientdiagnosestufe

  • Konfigurieren der Cachediagnose während des Rollenstarts

  • Leistungsindikatoren nach Diagnosestufe

Konfigurieren der Clientdiagnosestufe

Managed Cache Service stellt fünf Clientdiagnoseebenen bereit, die zum Konfigurieren der Menge der Diagnosedatensammlung verwendet werden. Die Diagnosestufen reichen von 0 bis 4. Der Wert zeigt die Menge an Diagnoseinformationen an, die für Cacheserver und -clients erfasst werden. Jede Diagnoseebene enthält einen vordefinierten Satz von Leistungsindikatoren, Ereignisprotokollen, Ablaufverfolgungs- und Absturzabbildeinstellungen, die zum Überwachen der Integrität Ihrer Managed Cache Service Anwendung verwendet werden können.

Clientdiagnosestufe Erfasste Diagnosedaten

0

Nur sehr wichtige/schwer wiegende Protokolle.

1

Diagnosedaten, die die Bewertung der Verwendungsmuster, der Integrität des Cachesystems und potenzieller Fehlern unterstützen. Dies ist die Standardkonfigurationsstufe.

2

Diagnosedaten mit hoher Granularität für alle Anforderungen und wichtigen Systeminformationen.

3

Diagnosedaten mit größerer Ausführlichkeit und Systeminformationen.

4

Protokolle mit größtmöglicher Ausführlichkeit für alle Anforderungen und Systeminformationen.

Es gibt zwei Arten von Zwischenspeicherdiagnoseebenen, die der Cacheclient- und Cacheserverdiagnose entsprechen. DiagnosticLevel stellt die Cacheserverdiagnose dar, und ClientDiagnosticLevel stellt die Cacheclientdiagnose dar. Jede Stufe konfiguriert eine andere Sammlung von Leistungsindikatoren, Protokollen, Ablaufverfolgungen und Absturzabbildeinstellungen. Diese Diagnosestufen werden in der Datei ServiceConfiguration.cscfg für die Anwendung konfiguriert und können für eine ausgeführte Cloud-Anwendung einfach durch Bereitstellen einer aktualisierten Datei ServiceConfiguration.cscfg geändert werden.

Die ClientDiagnosticLevel-Ebene für einen Cacheclient wird im Konfigurationsabschnitt für die Rolle, die der Cacheclient ist, im Konfigurationsabschnitt "ServiceConfiguration.cscfg" angegeben. Diese Einstellung wird vom Managed Cache Service NuGet Paket hinzugefügt, wenn die Rolle so konfiguriert ist, dass sie als Cacheclient fungiert.

Hinweis

Weitere Informationen zum Konfigurieren von Cacheclients mithilfe des Managed Cache Service NuGet-Pakets finden Sie unter How to: Configure a Cache Client for Azure Managed Cache Service.

Der StandardclientDiagnosticLevel ist 1, und wenn kein ClientDiagnosticLevel für die Rolle vorhanden ist, wird ein ClientDiagnosticLevel von 1 verwendet. Um den ClientDiagnosticLevel zu ändern, ändern Sie die ClientDiagnosticLevel-Einstellung für die Rolle in ServiceConfiguration.cscfg. Das folgende Beispiel ist der WebRole1 Abschnitt aus einer ServiceConfiguration.cscfg-Datei mit einem ClientDiagnosticLevel von 1.

<Role name="WebRole1">
  <Instances count="1" />
  <ConfigurationSettings>
    <!-- Other settings omitted for clarity... -->
    <Setting name="Microsoft.WindowsAzure.Plugins.Caching.ClientDiagnosticLevel" value="1" />
  </ConfigurationSettings>
</Role>

Die folgende Tabelle führt die Diagnosedaten auf, die für jede der Clientdiagnosestufen erfasst werden.

Hinweis

Absturzabbildeinstellungen für die Clientdiagnosestufen sind nur für Cacheclients relevant, die den Memcache-Clientshim verwenden. Absturzabbilder werden nicht für Nicht-Memcache-Clients gesammelt. Weitere Informationen zum Memcache-Client shim finden Sie unter Ausführen Ihrer Memcache-App mit Azure Managed Cache Service.

ClientDiagnosticLevel Gesammelte Daten

0
  • Protokollebene: Kritisch

  • Keine Leistungsindikatoren

  • Keine Ereignisprotokolle registriert

  • Miniabsturzabbilder

1

2

3

4

Hinweis

Beim Ausführen Managed Cache Service Clientanwendungen im Azure-Emulator werden die Ablaufverfolgungen für alle Rolleninstanzen unter dem Ordner *_IN_0 erfasst, auch wenn mehrere Rolleninstanzen vorhanden sind. Dieses Verhalten ist beabsichtigt. Wenn Managed Cache Service Anwendungen in Azure gehostet werden, befinden sich die Ablaufverfolgungen für jede Clientrolleninstanz in den jeweiligen Ordnern für die Rolleninstanzen.

Konfigurieren der Cachediagnose während des Rollenstarts

Damit die Erfassung der Caching-Diagnosedaten gestartet wird, muss der folgende Code während des Rollenstarts aufgerufen werden. Dieser Code muss jeder Rolle hinzugefügt werden, die einen Cacheclient oder Cacheserver darstellt, damit Caching-Diagnosedaten erfasst werden. Ein praktischer Ort zum Hosten dieses Codes befindet sich in der OnStart-Außerkraftsetzung der Rolle, wie im folgenden Beispiel gezeigt.

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

Public Overrides Function OnStart() As Boolean

    ' Existing OnStart override code omitted for clarity.

    Dim dmConfig As DiagnosticMonitorConfiguration = _
        DiagnosticMonitor.GetDefaultInitialConfiguration()

    ' Configure the collection of cache diagnostic data.
    CacheDiagnostics.ConfigureDiagnostics(dmConfig)

    DiagnosticMonitor.Start("Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString", _
        dmConfig)

    Return MyBase.OnStart()

End Function

Die O:Microsoft.ApplicationServer.Caching.AzureCommon.CacheDiagnostics.ConfigureDiagnostics-Methode konfiguriert die Sammlung von Zwischenspeicherungsdiagnosedaten. Wenn diese Methode nicht aufgerufen wird, werden keine Caching-Diagnosedaten erfasst. Um die CacheDiagnostics-Klasse zu verwenden, fügen Sie einen Verweis auf Microsoft.ApplicationServer.Caching.AzureCommon.dll in C:\Program Files\Microsoft SDKs\Azure\.NET SDK\[Current SDK Version]\ref\Caching hinzu, und fügen Sie die folgende Anweisung mit (oder Imports) hinzu.

using Microsoft.ApplicationServer.Caching.AzureCommon;

Imports Microsoft.ApplicationServer.Caching.AzureCommon

Hinweis

Wenn die Rolle als Cacheclient mithilfe des Managed Cache Service NuGet-Pakets konfiguriert wurde, wird der Microsoft.ApplicationServer.Caching.AzureCommon.dll Assemblyverweis bereits hinzugefügt.

Wenn Sie einen vorhandenen Rollen- und Diagnosekonfigurationscode zwischenspeichern, können Sie den Aufruf von O:Microsoft.ApplicationServer.Caching.AzureCommon.CacheDiagnostics.ConfigureDiagnostics dem vorhandenen Diagnosestartcode hinzufügen, bevor der Aufruf von O:Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitor.Start erfolgt.

Warnung

Das Aufrufen von O:Microsoft.ApplicationServer.Caching.AzureCommon.CacheDiagnostics.ConfigureDiagnostics und O:Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitor.Start ist für die Diagnosedatensammlung in Managed Cache Service Anwendungen erforderlich. Wenn diese Methoden nicht beide während des Rollenstarts aufgerufen wird, werden keine Caching-Diagnosedaten erfasst.

Leistungsindikatoren nach Diagnosestufe

Die folgenden Abschnitte enthalten Listen der Leistungsindikatoren, die in jeder der Server- und Clientdiagnosestufen enthalten sind. Sowohl Managed Cache Service als auch Leistungsindikatoren sind enthalten. Eine vollständige Liste mit Beschreibungen der Managed Cache Service Leistungsindikatoren finden Sie unter Überwachen von Azure Managed Cache Service. Weitere Informationen zu den Leistungsindikatoren finden Sie unter Leistungsindikatoren im .NET Framework.

  • Leistungsindikatoren der Clientdiagnosestufe 1

  • Leistungsindikatoren der Clientdiagnosestufe 2, 3 und 4

Leistungsindikatoren der Clientdiagnosestufe 1

ClientDiagnosticLevel 1 enthält die folgenden Leistungsindikatoren.

  • \Azure Caching:Clienthost\Fehlerausnahmen

  • \Azure Caching:Clienthost\Lokale Cachetreffer gesamt

  • \Azure Caching:Clienthost\Aktuelle Serververbindungen

  • \Azure Caching:Clienthost\Mittlere Get-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Clienthost\Mittlere Put-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Clienthost\Wiederholungsversuchausnahmen

  • \Azure Caching:Clienthost\Timeoutausnahmen

  • \Azure Caching:Clienthost\Anforderungen

  • \Prozessor(_Gesamt)\% Prozessorzeit

  • \.NET CLR-Speicher(_Global_)\% Zeit im GC

  • \Azure Caching:Client(*)\Fehlerausnahmen

  • \Azure Caching:Client(*)\Lokale Cachetreffer gesamt

  • \Azure Caching:Client(*)\Aktuelle Serververbindungen

  • \Azure Caching:Client(*)\Mittlere Get-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Client(*)\Mittlere Put-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Client(*)\Wiederholungsversuchausnahmen

  • \Azure Caching:Client(*)\Timeoutausnahmen

  • \Azure Caching:Client(*)\Anforderungen

Leistungsindikatoren der Clientdiagnosestufe 2, 3 und 4

Die ClientDiagnosticLevel 2, 3 und 4 enthalten die folgenden Leistungsindikatoren.

  • \Azure Caching:Clienthost\Anforderungen

  • \Azure Caching:Clienthost\Anforderungen/Sek.

  • \Azure Caching:Clienthost\Abgelegte Serverantworten/Sek.

  • \Azure Caching:Clienthost\Fehlerausnahmen

  • \Azure Caching:Clienthost\Fehlerausnahmen/Sek.

  • \Azure Caching:Clienthost\Mittlere Get-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Clienthost\Mittlere Put-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Clienthost\Mittlere Get-Latenz (Netzwerk)/Vorgang in Mikrosekunden

  • \Azure Caching:Clienthost\Leseanforderungen

  • \Azure Caching:Clienthost\Schreibanforderungen

  • \Azure Caching:Clienthost\Empfangene Bytes/Sek.

  • \Azure Caching:Clienthost\Gesendete Bytes/Sek.

  • \Azure Caching:Clienthost\Aktuelle Serververbindungen

  • \Azure Caching:Clienthost\Prozentsatz lokale Cachespeicherung

  • \Azure Caching:Clienthost\Prozentsatz lokale Cachetreffer

  • \Azure Caching:Clienthost\Lokale Cachetreffer gesamt

  • \Azure Caching:Clienthost\Lokale Cacheobjekte gesamt

  • \Azure Caching:Clienthost\Empfangene Benachrichtigungen gesamt

  • \Azure Caching:Clienthost\Timeoutausnahmen

  • \Azure Caching:Clienthost\Timeoutausnahmen/Sek.

  • \Azure Caching:Clienthost\Wiederholungsversuchausnahmen

  • \Azure Caching:Clienthost\Wiederholungsversuchausnahmen/Sek.

  • \Azure Caching:Clienthost\Fehler Verbindungsanforderungen gesamt

  • \Azure Caching:Clienthost\Netzwerkausnahmen

  • \Azure Caching:Clienthost\Netzwerkausnahmen/Sek.

  • \Azure Caching:Clienthost\Aktuell wartende Anforderungen

  • \Prozessor(_Gesamt)\% Prozessorzeit

  • \.NET CLR-Speicher(_Global_)\% Zeit im GC

  • \Azure Caching:Client(*)\Anforderungen

  • \Azure Caching:Client(*)\Anforderungen/Sek.

  • \Azure Caching:Client(*)\Abgelegte Serverantworten/Sek.

  • \Azure Caching:Client(*)\Fehlerausnahmen

  • \Azure Caching:Client(*)\Fehlerausnahmen/Sek.

  • \Azure Caching:Client(*)\Mittlere Get-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Client(*)\Mittlere Put-Latenz/Vorgang in Mikrosekunden

  • \Azure Caching:Client(*)\Mittlere Get-Latenz (Netzwerk)/Vorgang in Mikrosekunden

  • \Azure Caching:Client(*)\Leseanforderungen

  • \Azure Caching:Client(*)\Schreibanforderungen

  • \Azure Caching:Client(*)\Empfangene Bytes/Sek.

  • \Azure Caching:Client(*)\Gesendete Bytes/Sek.

  • \Azure Caching:Client(*)\Aktuelle Serververbindungen

  • \Azure Caching:Client(*)\Prozentsatz lokale Cachespeicherung

  • \Azure Caching:Client(*)\Prozentsatz lokale Cachetreffer

  • \Azure Caching:Client(*)\Lokale Cachetreffer gesamt

  • \Azure Caching:Client(*)\Lokale Cacheobjekte gesamt

  • \Azure Caching:Client(*)\Empfangene Benachrichtigungen gesamt

  • \Azure Caching:Client(*)\Timeoutausnahmen

  • \Azure Caching:Client(*)\Timeoutausnahmen/Sek.

  • \Azure Caching:Client(*)\Wiederholungsversuchausnahmen

  • \Azure Caching:Client(*)\Wiederholungsversuchausnahmen/Sek.

  • \Azure Caching:Client(*)\Fehler Verbindungsanforderungen gesamt

  • \Azure Caching:Client(*)\Netzwerkausnahmen

  • \Azure Caching:Client(*)\Netzwerkausnahmen/Sek.

  • \Azure Caching:Client(*)\Aktuell wartende Anforderungen

Weitere Informationen

Verweis

Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitor

Konzepte

Überwachen von Azure Managed Cache Service

Weitere Ressourcen

Leistungsindikatoren in .NET Framework
Diagnose und Debugging in Azure