借助ARMS应用监控，您可以对开源Kubernetes环境的应用进行应用拓扑、接口调用、异常事务和慢事务监控、SQL分析等监控。本文将帮助您将开源Kubernetes环境中的应用接入ARMS应用监控。

前提条件

  • 开通ARMS服务。
  • 安装Helm。
  • 确保您的Kubernetes api-server组件接口版本在1.10及以上。
  • 确保您的集群连通公网。

  • 如果JDK版本为1.8.0_25或者1.8.0_31，可能会出现无法安装探针的情况，请升级至1.8.X最新版本。

步骤一：安装探针

ARMS应用监控目前仅支持无状态（Deployment）和有状态（StatefulSet）两种类型的应用接入，两种类型的应用接入方法相同。此处以将开源Kubernetes环境中的无状态（Deployment）类型的应用接入ARMS应用监控为例。

  1. 采用以下方法之一下载arms-pilot。
    • 方法一：手动下载最新安装包。
    • 方法二： 执行以下Wget命令下载arms-pilot安装包。
      wget 'http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/arms-pilot/arms-pilot-0.1.1-community.tgz' -O arms-pilot-0.1.1.tgz
  2. 执行以下命令解压arms-pilot安装包。
    tar zxvf arms-pilot-0.1.1-community.tgz
  3. 编辑安装包下的values.yaml文件，根据实际情况修改uid和region_id，然后保存。
    userId: __USER_ID__
regionId: __REGION_ID__
  4. 执行以下命令安装arms-pilot。
    helm install ./arms-pilot-community --namespace arms-pilot-system

步骤二：获取License Key

  1. 登录ARMS控制台。
  2. 在左侧导航栏中选择应用监控 > 应用列表，并在顶部菜单栏选择目标地域。
  3. 在应用列表页面右上角单击接入应用。
  4. 在接入中心面板的后端应用区域，单击Java。
    手动安装Java应用
  5. 在接入Java面板右上角选择安装地域。
  6. 在STEP2区域获取License Key值。
    Section LicenseKey

步骤三：修改应用的YAML文件

  1. 执行以下命令查看目标无状态（Deployment）应用的YAML文件。
    kubectl get deployment {deployment名称} -o yaml
    说明 若您不清楚{deployment名称}，请先执行以下命令查看所有无状态（Deployment）应用，在执行结果中找到目标无状态（Deployment）应用，再查看目标无状态（Deployment）应用的YAML文件。
    kubectl get deployments --all-namespace
  2. 启动编辑目标无状态（Deployment）应用的YAML文件。
    kubectl edit deployment {Deployment名称} -o yaml
  3. 在YAML文件中的spec -> template -> metadata -> labels层级下加入以下内容。
    ARMSApmAppName: xxx
ARMSApmLicenseKey: xxx
    注意
    • 请将xxx分别替换成您的License Key和应用名称，应用名暂不支持中文。
    • 将License Key中的符号@替换为符号_。
    如果您需要在开源K8s环境中创建一个新的无状态（Deployment）应用并接入ARMS，则应用的完整YAML文件如下： 
    apiVersion: apps/v1beta1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-springboot-demo
  labels:
    app: arms-springboot-demo
spec:
  replicas: 2
  selector:
    matchLabels:
      app: arms-springboot-demo
  template:
    metadata:
      labels:
        app: arms-springboot-demo
        ARMSApmLicenseKey: "xxx_xxx"
        ARMSApmAppName: "arms-k8s-demo"
    spec:
      containers:
        - resources:
            limits:
              cpu: 0.5
          image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-springboot-demo:v0.1
          imagePullPolicy: Always
          name: arms-springboot-demo
          env:
            - name: MYSQL_SERVICE_HOST
              value: "arms-demo-mysql"
            - name: MYSQL_SERVICE_PORT
              value: "3306"
---
apiVersion: apps/v1beta1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-demo-mysql
  labels:
    app: mysql
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mysql
  template:
    metadata:
      labels:
        app: mysql
    spec:
      containers:
        - resources:
            limits:
              cpu: 0.5
          image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-demo-mysql:v0.1
          name: mysql
          ports:
            - containerPort: 3306
              name: mysql
---
apiVersion: v1
kind: Service
metadata:
  labels:
    name: mysql
  name: arms-demo-mysql
spec:
  ports:
    # the port that this service should serve on
    - name: arms-mysql-svc
      port: 3306
      targetPort: 3306
  # label keys and values that must match in order to receive traffic for this service
  selector:
    app: mysql
---
  4. 保存配置后，应用将自动重启，以上配置生效。

    2 ~ 5分钟后，若您的应用出现在ARMS控制台的应用监控 > 应用列表页面中且有数据上报，则说明接入成功。

卸载探针

  1. 当您不需要再监控开源Kubernetes环境中的Java应用时，可执行以下命令卸载arms-pilot。
    helm del --purge arms-pilot
  2. 重启您的业务Pod。

更多信息

不是您要找的文档？鼠标悬浮在这里试一试。

开始监控：按应用部署环境

EDAS

阿里云容器服务K8s集群

开源K8s集群

Docker集群

其他环境（如自建IDC）

开始监控：按应用语言

开始监控Java应用

开始监控PHP应用

开始监控Go应用 *

开始监控Node.js应用 *

开始监控 .NET应用 *

开始监控C++ 应用 *