Konfigurace stavových spolehlivých služeb

Existují dvě sady nastavení konfigurace pro spolehlivé služby. 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 je určená v manifestu clusteru v části KtlLogger. Umožňuje konfiguraci umístění a velikosti sdíleného protokolu plus 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í

Následující příklad v Azure ARM nebo místní šabloně JSON ukazuje, jak změnit sdílený transakční protokol, který se vytvoří za účelem zálohování spolehlivých kolekcí stavových služeb.

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

Část manifestu ukázkového 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í clustermanifest.xml soubor.

   <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í nástroj má globální fond paměti přidělený z nestránkované paměti 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 ke spolehlivé replice služby. Velikost fondu se řídí nastavením WriteBufferMemoryPoolMinimumInKB a WriteBufferMemoryPoolMaximumInKB. WriteBufferMemoryPoolMinimumInKB určuje počáteční velikost tohoto fondu paměti a nejnižší velikost, na kterou se může fond paměti zmenšit. WriteBufferMemoryPoolMaximumInKB je nejvyšší velikost, do které se fond paměti může zvětšit. Každá spolehlivá replika služby, která je otevřena, může zvětšit velikost fondu paměti o množství stanovené systémem až do WriteBufferMemoryPoolMaximumInKB. Pokud je ve fondu paměti větší poptávka, než je k dispozici, požadavky na paměť se zpozdí, dokud nebude paměť k dispozici. Proto pokud je fond paměti pro zápis pro konkrétní konfiguraci příliš malý, může dojít k snížení výkonu.

Nastavení SharedLogId a SharedLogPath se vždy používají společně k definování 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 se sdílené soubory protokolu měly umístit na disky, které se používají výhradně pro sdílený soubor protokolu, aby se omezily kolize.

SharedLogSizeInMB určuje velikost místa na disku, které se má předem přidělit pro výchozí sdílený protokol na 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ých Reliable Services můžete upravit pomocí konfiguračního balíčku (Config) nebo implementace služby (kódu).

• Konfigurace – konfigurace prostřednictvím konfiguračního balíčku se provádí změnou souboru Settings.xml, který se vygeneruje v kořenovém adresáři balíčku sady Microsoft Visual Studio ve složce Config 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 příslušnými nastavenými možnostmi.

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

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 vzájemně zobrazit provoz replikace, což zajišťuje, aby data, která jsou vysoce dostupná, byla také zabezpečená. Ve výchozím nastavení brání zabezpečení replikace prázdný oddíl konfigurace zabezpečení.

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 replikací a místním uchováváním stavu. 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 musí být odesláno a zpracováno více potvrzovacích zpráv, z nichž každá obsahuje méně potvrzení). Čím větší je hodnota BatchAcknowledgementInterval, tím vyšší je celková propustnost replikace za cenu vyšší latence operace. To přímo znamená latenci potvrzení transakcí.

Hodnota CheckpointThresholdInMB určuje množství místa na disku, které replikátor může použít k ukládání informací o stavu do vyhrazeného souboru protokolu repliky. Zvýšení této hodnoty na vyšší než výchozí hodnotu by mohlo vést k rychlejší rekonfiguraci, když se do sady přidá nová replika. Důvodem je částečný přenos stavu, ke kterému dochází kvůli dostupnosti více historie operací v protokolu. To může potenciálně prodloužit dobu obnovení repliky po chybovém ukončení.

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

Nastavení SharedLogId a SharedLogPath se vždy používají společně, 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 stejný sdílený protokol zadat co nejvíce služeb. 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 omezily kolize pohybu hlavy. Očekáváme, že tuto hodnotu bude potřeba změnit jen 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