Todos os produtos
Search

Este produto

    Application Real-Time Monitoring Service:Install the ARMS Java agent in ACK and ACS clusters

    Central de documentação

    Application Real-Time Monitoring Service:Install the ARMS Java agent in ACK and ACS clusters

    Última atualização: Jul 02, 2026

    O Application Real-Time Monitoring Service (ARMS) instrumenta automaticamente aplicações Java em execução no Container Service for Kubernetes (ACK) e no Container Compute Service (ACS). Instale o componente ack-onepilot no cluster e adicione três rótulos ao Deployment. O ARMS coleta traces, topologia da aplicação, métricas de chamadas de API e dados de erro e latência sem exigir alterações no código.

    Nota

    As etapas de instalação para ACK e ACS são idênticas. Este guia usa o ACK como exemplo.

    Como funciona

    O componente ack-onepilot (Assistente de Integração do Agente ARMS) atua como controlador no cluster. Quando um pod rotulado é iniciado, o ack-onepilot injeta o agente Java do ARMS no pod automaticamente. Ao lançar uma nova versão do agente, o ack-onepilot o atualiza na próxima reinicialização da aplicação. Para fixar uma versão específica, consulte Controlar versões do agente manualmente.

    Para obter detalhes sobre o mecanismo de injeção, consulte Como o ack-onepilot funciona.

    Importante

    O componente legado arms-pilot não recebe mais manutenção. O ack-onepilot é seu substituto e oferece compatibilidade total — a migração não exige alterações na configuração da aplicação. Para visualizar as etapas de migração, consulte Desinstalar o arms-pilot e instalar o ack-onepilot.

    Visão geral do processo

    A configuração do monitoramento do ARMS envolve três etapas:

    1. Instale o ack-onepilot — Implante o componente de monitoramento pelo console do ACK.

    2. Grant ARMS permissions — Configure a autenticação do cluster para o ARMS (varia conforme o tipo de cluster).

    3. Rotule o Deployment — Adicione três rótulos ao modelo de pod para ativar a instrumentação automática.

    Pré-requisitos

    Antes de começar, certifique-se de ter:

    Etapa 1: Instalar o ack-onepilot

    1. Faça login no console do ACK. Na página Clusters, clique em o nome do cluster.

    2. No painel de navegação à esquerda, clique em Add-ons. Pesquise por ack-onepilot.

    3. No cartão do ack-onepilot, clique em Install.

    4. Na caixa de diálogo, mantenha os valores padrão dos parâmetros e clique em OK.

    Nota

    Por padrão, o ack-onepilot suporta até 1.000 pods. Para cada 1.000 pods adicionais, aloque 0,5 núcleo de CPU e 512 MB de memória ao componente.

    Após a instalação, atualize, configure ou desinstale o ack-onepilot na página Add-ons.

    Etapa 2: Conceder permissões ao ARMS

    As permissões necessárias dependem do tipo de cluster. Identifique o tipo do seu cluster e siga as instruções correspondentes.

    Clusters gerenciados ACK

    Clusters gerenciados ACK com um ARMS Addon Token são autorizados automaticamente. Verifique se o token existe antes de prosseguir.

    Nota

    Se um cluster possuir o ARMS Addon Token, o ARMS realiza autorização sem senha no cluster. O ARMS Addon Token pode não existir em alguns clusters gerenciados ACK. Recomendamos verificar se o cluster gerenciado ACK possui o ARMS Addon Token antes de usar o ARMS para monitorar aplicações nesse cluster.

    Clusters dedicados ACK e clusters registrados

    Clusters dedicados ACK e clusters registrados ACK One exigem dois itens:

    • Sua conta Alibaba Cloud deve ter as permissões AliyunARMSFullAccess e AliyunSTSAssumeRoleAccess. Consulte Gerenciar permissões para usuários RAM.

    • O componente ack-onepilot deve ter um par de AccessKey com permissões do ARMS.

    Forneça o par de AccessKey ao ack-onepilot usando um destes métodos.

    Método 1: Especificar o par de AccessKey no Helm

    1. Faça login no console do ACK. Clique em Clusters e, em seguida, clique em o nome do cluster.

    2. No painel de navegação à esquerda, escolha Applications > Helm. Clique em Update ao lado de ack-onepilot.

    3. Substitua os valores de accessKey e accessKeySecret pelo seu AccessKey ID e AccessKey secret. Clique em OK.

      Nota

      Para obter um par de AccessKey, consulte Criar um par de AccessKey.

      Helm AccessKey configuration

    4. Reinicie o Deployment da aplicação.

    Método 2: Usar um Secret do Kubernetes

    1. Faça login no console do ACK. Clique em Clusters e, em seguida, clique em o nome do cluster.

    2. No painel de navegação à esquerda, escolha Configurations > Secrets. Selecione o namespace ack-onepilot e crie um Secret para armazenar seu AccessKey ID e AccessKey secret.

      Nota

      Para obter um par de AccessKey, consulte Criar um par de AccessKey.

      Secret creation for AccessKey

    3. No painel de navegação à esquerda, escolha Workloads > Deployments. Clique em o componente ack-onepilot (geralmente nomeado ack-onepilot-ack-onepilot no namespace ack-onepilot).

    4. No canto superior direito, clique em Edit. Na seção Environment Variables, adicione estas duas variáveis e referencie os valores do Secret. Clique em OK.

      Variável de ambiente

      Descrição

      ONE_PILOT_ACCESSKEY

      Referencia o AccessKey ID armazenado no Secret

      ONE_PILOT_ACCESSKEY_SECRET

      Referencia o AccessKey secret armazenado no Secret

      Environment variables configuration

    Clusters serverless ACK (ASK) e clusters integrados com ECI

    Conclua a autorização na página Autorização de Acesso a Recursos e reinicie todos os pods do componente ack-onepilot.

    Etapa 3: Rotular o Deployment

    Adicione três rótulos à seção spec.template.metadata.labels do YAML do Deployment para ativar o monitoramento do ARMS:

    labels:
  armsPilotAutoEnable: "on"
  armsPilotCreateAppName: "<your-deployment-name>"    # Replace <your-deployment-name> with your application name.
  aliyun.com/app-language: java

    Rótulo

    Valor

    Descrição

    armsPilotAutoEnable

    "on"

    Ativa a injeção automática do agente para o pod

    armsPilotCreateAppName

    "<your-deployment-name>"

    Nome da aplicação exibido no console do ARMS. Substitua pelo nome da sua aplicação.

    aliyun.com/app-language

    java

    Especifica a linguagem da aplicação para o agente
    Nota

    Os rótulos devem estar em spec.template.metadata.labels (modelo de pod), e não em metadata.labels (metadados do Deployment). Colocar rótulos no local errado é uma causa comum para a ausência de dados de monitoramento.

    Aplicar os rótulos a um Deployment existente

    1. Faça login no console do ACK. Clique em Clusters e, em seguida, clique em o nome do cluster.

    2. No painel de navegação à esquerda, escolha Workloads > Deployments.

    3. Na página Stateless, clique em more icon > YAML Edit ao lado da aplicação alvo.

    4. Adicione os três rótulos em spec.template.metadata.labels e clique em Update.

    Nota

    Para mais informações sobre segurança de aplicações, consulte O que é segurança de aplicações?.

    Para mais informações sobre faturamento de segurança de aplicações, consulte Visão geral de faturamento.

    YAML Example

    Criar um novo Deployment com monitoramento ativado

    Na página Stateless, clique em Create from YAML e inclua os rótulos na definição do Deployment.

    Verificar dados de monitoramento

    Na página Stateless, clique em more icon > ARMS Console na coluna Actions da aplicação alvo para visualizar os detalhes de monitoramento da aplicação.

    ARMS Console link

    Perguntas frequentes