Microservices Engine:Adicionar uma interface personalizada no Microservices Governance

Limitações

• Verifique se o agente Java do MSE está na versão 3.2.9 ou posterior.

Nota

Para obter informações sobre as versões do agente, consulte Notas de versão do agente Java do MSE. Também é possível especificar uma versão do agente seguindo as instruções em Especificar a versão do agente MSE.

• Devido a limitações do modelo de programação, o Microservices Governance exibe apenas interfaces personalizadas com tráfego ativo.

Procedimento

Se sua aplicação já estiver conectada ao MSE Microservices Governance, siga estas etapas para adicionar uma interface personalizada.

1. Adicione a seguinte dependência ao arquivo pom.xml da aplicação:

   <dependency>
     <groupId>com.alibaba.csp</groupId>
     <artifactId>sentinel-core</artifactId>
     <version>1.8.7</version>
   </dependency>

2. Adicione o rastreamento. Envolva a lógica de negócios com o seguinte código:

   import com.alibaba.csp.sentinel.Entry;
   import com.alibaba.csp.sentinel.SphU;
   import com.alibaba.csp.sentinel.slots.block.BlockException;
   import com.alibaba.csp.sentinel.EntryType;
   // HelloWorld is the resource name. This name is displayed on the monitoring page and in the interface list in the console.
   // Rules are also configured based on this resource name.
   // EntryType.IN identifies this as an ingress resource.
   try (Entry entry = SphU.entry("HelloWorld", EntryType.IN)) {
    // Your protected business logic.
    System.out.println("Hello MSE Sentinel!");
   } catch (BlockException e) {
    // A throttling or degradation event is triggered. Handle the event here, for example, by using a fallback or logging the event.
   }

   Nota

   • EntryType distingue se o tráfego em um recurso é de entrada ou de saída. EntryType.IN indica tráfego de entrada e EntryType.OUT, tráfego de saída. As regras do sistema aplicam-se apenas a recursos de entrada.

   • O tráfego total da aplicação exibido no console inclui estatísticas apenas do tráfego EntryType.IN.

   • O nome do recurso para rastreamento personalizado não pode exceder 1.024 caracteres.

   • Use apenas os símbolos -, _, . ou : nos nomes de recursos do rastreamento personalizado.

Verificar os resultados

Faça login no console do MSE. No painel de navegação à esquerda, escolha Microservices Governance > Application Governance. A conexão terá êxito se o cartão de recurso da aplicação aparecer na página Application Governance e estiver reportando dados.

Além disso, se a interface personalizada gerar tráfego, ela aparecerá na aba Custom Interface da aplicação correspondente.

Acesse a página de detalhes da interface da aplicação e selecione a aba Custom Interface. O lado esquerdo lista cada interface personalizada com métricas como volume de solicitações e taxa de sucesso. O lado direito exibe gráficos de monitoramento de QPS e concorrência máxima da interface selecionada.

Documentação relacionada

Proteja suas interfaces personalizadas com medidas de controle de tráfego. Para mais informações, consulte Configurar uma regra de limitação, Configurar uma regra de isolamento e Configurar uma regra de circuit breaking.