Todos os produtos
Search
Central de documentação

Application Real-Time Monitoring Service:Ative a observabilidade do Kubernetes com o OBI

Última atualização: Oct 20, 2026

Ao enviar dados de rastreamento para o Cloud Monitor 2.0 por meio do monitoramento não intrusivo do OpenTelemetry eBPF Instrumentation (OBI), o Cloud Monitor 2.0 passa a monitorar suas aplicações. Em seguida, você pode visualizar os dados de monitoramento, que incluem topologia da aplicação, rastreamentos, exceções, transações lentas e análise de SQL. Este tópico descreve como usar o OBI para monitorar aplicações e enviar dados.

Pré-requisitos

  • Certifique-se de que o seu cluster Kubernetes esteja na versão 1.24 ou superior.

  • Se o seu cluster Kubernetes não estiver implantado na Alibaba Cloud, garanta que o cluster tenha acesso à internet ou esteja conectado a uma Virtual Private Cloud (VPC) da Alibaba Cloud por meio de serviços como o Cloud Enterprise Network (CEN).

Etapa 1: Instale o Helm 3

Instale o Helm 3 na máquina que você usa para gerenciar o cluster Kubernetes de destino. A Etapa 2 utiliza o comando helm3 para implantar o arms-obi no cluster. Se o Helm 3 já estiver instalado, pule esta etapa. Para obter instruções de instalação, consulte a documentação do Helm vinculada neste título.

Etapa 2: Instale o OBI

  1. Execute o comando wget a seguir e baixe o pacote de instalação do arms-obi.

    wget 'https://aliacs-k8s-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/app/charts-incubator/arms-obi-0.15.0.tgz'
  2. Execute o comando a seguir para extrair o pacote de instalação do arms-obi.

    tar xvf arms-obi-0.15.0.tgz               
  3. No pacote de instalação, edite o arquivo values.yaml. Modifique os parâmetros a seguir para o seu ambiente e salve o arquivo.

    workspace: default-cms-__ACK_UID__-__ACK_REGION_ID__
    registry: registry-__ACK_REGION_ID__.ack.aliyuncs.com/acs/
    cluster_id: __ACK_CLUSTER_ID__
    accessKey: __ACCESSKEY__
    accessKeySecret: __ACCESSKEY_SECRET__
    uid: "__ACK_UID__"
    region_id: __ACK_REGION_ID__

    workspace: Substitua __ACK_UID__ e __ACK_REGION_ID__ pelo UID da sua conta principal e pelo ID da região para a qual deseja enviar os dados. Caso queira enviar dados para um workspace não padrão, substitua este valor pelo nome do workspace no Cloud Monitor 2.0.

    registry: Especifica o endereço do repositório de imagens do arms-obi. O arms-obi contém três imagens. Se o seu ambiente não tiver acesso à internet, sincronize essas imagens com o seu repositório privado:

    registry-cn-hangzhou.ack.aliyuncs.com/acs/obi:obi-app-update-0.15.0
    registry-cn-hangzhou.ack.aliyuncs.com/acs/obi:0.15.0
    registry-cn-hangzhou.ack.aliyuncs.com/acs/obi:init-0.15.0

    cluster_id: Um ID de cluster Kubernetes personalizado, que atua como o identificador exclusivo do cluster. Recomendamos o uso de um formato descritivo.

    accessKey e accessKeySecret: O AccessKey ID e o AccessKey Secret da sua conta principal. Consulte Create an AccessKey.

    Importante

    Certifique-se de que a conta principal tenha as permissões AliyunARMSFullAccess e AliyunSTSAssumeRoleAccess.

    • uid: O ID da sua conta principal. Para obter o ID, passe o mouse sobre a sua foto de perfil no canto superior direito do console da Alibaba Cloud.

    • region_id: O ID da região da Alibaba Cloud. Para ver as regiões suportadas, consulte Supported regions.

  4. Execute o comando a seguir e instale o arms-obi. Execute este comando fora do diretório arms-obi.

    helm3 upgrade --install arms-obi arms-obi --namespace obi-system --create-namespace

Etapa 3: Configure a aplicação

Nota

Ative o monitoramento gRPC de uma aplicação reiniciando-a após a integração.

  1. No namespace obi-system, localize arms-obi-discovery-default e clique em Edit.

  2. Adicione o nome do deployment, o namespace e o nome da aplicação a ser exibido no Cloud Monitor 2.0. O código a seguir fornece um exemplo de configuração:

    discovery:
      instrument:
        - k8s_deployment_name: "server"
          k8s_namespace: "arms-default"
          name: "server-test-obi"