Configurar serviços confiáveis com monitoração de estado

Existem dois conjuntos de definições de configuração para serviços fiáveis. Um conjunto é global para todos os serviços confiáveis no cluster, enquanto o outro conjunto é específico para um determinado serviço confiável.

Configuração Global

A configuração de serviço global confiável é especificada no manifesto do cluster para o cluster na seção KtlLogger. Ele permite a configuração do local e tamanho do log compartilhado, além dos limites globais de memória usados pelo registrador. O manifesto do cluster é um único arquivo XML que contém definições e configurações que se aplicam a todos os nós e serviços no cluster. O arquivo é normalmente chamado de ClusterManifest.xml. Você pode ver o manifesto do cluster usando o comando powershell Get-ServiceFabricClusterManifest.

Nomes de configuração

No modelo JSON do Azure ARM ou local, o exemplo abaixo mostra como alterar o log de transações compartilhadas que é criado para dar suporte a quaisquer coleções confiáveis para serviços com monitoração de estado.

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

Exemplo de seção de manifesto de cluster de desenvolvedor local

Se você quiser alterar isso em seu ambiente de desenvolvimento local, você precisa editar o arquivo clustermanifest.xml local.

   <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>

Observações

O registrador tem um pool global de memória alocada a partir da memória do kernel não paginada que está disponível para todos os serviços confiáveis em um nó para armazenar em cache dados de estado antes de serem gravados no log dedicado associado à réplica de serviço confiável. O tamanho do pool é controlado pelas configurações WriteBufferMemoryPoolMinimumInKB e WriteBufferMemoryPoolMaximumInKB. WriteBufferMemoryPoolMinimumInKB especifica o tamanho inicial desse pool de memória e o tamanho mais baixo para o qual o pool de memória pode diminuir. WriteBufferMemoryPoolMaximumInKB é o tamanho mais alto para o qual o pool de memória pode crescer. Cada réplica de serviço confiável que é aberta pode aumentar o tamanho do pool de memória em uma quantidade determinada pelo sistema até WriteBufferMemoryPoolMaximumInKB. Se houver mais demanda de memória do pool de memória do que está disponível, as solicitações de memória serão atrasadas até que a memória esteja disponível. Portanto, se o pool de memória de buffer de gravação for muito pequeno para uma configuração específica, o desempenho poderá ser prejudicado.

As configurações SharedLogId e SharedLogPath são sempre usadas juntas para definir o GUID e o local do log compartilhado padrão para todos os nós no cluster. O log compartilhado padrão é usado para todos os serviços confiáveis que não especificam as configurações no settings.xml para o serviço específico. Para obter o melhor desempenho, os arquivos de log compartilhados devem ser colocados em discos usados exclusivamente para o arquivo de log compartilhado para reduzir a contenção.

SharedLogSizeInMB especifica a quantidade de espaço em disco a ser pré-alocada para o log compartilhado padrão em todos os nós. SharedLogId e SharedLogPath não precisam ser especificados para que SharedLogSizeInMB seja especificado.

Configuração Específica do Serviço

Você pode modificar as configurações padrão do Stateful Reliable Services usando o pacote de configuração (Config) ou a implementação do serviço (código).

• Config - A configuração por meio do pacote de configuração é realizada alterando o arquivo de Settings.xml gerado na raiz do pacote do Microsoft Visual Studio na pasta Config para cada serviço no aplicativo.
• Código - A configuração via código é realizada criando um ReliableStateManager usando um objeto ReliableStateManagerConfiguration com as opções apropriadas definidas.

Por padrão, o tempo de execução do Azure Service Fabric procura nomes de seção predefinidos no arquivo de Settings.xml e consome os valores de configuração ao criar os componentes de tempo de execução subjacentes.

Configuração de segurança do replicador

As configurações de segurança do replicador são usadas para proteger o canal de comunicação usado durante a replicação. Isso significa que os serviços não poderão ver o tráfego de replicação uns dos outros, garantindo que os dados altamente disponíveis também estejam seguros. Por padrão, uma seção de configuração de segurança vazia impede a segurança de replicação.

Nome da seção padrão

ReplicatorSecurityConfig

Configuração do replicador

As configurações do replicador configuram o replicador responsável por tornar o estado do Serviço Confiável com estado altamente confiável, replicando e persistindo o estado localmente. A configuração padrão é gerada pelo modelo do Visual Studio e deve ser suficiente. Esta seção fala sobre configurações adicionais que estão disponíveis para ajustar o replicador.

Nome da seção padrão

ReplicatorConfig

Nomes de configuração

Exemplo de configuração via código

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)
    { }
    ...
}

Arquivo de configuração de exemplo

<?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>

Observações

BatchAcknowledgementInterval controla a latência de replicação. Um valor de '0' resulta na menor latência possível, ao custo da taxa de transferência (já que mais mensagens de confirmação devem ser enviadas e processadas, cada uma contendo menos confirmações). Quanto maior o valor de BatchAcknowledgementInterval, maior a taxa de transferência geral da replicação, ao custo de maior latência de operação. Isso se traduz diretamente na latência das confirmações de transações.

O valor de CheckpointThresholdInMB controla a quantidade de espaço em disco que o replicador pode usar para armazenar informações de estado no arquivo de log dedicado da réplica. Aumentar isso para um valor mais alto do que o padrão pode resultar em tempos de reconfiguração mais rápidos quando uma nova réplica é adicionada ao conjunto. Isso se deve à transferência parcial de estado que ocorre devido à disponibilidade de mais histórico de operações no log. Isso pode aumentar o tempo de recuperação de uma réplica após uma falha.

A configuração MaxRecordSizeInKB define o tamanho máximo de um registro que pode ser gravado pelo replicador no arquivo de log. Na maioria dos casos, o tamanho de registro padrão de 1024 KB é o ideal. No entanto, se o serviço estiver fazendo com que itens de dados maiores façam parte das informações de estado, esse valor pode precisar ser aumentado. Há poucos benefícios em tornar MaxRecordSizeInKB menor que 1024, já que registros menores usam apenas o espaço necessário para o registro menor. Esperamos que este valor tenha de ser alterado apenas em casos raros.

As configurações SharedLogId e SharedLogPath são sempre usadas juntas para fazer com que um serviço use um log compartilhado separado do log compartilhado padrão para o nó. Para melhor eficiência, o maior número possível de serviços deve especificar o mesmo log compartilhado. Os arquivos de log compartilhados devem ser colocados em discos que são usados exclusivamente para o arquivo de log compartilhado para reduzir a contenção de movimento de cabeça. Esperamos que este valor tenha de ser alterado apenas em casos raros.

Próximos passos

• Depurar seu aplicativo do Service Fabric no Visual Studio
• Referência do desenvolvedor para serviços confiáveis