为容器服务Kubernetes版Java应用安装探针

只需安装ARMS应用监控组件（探针），即可监控部署在容器服务Kubernetes版中的Java应用，并查看应用拓扑、接口调用、异常事务和慢事务等相关监控数据。本文介绍如何为容器服务Kubernetes版Java应用安装探针。

前提条件

创建Kubernetes集群。您可按需选择创建Kubernetes专有版集群或创建Kubernetes托管版集群。
管理命名空间：本文示例中的命名空间名称为arms-demo。
如果JDK版本为1.8.0_25或者1.8.0_31，可能会出现无法安装探针的情况。若出现此情况，请将JDK版本升级至1.8.X版本。

步骤一：安装ARMS应用监控组件

安装ARMS应用监控组件ack-arms-pilot。

登录容器服务管理控制台。
在左侧导航栏选择市场 > 应用目录，在右侧页面单击ack-arms-pilot。
在应用目录 - ack-arms-pilot页面上，在右侧的创建面板中选择前提条件中创建的集群，并单击创建。

步骤二：为Java应用开启ARMS应用监控

如需在创建新应用的同时开启ARMS应用监控，请按以下步骤操作：

在容器服务Kubernetes版控制台左侧导航栏选择集群，在集群列表页面上的目标集群右侧操作列单击应用管理。
在无状态页面右上角单击使用YAML创建资源。

在使用YAML创建资源页面上选择示例模板，并在模板（YAML格式）中将以下annotations添加到spec > template > metadata层级下。

说明请将<your-deployment-name>替换为您的应用名称。

annotations:
  armsPilotAutoEnable: "on"
  armsPilotCreateAppName: "<your-deployment-name>"

创建一个无状态（Deployment）应用并开启ARMS应用监控的完整YAML示例模板如下：

展开查看完整示例YAML文件（Java）

apiVersion: v1
kind: Namespace
metadata:
  name: arms-demo
---
apiVersion: apps/v1beta1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-springboot-demo
  namespace: arms-demo
  labels:
    app: arms-springboot-demo
spec:
  replicas: 2
  selector:
    matchLabels:
      app: arms-springboot-demo
  template:
    metadata:
      annotations:
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "arms-k8s-demo"
      labels:
        app: arms-springboot-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: SELF_INVOKE_SWITCH
              value: "true"
            - name: COMPONENT_HOST
              value: "arms-demo-component"
            - name: COMPONENT_PORT
              value: "6666"
            - 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-springboot-demo-subcomponent
  namespace: arms-demo
  labels:
    app: arms-springboot-demo-subcomponent
spec:
  replicas: 2
  selector:
    matchLabels:
      app: arms-springboot-demo-subcomponent
  template:
    metadata:
      annotations:
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "arms-k8s-demo-subcomponent"
      labels:
        app: arms-springboot-demo-subcomponent
    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-subcomponent
          env:
            - name: SELF_INVOKE_SWITCH
              value: "false"
            - name: MYSQL_SERVICE_HOST
              value: "arms-demo-mysql"
            - name: MYSQL_SERVICE_PORT
              value: "3306"
---
apiVersion: v1
kind: Service
metadata:
  labels:
    name: arms-demo-component
  name: arms-demo-component
  namespace: arms-demo
spec:
  ports:
    # the port that this service should serve on
    - name: arms-demo-component-svc
      port: 6666
      targetPort: 8888
  # label keys and values that must match in order to receive traffic for this service
  selector:
    app: arms-springboot-demo-subcomponent
---
apiVersion: apps/v1beta1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-demo-mysql
  namespace: arms-demo
  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
  namespace: arms-demo
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
---

执行结果

在无状态页面上，目标应用的操作列将出现ARMS控制台按钮。

卸载探针

登录容器服务管理控制台。
在左侧导航栏单击集群，在集群列表页面上的目标集群右侧操作列单击应用管理。
在左侧导航栏选择应用 > Helm。
在Helm页面，ARMS Agent对应的发布名称arms-pilot右侧操作列，单击删除。
在删除应用对话框单击确定。
重启您的业务Pod。

常见问题

如何更改应用名称？
如需更改应用名称，您需要修改Deployment内的armsPilotCreateAppName参数。具体操作，请参见部署在容器服务K8s集群中的Java应用如何更改应用名称。
Agent安装失败怎么处理？
可能原因：arms-pilot的版本在v1.30以下。

解决方案：为容器服务Kubernetes版授予ARMS资源的访问权限。具体操作，请参见容器服务K8s集群中的应用安装Agent失败怎么处理？。
如何跨区域上报数据？
1. 在容器集群arms-pilot Namespace下的Deployment中添加ARMS_REPORT_REGION环境变量，值为ARMS所支持的RegionId（例如cn-hangzhou、cn-beijing）。
2. 重启现有应用或部署一个新的应用，完成跨区域上报。
  
  说明当添加环境变量后，该集群下所有应用均会跨区域上报到步骤一中指定的地域。

前提条件

步骤一：安装ARMS应用监控组件

步骤二：为Java应用开启ARMS应用监控

执行结果

卸载探针

常见问题

更多信息

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

EDAS

阿里云容器服务K8s集群

开源K8s集群

Docker集群

其他环境（如自建IDC）

开始监控：按应用语言

开始监控Java应用

开始监控PHP应用

开始监控Go应用 *

开始监控Node.js应用 *

开始监控 .NET应用 *

开始监控C++ 应用 *