Konfigurationseinstellungen des Cacheclients für Azure Managed Cache Service

  • Artikel

Wichtig

Microsoft empfiehlt, alle neuen Entwicklungen azure Redis Cache zu verwenden. Aktuelle Dokumentation und Anleitung zum Auswählen eines Azure Cache-Angebots finden Sie unter Welches Azure Cache-Angebot ist für mich geeignet?

In diesem Thema werden die Anforderungen für die Unterstützung von Managed Cache Service in einer .NET Framework web.config- oder app.config Konfigurationsdatei beschrieben. Außerdem werden die verfügbaren Konfigurationsoptionen für Cacheclients beschrieben.

Tipp

Wenn Sie das NuGet-Paket für Managed Cache Service verwenden, ändert das Paket automatisch die Konfigurationsdatei. Sie können dieses Thema jedoch verwenden, um die Cacheclienteinstellungen, die NuGet eingefügt werden, weiter anzupassen. Weitere Informationen zum Cache-NuGet-Paket finden Sie unter Konfigurieren eines Cacheclients mithilfe des Cache-NuGet Pakets.

Die folgenden Abschnitte werden in diesem Thema behandelt.

  • <configSections>

    • <dataCacheClients>

      • <dataCacheClient>

        • <Autoermittlung>

        • <localCache>

        • <clientNotification>

        • <serializationProperties>

        • <securityProperties>

      • <cacheDiagnostics>

        • <crashDump>

Cacheclient-Konfigurationsbeispiel

Das folgende Beispiel zeigt die Abschnitte einer web.config- oder app.config-Datei, die für Managed Cache Service relevant sind. In diesem Beispiel greift der default-Cacheclient auf den Cache zu, der unter mycache.cache.windows.net gehostet wird, und der lokale Cache ist aktiviert.

<configuration>
  <configSections>
    <section name="dataCacheClients"
             type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, 
                   Microsoft.ApplicationServer.Caching.Core" 
             allowLocation="true" 
             allowDefinition="Everywhere" />
    
    <section name="cacheDiagnostics" 
             type="Microsoft.ApplicationServer.Caching.AzureCommon.DiagnosticsConfigurationSection, 
                   Microsoft.ApplicationServer.Caching.AzureCommon" 
             allowLocation="true" 
             allowDefinition="Everywhere" />
  </configSections>
  <dataCacheClients>
    <dataCacheClient name="default">
      <!--To use the in-role flavor of Azure Caching, 
          set identifier to be the cache cluster role name -->
      <!--To use the Azure Caching Service, 
          set identifier to be the endpoint of the cache cluster -->
      <autoDiscover isEnabled="true" identifier="mycache.cache.windows.net" />
      <localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />
      <!--Use this section to specify security settings for connecting to your cache. 
          This section is not required if your cache is hosted on a role that is a part 
          of your cloud service. -->
      <securityProperties mode="Message" sslEnabled="false">
        <messageSecurity authorizationInfo="MyAuthorizationKey" />
      </securityProperties>
    </dataCacheClient>
  </dataCacheClients>
    <cacheDiagnostics>
    <crashDump dumpLevel="Off" dumpStorageQuotaInMB="100" />
  </cacheDiagnostics>
</configuration>

configSections

Die folgenden beiden benannten Abschnittselemente sollten der Liste der Abschnitte im configSections-Element hinzugefügt werden.

Name BESCHREIBUNG

dataCacheClients

Definiert das dataCacheClients-Element der Konfigurationsdatei. Dieser Abschnitt gibt die Einstellungen für alle Cacheclientkonfigurationen an.

cacheDiagnostics

Definiert das cacheDiagnostics-Element der Konfigurationsdatei. In diesem Abschnitt werden Diagnosen konfiguriert, die für Managed Cache Service spezifisch sind.

Im folgenden Beispiel wird gezeigt, wie diese Abschnitte definiert werden.

<section name="dataCacheClients"
          type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, 
                Microsoft.ApplicationServer.Caching.Core" 
          allowLocation="true" 
          allowDefinition="Everywhere" />
    
<section name="cacheDiagnostics" 
          type="Microsoft.ApplicationServer.Caching.AzureCommon.DiagnosticsConfigurationSection, 
                Microsoft.ApplicationServer.Caching.AzureCommon" 
          allowLocation="true" 
          allowDefinition="Everywhere" />

dataCacheClients

Jedes dataCacheClients-Element enthält ein oder mehrere benannte DataCacheClient-Elemente . Das dataCacheClients-Element verfügt nicht über Attribute. Durch die Möglichkeit, mehrere Cacheclient-Konfigurationsabschnitte zu verwenden, können Anwendungen verschiedene Einstellungen mit verschiedenen Arten von zwischengespeicherten Daten verwenden.

dataCacheClient

Jedes dataCacheClients-Element enthält ein oder mehrere benannte DataCacheClient-Elemente . Der Anwendungscode lädt die Einstellungen für einen Cacheclient, indem er auf den Namen des zugehörigen DataCacheClient-Abschnitts verweist.

Das dataCacheClients-Element verfügt nicht über Attribute. Die untergeordneten DataCacheClient-Elemente weisen jedoch mehrere verfügbare Attribute auf. Eine Beschreibung dieser Attribute finden Sie in der folgenden Tabelle.

attribute BESCHREIBUNG

Name

Der Name der Cacheclientkonfiguration.

isCompressionEnabled

Aktiviert oder deaktiviert Komprimierung. Zulässige Werte: true oder false. Der Standardwert ist false (deaktiviert).

useConnectionPool

Aktiviert oder deaktiviert den Verbindungspool. Mögliche Werte sind true und false. Der Standardwert ist true (aktiviert).

maxConnectionsToServer

Wenn useConnectionPool auf festgelegt trueist, gibt dieses Attribut die Anzahl der Verbindungen im Verbindungspool für diese Cacheclientkonfiguration an. Wenn useConnectionPool auf falsefestgelegt ist, gibt dieses Attribut die Anzahl der Verbindungen an, die für jedes DataCacheFactory-Objekt im Code verwendet werden sollen.

In den folgenden Abschnitten werden die verfügbaren untergeordneten Elemente in jedem dataCacheClient-Element beschrieben.

autoDiscover

Das AutoDiscover-Element unterstützt Cacheclients bei der automatischen Verbindung mit einem Zielcache.

In der folgenden Tabelle werden die verfügbaren Attribute für das AutoDiscover-Element beschrieben.

attribute BESCHREIBUNG

isEnabled

Legen Sie die lokale automatische Verbindung mit true der Rolle fest, die Managed Cache Service hostet, um die lokale automatische Verbindung zu aktivieren oder false zu deaktivieren.

identifier

Für Managed Cache Service ist er der Name des Cacheendpunkts.

Für In-Role Cache ist es der Name der Rolle in derselben Clouddienstbereitstellung, die In-Role Cache hosten.

 
<autoDiscover isEnabled="true" identifier="mycache.cache.windows.net" />

localCache

Das localCache-Element steuert die Verwendung des lokalen Caches. Standardmäßig ist der lokale Cache nicht aktiviert. Wenn er aktiviert ist, werden aus dem Cache abgerufene Elemente lokal im Arbeitsspeicher auf dem Clientcomputer gespeichert. Auf diese Weise wird die Leistung nachfolgender Get-Anforderungen verbessert. Das Ergebnis kann jedoch eine Inkonsistenz der Daten zwischen der lokal zwischengespeicherten Version und dem tatsächlichen Element im Cache sein. Weitere Informationen finden Sie unter "Lokaler Cache für Azure Managed Cache Service".

In der folgenden Tabelle werden die verfügbaren Attribute für das localCache-Element beschrieben.

attribute BESCHREIBUNG

isEnabled

Wird auf true oder false festgelegt, um den lokalen Cache zu aktivieren bzw. zu deaktivieren.

sync

Legt fest, wie der lokale Cache invalidiert wird. Mögliche Werte sind TimeoutBased und NotificationBased.

objectCount

Die maximale Anzahl von Objekten, die im lokalen Cache gespeichert werden können. Standard: 10000

ttlValue

Die maximale Anzahl von Sekunden, die Objekte im lokalen Cache verbleiben. Der Standardwert ist 300 Sekunden.

Hinweis

Benachrichtigungen werden in den Standard- und Premium-Cacheangeboten unterstützt, und benannte Caches in diesen Angeboten müssen so konfiguriert sein, dass Benachrichtigungen aktiviert sind. Weitere Informationen finden Sie unter Benachrichtigungen für Azure Managed Cache Service.

<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />

clientNotification

In der folgenden Tabelle werden die verfügbaren Attribute für das clientNotification-Element beschrieben. Dieses Element steuert das Benachrichtigungsverhalten für den Cacheclient.

attribute BESCHREIBUNG

pollInterval

Die Anzahl von Sekunden zwischen den Abrufversuchen. Der Abrufvorgang wird verwendet, um das Vorhandensein von Benachrichtigungen für den Cache zu überprüfen. Der Standardwert beträgt 300 Sekunden.

maxQueueLength

Die maximale Anzahl von Benachrichtigungen, die zwischen Abrufversuchen für diesen Cacheclient in Warteschlangen gespeichert werden. Der Standardwert beträgt 10000 Benachrichtigungen.

 
<clientNotification pollInterval="60" maxQueueLength="10000"/>

serializationProperties

In der folgenden Tabelle werden die verfügbaren Attribute für das SerializationProperties-Element beschrieben. Dieses Element unterstützt die Wahl zwischen integrierter und benutzerdefinierter Serialisierung für zwischengespeicherte Elemente. Weitere Informationen finden Sie unter Serialisierung für Azure Managed Cache Service.

attribute BESCHREIBUNG

serializer

Bestimmt den Serialisierungstyp für zwischengespeicherte Elemente. Mögliche Werte sind NetDataContractSerializer, BinaryFormatter und CustomSerializer. Der Standardwert lautet NetDataContractSerializer.

securityProperties

In der folgenden Tabelle werden die verfügbaren Attribute für das SecurityProperties-Element beschrieben.

attribute BESCHREIBUNG

mode

Mögliche Werte sind None, Transport und Message. Wird nur Message mit Managed Cache Service unterstützt. Die anderen beiden Einstellungen beziehen sich auf Microsoft AppFabric 1.1 für Windows Server.

sslEnabled

Mögliche Werte sind true und false. Diese Einstellung wird zum Ermitteln verwendet, ob die Kommunikation zwischen dem Cache und Cacheclients verschlüsselt ist. Die Standardeinstellung ist false. Weitere Informationen finden Sie unter Sichern der Kommunikation zwischen Cacheclients und dem Cache.

Das SecurityProperties-Element verfügt über ein untergeordnetes Element, messageSecurity. In der folgenden Tabelle werden die verfügbaren Attribute für das MessageSecurity-Element beschrieben.

attribute BESCHREIBUNG

authorizationInfo

Der Zugriffsschlüssel für den Cache, der aus dem Cachedashboard im abgerufen werden kann. Wenn dieser nicht ordnungsgemäß konfiguriert ist, ist der Cacheclient nicht in der Lage, die Kommunikation mit dem Cache herzustellen.

 
<securityProperties mode="Message" sslEnabled="false">
  <messageSecurity authorizationInfo="iz8zOmJ0dJBzzzzxa8JxdGJkb281bzxudGF0az9udGxzdGluZi111z8oZS5Ji28lP38jb250Pm9sLmludDMud2luZG93Pi1pb8Qubmx0L1dSQxB2MP45LiZxd25lPii0eDJJZQA5SlZQQUQ2xzIizk8iazlES1P08X8zOFIxZjdzZxp0i3lFQ2FFPSZodJRzOi8xS8JxdGJEb281bzxudGF0az9uxGxzdGluZi5jiz8oZS5pb8QzL8dpbmRxd3MQaz50Lm5ldA==" />
</securityProperties>

cacheDiagnostics

In diesem Abschnitt werden einige der Diagnoseeinstellungen für Managed Cache Service konfiguriert.

Warnung

In der version Managed Cache Service gelten die in diesem Thema beschriebenen cacheDiagnostics und verwandten Abschnitte nur für rollenbasierte Clouddienstcacheclients. Wenn Ihr Cacheclient kein Cloud Service ist, werden diese Abschnitte dem NuGet-Paket Cache nicht hinzugefügt. Weitere Informationen finden Sie unter "ClientDiagnosticLevel für Azure Managed Cache Service".

In den folgenden Abschnitten werden die verfügbaren untergeordneten Elemente in jedem cacheDiagnostics-Element beschrieben.

crashDump

Das crashDump-Element steuert den Typ der Absturzabbilder, die für diese Anwendung gesammelt werden. Managed Cache Service Absturzabbilder sind hauptsächlich für die Diagnose von Problemen mit Cachecomputern ausgelegt. Aus diesem Grund sollten Clientkonfigurationsdateien die Generierung von Absturzabbildern deaktivieren. Dies kann durch Festlegen des DumpLevel-AttributsOffauf .

Wenn Absturzabbilder aktiviert sind, sollten der lokale Cachespeicher und der Diagnosespeicher in ServiceDefinition.csdef so angepasst werden, dass die Größe immer die Summe des Absturzspeicherkontingents und des Protokollspeicherkontingents übersteigt, die in CacheSettings.xml konfiguriert ist (die Standardwerte sind 1.000 MB).

In der folgenden Tabelle werden die verfügbaren Attribute für das CrashDump-Element beschrieben.

attribute BESCHREIBUNG

dumpLevel

Mögliche Werte sind Off, Mini und Full.

dumpStorageQuotaInMB

Der obere Grenzwert für die Größe des Absturzabbilds.

scheduledTransferPeriodInMinutes

Die Anzahl der Minuten zwischen Übertragungen der Absturzabbilder an den Diagnosespeicher.

 
<crashDump dumpLevel="Off" dumpStorageQuotaInMB="100" scheduledTransferPeriodInMinutes="5" />