Impostazioni di configurazione del client di Cache nel ruolo (Web.config)

Questo argomento descrive i requisiti per supportare In-Role Cache in un web.config di .NET Framework o app.config file di configurazione. Illustra inoltre le opzioni di configurazione disponibili per i client della cache. Le impostazioni descritte in questo argomento sono necessarie solo dai client della cache; non sono necessari per i ruoli che ospitano In-Role Cache.

Questo argomento descrive le seguenti sezioni.

• <configSections>

• <dataCacheClients>

  • <dataCacheClient>

    • <Autodiscover>

    • <localCache>

    • <clientNotification>

    • <serializationProperties>

• <cacheDiagnostics>

  • <crashDump>

Esempio di configurazione del client della cache

Nell'esempio seguente vengono illustrate le sezioni di un file web.config o app.config rilevanti per In-Role Cache. In questo esempio il client della cache default accede alle cache ospitate dal ruolo CacheWorkerRole1 e la cache locale è abilitata.

<?xml version="1.0" encoding="utf-8"?>
<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">
      <autoDiscover isEnabled="true" identifier="CacheWorkerRole1" />
      <localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />
    </dataCacheClient>
  </dataCacheClients>
  <cacheDiagnostics>
    <crashDump dumpLevel="Off" dumpStorageQuotaInMB="100" />
  </cacheDiagnostics>
</configuration>

configSections

I due elementi di sezione denominati seguenti devono essere aggiunti all'elenco delle sezioni nell'elemento configSections .

Il seguente esempio illustra come definire queste sezioni.

    <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

Ogni elemento dataCacheClients contiene uno o più elementi dataCacheClient denominati. L'elemento dataCacheClients non ha attributi. La presenza di più sezioni di configurazione del client della cache consente alle applicazioni di usare diverse impostazioni con tipi diversi di dati memorizzati nella cache.

dataCacheClient

Ogni elemento dataCacheClients contiene uno o più elementi dataCacheClient denominati. Il codice applicazione carica le impostazioni per un client della cache facendo riferimento al nome della sezione dataCacheClient associata.

L'elemento dataCacheClients non ha attributi. Tuttavia, gli elementi dataCacheClient figlio hanno diversi attributi disponibili. descritti nella seguente tabella.

Le sezioni seguenti descrivono gli elementi figlio disponibili all'interno di ogni elemento dataCacheClient .

autoDiscover

L'elemento autoDiscover aiuta i client della cache a connettersi automaticamente a un cluster della cache di destinazione. È necessario che questo cluster di cache sia ospitato da un ruolo che fa parte della stessa distribuzione del servizio cloud.

Nella tabella seguente vengono descritti gli attributi disponibili per l'elemento autoDiscover .

<autoDiscover isEnabled="true" identifier="CacheWorkerRole1" />

localCache

L'elemento localCache controlla l'uso della cache locale. Per impostazione predefinita, la cache locale non è abilitata. Se è abilitata, gli elementi recuperati dal cluster di cache vengono archiviati localmente nella memoria del computer client. Questo consente di migliorare le prestazioni delle successive richieste get, ma è possibile che si verifichi un'incoerenza tra i dati della versione memorizzata nella cache locale e quelli dell'elemento effettivo nel cluster di cache. Per altre informazioni, vedere Cache locale in Cache In-Role di Azure.

Nella tabella seguente vengono descritti gli attributi disponibili per l'elemento localCache .

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

clientNotification

Nella tabella seguente vengono descritti gli attributi disponibili per l'elemento clientNotification . Questo elemento è responsabile del controllo del comportamento delle notifiche per il client della cache.

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

serializationProperties

Nella tabella seguente vengono descritti gli attributi disponibili per l'elemento serializationProperties . Questo elemento consente di scegliere tra una serializzazione predefinita o personalizzata per gli elementi memorizzati nella cache. Per altre informazioni, vedere Serializzazione in Cache In-Role di Azure.

cacheDiagnostics

Questa sezione configura alcune impostazioni di diagnostica per In-Role Cache. Per altre informazioni sulla diagnostica, vedere Risoluzione dei problemi e diagnostica della cache di Azure In-Role.

Le sezioni seguenti descrivono gli elementi figlio disponibili all'interno di ogni elemento cacheDiagnostics .

crashDump

L'elemento crashDump controlla il tipo di dump di arresto anomalo raccolti per questa applicazione. In-Role i dump di arresto anomalo della cache sono progettati principalmente per diagnosticare i problemi relativi ai computer del cluster della cache. Per questo motivo, è necessario che i file di configurazione del client disabilitino la generazione di dump di arresto anomalo del sistema. A tale scopo, impostare l'attributo dumpLevel su Off.

Se i dump di arresto anomalo del sistema sono abilitati, l'archivio locale della memorizzazione nella cache e l'archivio della diagnostica devono essere impostati nel file ServiceDefinition.csdef in modo che la dimensione sia sempre maggiore della somma della quota di archiviazione relativa all'arresto anomalo del sistema e di quella relativa ai log. È possibile configurare questi valori nel file CacheSettings.xml (i valori predefiniti sono 1000 MB).

Nella tabella seguente vengono descritti gli attributi disponibili per l'elemento crashDump .

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