Funcionalidade de diagnóstico dos Reliable Services com Monitorização de Estado
A classe StatefulServiceBase do Azure Service Fabric Stateful Reliable Services emite eventos EventSource que podem ser usados para depurar o serviço, fornecer informações sobre como o tempo de execução está operando e ajudar na solução de problemas.
Eventos EventSource
O nome EventSource para a classe StatefulServiceBase Stateful Reliable Services é "Microsoft-ServiceFabric-Services". Os eventos dessa fonte de eventos aparecem na janela Eventos de diagnóstico quando o serviço está sendo depurado no Visual Studio.
Exemplos de ferramentas e tecnologias que ajudam na coleta e/ou exibição de eventos EventSource são PerfView, Azure Diagnostics e a Microsoft TraceEvent Library.
Eventos
| Nome do evento | ID do Evento | Level | Descrição do evento |
|---|---|---|---|
| StatefulRunAsyncInvocation | 1 | Informativo | Emitido quando a tarefa RunAsync do serviço é iniciada |
| StatefulRunAsyncCancellation | 2 | Informativo | Emitido quando a tarefa RunAsync do serviço é cancelada |
| StatefulRunAsyncCompletion | 3 | Informativo | Emitido quando a tarefa RunAsync do serviço é concluída |
| StatefulRunAsyncSlowCancellation | 4 | Aviso | Emitido quando a tarefa RunAsync do serviço leva muito tempo para concluir o cancelamento |
| StatefulRunAsyncFailure | 5 | Erro | Emitido quando a tarefa RunAsync do serviço lança uma exceção |
Interpretar eventos
Os eventos StatefulRunAsyncInvocation, StatefulRunAsyncCompletion e StatefulRunAsyncCancellation são úteis para o gravador de serviço entender o ciclo de vida de um serviço, bem como o tempo de quando um serviço é iniciado, cancelado ou concluído. Essas informações podem ser úteis ao depurar problemas de serviço ou entender o ciclo de vida do serviço.
Os gravadores de serviço devem prestar muita atenção aos eventos StatefulRunAsyncSlowCancellation e StatefulRunAsyncFailure porque eles indicam problemas com o serviço.
StatefulRunAsyncFailure é emitido sempre que a tarefa RunAsync() do serviço lança uma exceção. Normalmente, uma exceção lançada indica um erro ou bug no serviço. Além disso, a exceção faz com que o serviço falhe, portanto, ele é movido para um nó diferente. Essa operação pode ser cara e atrasar solicitações recebidas enquanto o serviço é movido. Os autores de serviços devem determinar a causa da exceção e, se possível, atenuá-la.
StatefulRunAsyncSlowCancellation é emitido sempre que uma solicitação de cancelamento para a tarefa RunAsync leva mais de quatro segundos. Quando um serviço leva muito tempo para concluir o cancelamento, isso afeta a capacidade do serviço de ser reiniciado rapidamente em outro nó. Esse cenário pode afetar a disponibilidade geral do serviço.
Contadores de desempenho
O tempo de execução dos Serviços Confiáveis define as seguintes categorias de contadores de desempenho:
| Categoria | Description |
|---|---|
| Replicador transacional do Service Fabric | Contadores específicos para o Replicador Transacional do Azure Service Fabric |
| Service Fabric TStore | Contadores específicos para o Azure Service Fabric TStore |
O Service Fabric Transactional Replicator é usado pelo Reliable State Manager para replicar transações dentro de um determinado conjunto de réplicas.
O Service Fabric TStore é um componente usado em coleções confiáveis para armazenar e recuperar pares chave-valor.
O aplicativo Monitor de Desempenho do Windows que está disponível por padrão no sistema operacional Windows pode ser usado para coletar e exibir dados do contador de desempenho. O Diagnóstico do Azure é outra opção para coletar dados do contador de desempenho e carregá-los nas tabelas do Azure.
Nomes de instâncias do contador de desempenho
Um cluster que tenha um grande número de serviços confiáveis ou partições de serviço confiáveis terá um grande número de instâncias de contador de desempenho do replicador transacional. Este também é o caso dos contadores de desempenho TStore, mas também é multiplicado pelo número de Dicionários Confiáveis e Filas Confiáveis usados. Os nomes de instância do contador de desempenho podem ajudar a identificar a partição, a réplica de serviço e o provedor de estado específicos no caso do TStore, aos quais a instância do contador de desempenho está associada.
Categoria do Replicador Transacional do Service Fabric
Para a categoria Service Fabric Transactional Replicator, os nomes das instâncias do contador estão no seguinte formato:
ServiceFabricPartitionId:ServiceFabricReplicaId
ServiceFabricPartitionId é a representação de cadeia de caracteres da ID de partição do Service Fabric à qual a instância do contador de desempenho está associada. O ID da partição é um GUID, e sua representação de cadeia de caracteres é gerada através Guid.ToString do especificador de formato "D".
ServiceFabricReplicaId é a ID associada a uma determinada réplica de um serviço confiável. O ID da réplica é incluído no nome da instância do contador de desempenho para garantir sua exclusividade e evitar conflitos com outras instâncias do contador de desempenho geradas pela mesma partição. Mais detalhes sobre réplicas e seu papel em serviços confiáveis podem ser encontrados aqui.
O nome da Service Fabric Transactional Replicator instância do contador a seguir é típico de um contador na categoria:
00d0126d-3e36-4d68-98da-cc4f7195d85e:131652217797162571
No exemplo anterior, 00d0126d-3e36-4d68-98da-cc4f7195d85e é a representação de cadeia de caracteres da ID de partição do Service Fabric e 131652217797162571 é a ID da réplica.
Categoria de TStore do Service Fabric
Para a categoria Service Fabric TStore, os nomes das instâncias do contador estão no seguinte formato:
ServiceFabricPartitionId:ServiceFabricReplicaId:StateProviderId_PerformanceCounterInstanceDifferentiator_StateProviderName
ServiceFabricPartitionId é a representação de cadeia de caracteres da ID de partição do Service Fabric à qual a instância do contador de desempenho está associada. O ID da partição é um GUID, e sua representação de cadeia de caracteres é gerada através Guid.ToString do especificador de formato "D".
ServiceFabricReplicaId é a ID associada a uma determinada réplica de um serviço confiável. O ID da réplica é incluído no nome da instância do contador de desempenho para garantir sua exclusividade e evitar conflitos com outras instâncias do contador de desempenho geradas pela mesma partição. Mais detalhes sobre réplicas e seu papel em serviços confiáveis podem ser encontrados aqui.
StateProviderId é a ID associada a um provedor de estado dentro de um serviço confiável. O ID do provedor de estado é incluído no nome da instância do contador de desempenho para diferenciar um TStore de outro.
PerformanceCounterInstanceDifferentiator é uma ID diferenciadora associada a uma instância de contador de desempenho dentro de um provedor de estado. Esse diferencial é incluído no nome da instância do contador de desempenho para garantir sua exclusividade e evitar conflitos com outras instâncias do contador de desempenho geradas pelo mesmo provedor de estado.
StateProviderName é o nome associado a um provedor de estado dentro de um serviço confiável. O nome do provedor de estado é incluído no nome da instância do contador de desempenho para que os usuários identifiquem facilmente o estado que ele fornece.
O nome da Service Fabric TStore instância do contador a seguir é típico de um contador na categoria:
00d0126d-3e36-4d68-98da-cc4f7195d85e:131652217797162571:142652217797162571_1337_urn:MyReliableDictionary/dataStore
No exemplo anterior, é a representação de cadeia de caracteres da ID de partição do Service Fabric, é a ID da réplica, 00d0126d-3e36-4d68-98da-cc4f7195d85e 142652217797162571 é a ID 131652217797162571 do provedor de estado e 1337 é o diferencial da instância do contador de desempenho. urn:MyReliableDictionary/dataStore é o nome do provedor de estado que armazena dados para a coleção chamada urn:MyReliableDictionary.
Contadores de desempenho do Replicador Transacional
O tempo de execução dos Serviços Confiáveis emite os seguintes eventos na Service Fabric Transactional Replicator categoria
| Nome do contador | Description |
|---|---|
| Iniciar operações Txn/seg | O número de novas transações de gravação criadas por segundo. |
| Operações Txn/seg | O número de operações de adicionar/atualizar/excluir realizadas em coleções confiáveis por segundo. |
| Log Flush Bytes/seg | O número de bytes sendo liberados para o disco pelo Replicador Transacional por segundo |
| Operações limitadas/seg | O número de operações rejeitadas a cada segundo pelo Replicador Transacional devido à limitação. |
| Transação média ms/commit | Latência média de confirmação por transação em milissegundos |
| Latência média de descarga (ms) | Duração média das operações de liberação de disco iniciadas pelo Replicador Transacional em milissegundos |
Contadores de desempenho TStore
O tempo de execução dos Serviços Confiáveis emite os seguintes eventos na Service Fabric TStore categoria
| Nome do contador | Description |
|---|---|
| Contagem de itens | O número de itens na loja. |
| Tamanho do Disco | O tamanho total do disco, em bytes, dos arquivos de ponto de verificação para o armazenamento. |
| Bytes/s de gravação de arquivo de ponto de verificação | O número de bytes gravados por segundo para o arquivo de ponto de verificação mais recente. |
| Copiar bytes de transferência de disco/s | O número de bytes de disco lidos (na réplica primária) ou gravados (em uma réplica secundária) por segundo durante uma cópia de armazenamento. |
Próximos passos
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários