Microservices Engine:Agregar una interfaz personalizada en Microservices Governance

Limitaciones

• Asegúrese de que la versión del agente de Java de MSE sea la 3.2.9 o posterior.

Nota

Para obtener información sobre las versiones del agente, consulte MSE Java agent release notes. También puede especificar una versión del agente si sigue las instrucciones en Specify the version of the MSE agent.

• Debido a limitaciones del modelo de programación, Microservices Governance solo muestra interfaces personalizadas con tráfico activo.

Procedimiento

Si su aplicación ya está conectada a MSE Microservices Governance, siga estos pasos para agregar una interfaz personalizada.

1. Agregue la siguiente dependencia al archivo pom.xml de su aplicación:

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

2. Agregue el seguimiento. Envuelva su lógica de negocio con el siguiente 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 si el tráfico de un recurso es entrante o saliente. EntryType.IN indica tráfico entrante y EntryType.OUT, tráfico saliente. Las reglas del sistema solo surten efecto en recursos de entrada.

   • El tráfico total de la aplicación que se muestra en la consola incluye estadísticas únicamente del tráfico EntryType.IN.

   • El nombre del recurso para el seguimiento personalizado no debe exceder los 1,024 caracteres.

   • Utilice únicamente los símbolos -, _, . o : en los nombres de recursos del seguimiento personalizado.

Comprobar los resultados

Inicie sesión en la consola de MSE. En el panel de navegación izquierdo, vaya a Microservices Governance > Application Governance. La conexión es correcta si la tarjeta de recursos de la aplicación aparece en la página Application Governance y reporta datos.

Además, si su interfaz personalizada genera tráfico, esta aparecerá en la pestaña Custom Interface de la aplicación correspondiente.

Vaya a la página de detalles de la interfaz de la aplicación y seleccione la pestaña Custom Interface. El lado izquierdo enumera cada interfaz personalizada con métricas como el volumen de solicitudes y la tasa de éxito. El lado derecho muestra gráficos de monitoreo de QPS y concurrencia máxima para la interfaz seleccionada.

Documentación relacionada

Puede proteger sus interfaces personalizadas con medidas de control de tráfico. Para obtener más información, consulte Configure a throttling rule, Configure an isolation rule y Configure a circuit breaking rule.