Konfigurace stavových spolehlivých služeb

Pro spolehlivé služby existují dvě sady nastavení konfigurace. Jedna sada je globální pro všechny spolehlivé služby v clusteru, zatímco druhá sada je specifická pro konkrétní spolehlivou službu.

Globální konfigurace

Globální konfigurace spolehlivé služby se zadává v manifestu clusteru pro cluster v části KtlLogger. Umožňuje konfiguraci umístění a velikosti sdíleného protokolu a navíc globální limity paměti používané protokolovacím nástrojem. Manifest clusteru je jeden soubor XML, který obsahuje nastavení a konfigurace, které platí pro všechny uzly a služby v clusteru. Soubor se obvykle nazývá ClusterManifest.xml. Manifest clusteru pro váš cluster můžete zobrazit pomocí příkazu PowerShellu Get-ServiceFabricClusterManifest.

Názvy konfigurací

V šabloně AZURE ARM nebo místní šablony JSON níže vidíte, jak změnit sdílený transakční protokol, který se vytvoří, aby se vrátily všechny spolehlivé kolekce stavových služeb.

"fabricSettings": [{
    "name": "KtlLogger",
    "parameters": [{
        "name": "SharedLogSizeInMB",
        "value": "4096"
    }]
}]

Ukázka části manifestu místního vývojářského clusteru

Pokud to chcete změnit v místním vývojovém prostředí, musíte upravit místní soubor clustermanifest.xml.

   <Section Name="KtlLogger">
     <Parameter Name="SharedLogSizeInMB" Value="4096"/>
     <Parameter Name="WriteBufferMemoryPoolMinimumInKB" Value="8192" />
     <Parameter Name="WriteBufferMemoryPoolMaximumInKB" Value="8192" />
     <Parameter Name="SharedLogId" Value="{7668BB54-FE9C-48ed-81AC-FF89E60ED2EF}"/>
     <Parameter Name="SharedLogPath" Value="f:\SharedLog.Log"/>
   </Section>

Poznámky

Protokolovací modul má globální fond paměti přidělený z paměti bez stránkovaného jádra, která je k dispozici všem spolehlivým službám na uzlu pro ukládání dat stavu do mezipaměti před zápisem do vyhrazeného protokolu přidruženého k spolehlivé replice služby. Velikost fondu je řízena nastavením WriteBufferMemoryPoolMinimumInKB a WriteBufferMemoryPoolMaximumInKB. WriteBufferMemoryPoolMinimumInKB určuje počáteční velikost tohoto fondu paměti i nejnižší velikost, na kterou se fond paměti může zmenšit. WriteBufferMemoryPoolMaximumInKB je nejvyšší velikost, na kterou může fond paměti růst. Každá otevřená replika služby může zvýšit velikost fondu paměti systémem určenou velikost až WriteBufferMemoryPoolMaximumInKB. Pokud je z fondu paměti více požadavků, než je k dispozici, požadavky na paměť budou zpožděny, dokud nebude k dispozici paměť. Proto pokud je fond paměti vyrovnávací paměti pro zápis příliš malý pro konkrétní konfiguraci, může dojít k snížení výkonu.

Nastavení SharedLogId a SharedLogPath se vždy používají společně k definování identifikátoru GUID a umístění výchozího sdíleného protokolu pro všechny uzly v clusteru. Výchozí sdílený protokol se používá pro všechny spolehlivé služby, které nezadávají nastavení v settings.xml pro konkrétní službu. Pro zajištění nejlepšího výkonu by měly být sdílené soubory protokolu umístěny na disky, které se používají výhradně pro soubor sdíleného protokolu, aby se snížila kolize.

SharedLogSizeInMB určuje velikost místa na disku, které se má předem přidělit pro výchozí sdílený protokol ve všech uzlech. SharedLogId a SharedLogPath není nutné zadávat, aby bylo možné zadat SharedLogSizeInMB.

Konfigurace specifická pro službu

Výchozí konfigurace stavové služby Reliable Services můžete upravit pomocí konfiguračního balíčku (konfigurace) nebo implementace služby (kódu).

• Konfigurace – Konfigurace prostřednictvím konfiguračního balíčku se provádí změnou souboru Settings.xml vygenerovaného v kořenovém adresáři balíčku sady Microsoft Visual Studio ve složce Konfigurace pro každou službu v aplikaci.
• Kód – Konfigurace prostřednictvím kódu se provádí vytvořením ReliableStateManager pomocí objektu ReliableStateManagerConfiguration s odpovídající sadou možností.

Modul runtime Azure Service Fabric ve výchozím nastavení hledá předdefinované názvy oddílů v souboru Settings.xml a využívá konfigurační hodnoty při vytváření základních komponent modulu runtime.

Konfigurace zabezpečení replikátoru

Konfigurace zabezpečení replikátoru slouží k zabezpečení komunikačního kanálu, který se používá během replikace. To znamená, že služby nebudou moct vidět provoz replikace mezi sebou a zajistit také zabezpečení dat, která jsou vysoce dostupná. Ve výchozím nastavení oddíl konfigurace prázdného zabezpečení brání zabezpečení replikace.

Výchozí název oddílu

ReplicatorSecurityConfig

Konfigurace replikátoru

Konfigurace replikátoru konfigurují replikátor, který je zodpovědný za zajištění vysoké spolehlivosti stavové služby Reliable Service tím, že replikuje a udržuje stav místně. Výchozí konfigurace je generována šablonou sady Visual Studio a měla by stačit. Tato část popisuje další konfigurace, které jsou k dispozici pro ladění replikátoru.

Výchozí název oddílu

ReplicatorConfig

Názvy konfigurací

Ukázková konfigurace prostřednictvím kódu

class Program
{
    /// <summary>
    /// This is the entry point of the service host process.
    /// </summary>
    static void Main()
    {
        ServiceRuntime.RegisterServiceAsync("HelloWorldStatefulType",
            context => new HelloWorldStateful(context, 
                new ReliableStateManager(context, 
        new ReliableStateManagerConfiguration(
                        new ReliableStateManagerReplicatorSettings()
            {
                RetryInterval = TimeSpan.FromSeconds(3)
                        }
            )))).GetAwaiter().GetResult();
    }
}    

class MyStatefulService : StatefulService
{
    public MyStatefulService(StatefulServiceContext context, IReliableStateManagerReplica stateManager)
        : base(context, stateManager)
    { }
    ...
}

Ukázkový konfigurační soubor

<?xml version="1.0" encoding="utf-8"?>
<Settings xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/2011/01/fabric">
   <Section Name="ReplicatorConfig">
      <Parameter Name="ReplicatorEndpoint" Value="ReplicatorEndpoint" />
      <Parameter Name="BatchAcknowledgementInterval" Value="0.05"/>
      <Parameter Name="CheckpointThresholdInMB" Value="512" />
   </Section>
   <Section Name="ReplicatorSecurityConfig">
      <Parameter Name="CredentialType" Value="X509" />
      <Parameter Name="FindType" Value="FindByThumbprint" />
      <Parameter Name="FindValue" Value="9d c9 06 b1 69 dc 4f af fd 16 97 ac 78 1e 80 67 90 74 9d 2f" />
      <Parameter Name="StoreLocation" Value="LocalMachine" />
      <Parameter Name="StoreName" Value="My" />
      <Parameter Name="ProtectionLevel" Value="EncryptAndSign" />
      <Parameter Name="AllowedCommonNames" Value="My-Test-SAN1-Alice,My-Test-SAN1-Bob" />
   </Section>
</Settings>

Poznámky

BatchAcknowledgementInterval řídí latenci replikace. Hodnota 0 má za následek nejnižší možnou latenci za cenu propustnosti (protože se musí odesílat a zpracovávat další zprávy potvrzení, přičemž každý obsahuje méně potvrzení). Čím větší je hodnota pro BatchAcknowledgementInterval, tím vyšší je celková propustnost replikace za cenu vyšší latence operace. To se přímo překládá na latenci potvrzení transakcí.

Hodnota CheckpointThresholdInMB určuje velikost místa na disku, které replikátor může použít k ukládání informací o stavu ve vyhrazeném souboru protokolu repliky. Zvýšení této hodnoty na vyšší hodnotu, než je výchozí hodnota, může vést k rychlejší rekonfiguraci při přidání nové repliky do sady. Důvodem je částečný přenos stavu, který probíhá kvůli dostupnosti více historie operací v protokolu. To může potenciálně zvýšit dobu obnovení repliky po chybovém ukončení.

Nastavení MaxRecordSizeInKB definuje maximální velikost záznamu, který může zapisovat replikátor do souboru protokolu. Ve většině případů je optimální výchozí velikost záznamů o velikosti 1024 kB. Pokud však služba způsobuje, že větší datové položky jsou součástí informací o stavu, může být potřeba tuto hodnotu zvýšit. Pokud je hodnota MaxRecordSizeInKB menší než 1024, menší záznamy využívají jenom místo potřebné pro menší záznam. Očekáváme, že tato hodnota se bude muset změnit pouze ve výjimečných případech.

Nastavení SharedLogId a SharedLogPath se vždy používají společně k tomu, aby služba používala samostatný sdílený protokol od výchozího sdíleného protokolu pro uzel. Pro zajištění co nejlepší efektivity by měl co nejvíce služeb zadat stejný sdílený protokol. Sdílené soubory protokolu by se měly umístit na disky, které se používají výhradně pro sdílený soubor protokolu, aby se snížila kolize pohybu hlavy. Očekáváme, že tato hodnota se bude muset změnit pouze ve výjimečných případech.

Další kroky

• Ladění aplikace Service Fabric v sadě Visual Studio
• Referenční informace pro vývojáře pro Reliable Services