View important logs - Microservices Engine: Central de Documentação do Alibaba Cloud

A proteção de aplicações do Microservices Engine (MSE) gera três arquivos de log com métricas por segundo, eventos de bloqueio e atividades de processamento de regras para cada recurso protegido. Use esses logs para monitorar o status dos recursos e solucionar problemas de proteção em servidores individuais.

Todas as aplicações com a proteção de aplicações do MSE ativada produzem esses logs automaticamente.

Diretório de logs

O diretório base de logs (${BaseDir}) varia conforme a versão do agente MSE:

Versão do agente MSE	Diretório base
Anterior à 4.3.0	`${user_home}/logs/csp`
4.3.0 e posteriores	`/home/admin/.opt/AliyunJavaAgent/logs/sentinel`

Para verificar a versão do agente MSE, acesse a página de detalhes do nó da aplicação.

Arquivos de log

Tipo de log	Caminho do arquivo	Descrição
Logs de monitoramento por segundo	`${BaseDir}/${app_name}-metrics.log`	Dados de métricas por segundo para cada recurso protegido
Logs de detalhes de bloqueio	`${BaseDir}/sentinel-block.log`	Requisições bloqueadas por regras de proteção (controle de fluxo, circuit breaking, isolamento de concorrência, proteção de parâmetros quentes)
Logs de negócios	`${BaseDir}/sentinel-record.log.${Current date}`	Eventos de envio, recebimento e processamento de regras, além de chamadas de recursos

Logs de monitoramento por segundo

Cada linha no arquivo ${app_name}-metrics.log registra os dados de métrica de um recurso durante um intervalo de um segundo.

Exemplo de entrada:

1718765870000|2024-06-19 02:57:50|/flow|30|5|30|10|13|0|1|1|IN

Referência de campos

Posição	Campo	Exemplo	Descrição
1	Timestamp	`1718765870000`	Timestamp Unix em milissegundos
2	Hora formatada	`2024-06-19 02:57:50`	Timestamp legível
3	Nome do recurso	`/flow`	Nome do recurso protegido
4	QPS aprovado	`30`	Requisições aprovadas em todas as verificações de regras por segundo
5	QPS rejeitado	`5`	Requisições bloqueadas pelas regras de proteção por segundo
6	QPS concluído	`30`	Chamadas concluídas (com sucesso e falhas) por segundo
7	QPS anormal	`10`	Exceções de processamento do recurso por segundo
8	RT médio	`13`	Tempo médio de resposta do recurso
9	Reservado	`0`	Reservado para uso interno
10	Paralelismo	`1`	Requisições em andamento ainda não concluídas
11	Reservado	`1`	Reservado para uso interno
12	Direção	`IN`	`IN` = entrada (lado do servidor); `OUT` = saída (lado do cliente)

Logs de detalhes de bloqueio

Cada linha no arquivo sentinel-block.log registra os eventos de bloqueio de um recurso durante um intervalo de um segundo, independentemente do tipo de proteção (controle de fluxo, circuit breaking ou proteção de sistema).

Exemplos de entradas:

2024-06-19 03:13:44|1|/a,ConcurrencyLimitException,default,origin,26133,1718766824000|1,0,0
2024-06-19 03:13:45|1|/flow,FlowException,default,origin,33593,1718766825000|6,0,0

Referência de campos

Posição	Campo	Exemplo	Descrição
1	Hora formatada	`2024-06-19 03:13:44`	Timestamp do evento de bloqueio
2	Número de série	`1`	Número de série. Ignore este valor.
3	Nome do recurso	`/a`	Nome do recurso bloqueado
4	Tipo de bloqueio	`FlowException`	Classe de exceção que identifica o tipo de regra de proteção. Consulte a tabela de referência de tipos de bloqueio abaixo.
5	Reservado	`default`	Reservado para uso interno
6	Reservado	`origin`	Reservado para uso interno
7	ID da regra	`26133`	ID da regra de proteção que acionou o bloqueio
8	Timestamp	`1718766824000`	Timestamp Unix em milissegundos
9	Contagem de bloqueios	`1,0,0`	Primeiro valor: número de bloqueios por segundo. Os valores restantes são reservados.

Referência de tipos de bloqueio

Classe de exceção	Tipo de proteção
`FlowException`	Controle de fluxo (limitação de interface)
`DegradeException`	Circuit breaking ou degradação
`ConcurrencyLimitException`	Isolamento de concorrência
`ParamFlowException`	Proteção de parâmetros quentes (RPC)
`WebFlowException`	Proteção de parâmetros quentes (HTTP)

Logs de negócios

Os logs de negócios ficam armazenados em sentinel-record.log.${Current date} dentro de ${BaseDir}. Esses registros documentam o envio, o recebimento e o processamento de regras, bem como as chamadas de recursos. Use esses logs para solucionar problemas.