Connect an ECS microservice application to the MSE governance center - Microservices Engine: Central de Documentação do Alibaba Cloud

O Microservices Engine (MSE) oferece um agente Java que adiciona recursos de governança às suas aplicações Spring Cloud ou Dubbo existentes sem exigir alterações no código. O agente se conecta à JVM da aplicação, intercepta chamadas de serviço em tempo de execução e aplica as políticas de governança configuradas no console do MSE.

Este guia orienta você a baixe o agente Java do MSE, configure-o em uma instância do Elastic Compute Service (ECS) e verificar a conexão. Os mesmos passos se aplicam a aplicações em máquinas virtuais (VMs) fora da Alibaba Cloud.

Como o agente funciona

O agente Java do MSE opera como um plugin da JVM (-javaagent). Durante a inicialização, ele se autentica no plano de controle do MSE com a chave de licença específica da região e intercepta chamadas de serviço de entrada e saída para aplicar as políticas de governança. O agente envia metadados da aplicação ao console do MSE, onde a aplicação aparece em Microservices Governance > Application Governance.

Como o MSE e o Application Real-Time Monitoring Service (ARMS) compartilham o mesmo agente subjacente, uma única anexação via -javaagent gerencia tanto a governança quanto o monitoramento caso você utilize ambos os serviços.

Pré-requisitos

Antes de começar, verifique se você tem:

Uma instância ECS. Para mais informações, consulte Crie uma instância ECS
Um Java Development Kit (JDK) instalado com a variável de ambiente JAVA_HOME configurada. Para links de download, acesse Java Downloads
Memória heap da JVM superior a 256 MB. O agente Java do MSE não inicia com um heap menor
Uma instância de Governança de Microsserviços do MSE na mesma região da instância ECS. As chaves de licença são específicas por região; portanto, uma incompatibilidade de região causa falha na autenticação do agente

Nota

A Governança de Microsserviços do MSE está disponível em três edições: Basic Edition, Professional Edition e Enterprise Edition. Escolha a edição que atende aos seus requisitos de governança.

Etapa 1: Baixe o agente Java do MSE

Faça login no console do ECS.
No painel de navegação à esquerda, escolha Instances & Images > Instances.
Na barra de navegação superior, selecione uma region.
Na página Instances, localize a instância para a qual deseja ativar a Governança de Microsserviços e clique em Connect na coluna Actions.
Na caixa de diálogo Remote connection, selecione um método de conexão. Para obter detalhes, consulte Métodos para conectar a uma instância ECS.

Baixe o pacote do agente. Substitua ${regionId} pelo ID real da sua região (por exemplo, cn-hangzhou). Para obter a lista completa de IDs de região suportados, consulte Regiões suportadas. Baixe pela internet: Baixe via VPC (recomendado se a instância não tiver acesso à internet): Por exemplo, para baixe o agente na região China (Hangzhou) pela internet:

   wget http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip

   wget http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip

   wget http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip

Importante

O pacote do agente é específico por região. Sempre baixe o pacote correspondente à região da sua instância de Governança de Microsserviços.

Etapa 2: Instale e configure o agente

Extraia o pacote do agente para um diretório de sua preferência. Substitua <your-install-dir> pelo caminho real do diretório, como /opt/mse.
```
   unzip AliyunJavaAgent.zip -d /<your-install-dir>/
```

Adicione os seguintes parâmetros da JVM ao comando de inicialização da aplicação. Substitua os placeholders abaixo pelos valores reais:

Importante

A memória heap da JVM deve ser superior a 256 MB. O agente falha ao iniciar com um heap menor.

Placeholder	Descrição	Exemplo
`<your-install-dir>`	Diretório onde você extraiu o agente	`/opt/mse`
`<your-license-key>`	Chave de licença obtida no console do MSE. Acesse Microservices Governance > Overview para encontrá-la. Não compartilhe esta chave.	`abcdef1234****`
`<your-app-name>`	Nome que identifica a aplicação no console do MSE	`order-service`

   java \
     -javaagent:/<your-install-dir>/AliyunJavaAgent/aliyun-java-agent.jar \
     -Dmse.licenseKey=<your-license-key> \
     -Dmse.appName=<your-app-name> \
     -Dprofiler.micro.service.mse.version=pro \
     -Dmse.namespace=default \
     -Dmse.enable=true \
     -jar application.jar

Referência de parâmetros

Parâmetro	Descrição
`mse.licenseKey`	Chave de licença gerada pelo MSE, visível na página Overview da Governança de Microsserviços. Específica por região. Mantenha-a confidencial.
`mse.appName`	Nome de exibição da aplicação no console do MSE.
`profiler.micro.service.mse.version`	Edição de governança a ser ativada. Valores válidos: `base` (Basic Edition), `pro` (Professional Edition), `ent` (Enterprise Edition).
`mse.namespace`	Namespace de governança ao qual esta aplicação pertence. Consulte os namespaces disponíveis no console do MSE.
`mse.enable`	Defina como `true` para ative a governança ou `false` para desativá-la.

Se a aplicação já utiliza o ARMS

O MSE e o ARMS compartilham o mesmo agente Java. Caso o parâmetro -javaagent já esteja presente no comando de inicialização para o ARMS, não o adicione novamente. Apenas anexe os parâmetros específicos do MSE (mse.licenseKey, mse.appName, profiler.micro.service.mse.version, mse.namespace e mse.enable) ao comando existente.

Etapa 3: Verifique a conexão

Faça login no console do MSE.
Na barra de navegação superior, selecione a região correspondente à implantação da aplicação.
No painel de navegação à esquerda, escolha Microservices Governance > Application Governance.
Confirme se a aplicação aparece na lista de aplicações. Em caso afirmativo, o agente está conectado e a governança está ativa.

Próximos passos

Com a Governança de Microsserviços ativada, gerencie suas aplicações Spring Cloud ou Dubbo diretamente pelo console do MSE. Utilize os recursos de governança fornecidos pelo MSE para aumentar a estabilidade e a eficiência de desenvolvimento das suas aplicações de microsserviços online.