例行维护

1 运维概述

Kbox云手机容器是基于Docker容器技术，使能Android系统的虚拟化方案，通过云服务器提供云服务的虚拟手机。Kbox云手机容器可凭借自带的Android系统及厂商架设的网络终端，通过网络应用在云托管、云应用和云终端等业务场景。

Kbox云手机为满足高密度低成本的业务诉求，采用容器直通架构，基于容器的方法在Linux系统上启动完整Android系统。Kbox云手机容器架构图如所示。

本文档主要用于描述Kbox云手机容器例行维护相关内容。

• 运维对象

  包括Kbox云手机容器及其运行环境等套件及其子部件。

• 运维功能

  提供对运维对象的巡检、监控、日志管理、高危操作和日常维护等能力。

2 巡检

2.1 简介

本章主要介绍对Kbox云手机容器及其运行环境的巡检操作，检查Kbox云手机容器部署环境，实时监控容器运行状况及其资源占用，及时发现并处理影响容器正常运行的问题，保证Kbox云手机容器稳定运行。

2.2 巡检项目和周期

Kbox云手机容器巡检项目参考表 1 Kbox云手机容器巡检项目和周期。

表 1 Kbox云手机容器巡检项目和周期

2.3 检查容器状态

2.3.1 启动时容器状态

启动Kbox云手机容器后，执行以下命令检查启动是否成功，其中“${index}”为启动实例的编号。

docker exec -it kbox_${index} sh
getprop | grep boot

若回显信息中，sys.boot_completed显示为“1”，则表示启动成功，否则，说明容器启动失败，请联系华为技术支持。回显示例如下。

[service.bootanim.exit]: [1]
[sys.boot.reason]: [reboot,factory_reset]
[sys.boot.reason.last]: [reboot]
[sys.boot_completed]: [1]
[sys.bootstat.first_boot_completed]: [1]
[sys.rescue_boot_count]: [1]

2.3.2 运行时容器状态

在Kbox云手机容器运行过程中，可通过检查其进程状态来判断容器是否正常。执行以下命令，其中“${index}”为启动实例的编号。

docker exec -it kbox_${index} sh
ps -elf

若超过10个进程的父进程变为进程sh（进程号为1），如下图所示，则说明容器内发生了crash，容器当前处于异常情况，请重启容器或联系华为技术支持。

重启容器命令如下：

./android_kbox.sh restart ${index}

2.4 检查容器资源消耗

在Kbox云手机容器运行的过程中，若需要及时掌握容器使用的系统资源，可以执行以下命令。

docker stats

上述命令可动态显示Kbox云手机容器使用的资源消耗情况，包括CPU使用率、内存使用率、网络I/O数据以及磁盘I/O数据等，如下图所示。

3 监控

3.1 简介

本章主要介绍Kbox云手机容器在运行过程中对服务器系统资源消耗的监控方法，让用户及时了解系统资源使用情况、趋势和告警。

3.2 CPU使用详情

在Kbox云手机容器运行过程中，可通过top命令查看系统中正在运行的进程的实时状态，包括各个进程的CPU占用率和内存消耗情况等，如下图所示。

top

通过该命令，可以监控Kbox云手机容器中是否有CPU占用率过高的进程，若有，则需要进一步排查该进程是否异常。

另外，还可通过htop命令更直观地显示CPU负载、内存消耗以及交换空间的实时信息。

htop

如下图所示，除CPU负载、内存消耗以及交换空间的实时信息外，还显示了任务、线程、平均负载及系统运行时间信息，最下方列出了系统中的进程信息。

yum install htop

3.3 系统内存

使用free命令可查询到服务器内存使用情况，包括实体内存、虚拟的交换文件内存、共享内存区域以及系统核心使用的缓冲区等。

free

回显示例如下。

                total        used        free      shared  buff/cache   available
Mem:        527039424     4531436   518860944        4860     3647044   519951396
Swap:        83888604           0    83888604

3.4 系统存储

使用df命令可查看Kbox云手机容器运行环境上文件系统磁盘使用情况统计。

df -h

如下图所示Kbox云手机容器数据存储在“/root/mount/data/”下，红色矩形中为容器kbox_1的数据存储信息，其存储大小为“16G”，当前使用率为“1%”。若“Use%”的值不大于85%，则磁盘空间使用率正常，否则需要清理磁盘空间。

3.5 GPU使用详情

3.5.1 AMD GPU状态查询

GPU使用状态

使用radeontop工具可查看Kbox云手机容器运行环境上GPU使用状态。radeontop工具通过以下步骤下载并安装。

1. 获取radeontop工具包并上传到服务器。

   获取链接

2. 安装命令如下。

   rpm -ivh radeontop-1.4-2.el8.aarch64.rpm

3. 编译或安装成功后执行以下命令查看GPU使用状态。

   radeontop

4. 如下图所示，VRAM一行表示显存使用率。

   

GPU温度

在Kbox云手机容器运行过程中，若GPU温度过高，可能会导致服务器宕机的异常情况，因此在运行大型游戏或应用时，需要监控运行环境上GPU的温度。

在Kbox云手机容器运行环境上，可采用以下命令查询GPU温度。

cat /sys/kernel/debug/dri/*/amdgpu_pm_info |grep Temp

如下图所示为查询结果。若温度长期高于80°C，请联系华为技术支持。

3.5.2 道客DC 1000状态查询

使用GPU驱动包VAGPU-25.03.01.01-RC20.tgz中提供的工具，以查看GPU状态。

1. 请参见《install guide》文档中“环境准备”章节中的“软件环境”小节获取VAGPU-25.03.01.01-RC20.tgz包并解压，将解压获得的显卡工具包tools-3.2.2_sp1.tgz上传至服务器。
2. 显卡工具包tools-3.2.2_sp1.tgz的具体使用方法可以请参见tools-doc-3.2.2_sp1.tgz压缩包中的说明文档。

4 日志管理

4.1 简介

本章主要介绍在Kbox云手机容器运行过程中的日志管理方法，包括日志查询、转储等。

4.2 Kbox云手机容器日志

4.2.1 容器元数据

可使用Docker提供的inspect命令查看容器的详细信息，如下命令，其中“${index}”为启动实例的编号。

docker inspect kbox_${index}

上述命令会以JSON数组的格式返回容器的所有元数据信息。多数情况下，只需要获取容器的特定数据信息，则可直接从JSON数据中截取需要的数据，如只获取容器的IP地址可使用如下命令。其他容器数据查询命令如表 1 常用容器数据查询命令所示。

docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' kbox_${index}

回显结果为本容器的IP地址信息。

表 1 常用容器数据查询命令

4.2.2 容器内logcat日志

当容器运行出现异常时，可以查询日志进行辅助定位。实时查询Kbox云手机容器的logcat日志，可执行如下命令，其中“${index}”为启动实例的编号。

docker exec -it kbox_${index} logcat

若需要保存容器logcat日志，可执行如下命令，将日志保存到当前目录的“log.log”中。日志保存路径和名称可按照业务需要进行修改。

docker exec -it kbox_${index} logcat -d >> ./log.log

4.2.3 容器内进程信息

在Kbox云手机容器中可执行如下命令列出当前正在运行的进程信息，其中“${index}”为启动实例的编号。

docker exec -it kbox_${index} ps -elf

4.2.4 容器内top信息

top命令是常用的性能分析工具，能够实时显示系统中各个进程的资源占用情况，在Kbox云手机容器中执行如下所示的top命令查询系统中进程的资源占用情况，其中“${index}”为启动实例的编号。

docker exec -it kbox_${index} top

4.2.5 ANR时应用堆栈信息

在Kbox云手机容器内若出现了应用程序未响应（ANR，Application Not Responding）时，需要搜集相关应用堆栈信息，该信息保存在容器的“/data/anr/”路径下。

4.2.6 dumpsys信息

dumpsys是在Android设备上运行的工具，可提供有关系统服务的信息，执行如下命令获取容器的所有系统服务诊断输出，其中“${index}”为启动实例的编号。

docker exec -it kbox_${index} dumpsys

上述命令执行后，输出的数据信息会比较多，一般情况下需要在命令中指定需要检查的服务。

• 获取dumpsys支持的系统服务完整列表可执行如下命令。

  docker exec -it kbox_${index} dumpsys -l

• 获取容器内存信息可执行如下命令。

  docker exec -it kbox_${index} dumpsys meminfo

  结果如下图所示。

  

4.2.7 容器属性信息

可通过getprop命令从Kbox云手机容器中读取属性信息，命令如下所示，其中“${index}”为启动实例的编号。

docker exec -it kbox_${index} getprop

4.3 运行环境日志

4.3.1 dmesg日志

Kbox云手机容器出现异常时，需要搜集dmesg日志以便进行问题定位。

dmesg日志中包含设备初始化日志、内核模块日志，还会记录应用崩溃的相关信息，对于后续根因分析和定位有显著帮助。

dmesg日志一般保存在服务器的“/var/log/”路径下，也可直接执行如下命令获取。

dmesg -T

4.4 维护工具

4.4.1 工具简介

为增强云手机原型的可测试性、可服务性和可维护性，Kbox云手机容器提供了Kbox_maintainer维护工具。该工具集成了日志收集、资源检查、故障恢复等多项功能，显著提升了云手机原型的整体性能。

4.4.2 日志收集

Kbox_maintainer维护工具收集的日志信息包括Android日志和服务器日志，请参考表 1 Kbox_maintainer日志收集。

表 1 Kbox_maintainer日志收集

Kbox_maintainer维护工具支持单个容器和全部容器日志收集，收集后打包。提供log命令字段，可通过容器号或容器名参数，收集指定容器的日志。不带容器号，默认收集所有容器日志。例如：

python3 kbox_maintainer.py log
python3 kbox_maintainer.py log kbox_1

4.4.3 资源检查

Kbox_maintainer维护工具提供资源检查功能，收集Kbox云手机容器及服务器的内存、CPU、存储和GPU等信息，单独查询某项信息时请参见表 1 Kbox_maintainer资源检查详情中的命令（容器内运行相关命令即可），或者使用Kbox_maintainer工具批量收集所有数据。

表 1 Kbox_maintainer资源检查

Kbox_maintainer维护工具支持单个容器和全部容器资源信息收集，收集后打包。提供resource命令字段，可通过容器号或容器名参数，收集指定容器的资源情况。不带容器号，默认收集所有容器资源情况。例如：

python3 kbox_maintainer.py resource
python3 kbox_maintainer.py resource kbox_1

4.4.4 故障检查及恢复

Kbox_maintainer维护工具支持查看Kbox云手机容器的服务状态，用于云手机日常的巡检和恢复，请参考表 1 Kbox_maintainer故障检查及恢复。

表 1 Kbox_maintainer故障检查及恢复

Kbox_maintainer维护工具提供check命令字段，可通过容器号或容器名参数，检查指定容器的服务状态。不带容器号，默认检查所有容器状态。例如：

python3 kbox_maintainer.py check
python3 kbox_maintainer.py check kbox_1

Kbox_maintainer维护工具提供recover命令字段，可通过容器号或容器名参数，恢复指定容器的服务状态。不带容器号，默认恢复所有容器状态。例如：

python3 kbox_maintainer.py recover
python3 kbox_maintainer.py recover kbox_1

5 高危操作

5.1 禁用操作一览表

暂无，如有疑问，请联系华为技术支持。

5.2 高危操作一览表

风险操作由低到高等级划分如下：

• Minor：操作本身不会修改特性配置，但可能导致用户自定义的关键数据丢失的操作。
• Major：操作可能导致被管资源脱管或节点上承载的部分业务中断。
• Critical：操作可能导致全网大量业务中断。

服务器的硬件高危操作请参见表 1 硬件类高危操作，软件类高危操作请参见表 2 软件类高危操作。

表 1 硬件类高危操作

表 2 软件类高危操作

6 日常运维

6.1 Docker信息查询

表 1 Docker信息查询

6.2 Android信息查询

表 1 Android信息查询

6.3 服务器信息查询

表 1 服务器信息查询

6.4 支持Android系统属性可定制

Kbox容器支持根据客户需求定制系统属性，以覆盖原有系统属性。如需使用定制属性，需要在启动路径中生成local.prop文件，文件内记录定制的系统属性参数和值，容器启动后的初始化过程会读取该文件内的属性并覆盖写入。local.prop文件格式如下所示：

ro.product.board=HUAWEI
ro.product.brand=HUAWEI
ro.product.manufacturer=Huawei
ro.product.model=Huawei
ro.product.odm.brand=HUAWEI
ro.product.odm.manufacturer=Huawei
ro.product.odm.model=Huawei
ro.product.product.brand=HUAWEI
ro.product.product.manufacturer=Huawei
ro.product.product.model=Huawei
ro.product.system.brand=HUAWEI
ro.product.system.manufacturer=Huawei
ro.product.system.model=Huawei
ro.product.system_ext.brand=HUAWEI
ro.product.system_ext.manufacturer=Huawei
ro.product.vendor.brand=HUAWEI
ro.product.vendor.manufacturer=Huawei
ro.product.vendor.model=Huawei
ro.product.vendor.name=Huawei_arm64

Kbox容器启动过程中，会将启动路径中的local.prop文件推入到容器内的“/data”目录下，初始化过程会读取该文件的每一条定制属性覆盖写入该文件内的属性。

Kbox容器内查询定制属性方法，以查询ro.product.system_ext.brand为例， index为kbox容器号：

docker exec -it kbox_${index} getprop ro.product.system_ext.brand

7 参考信息

7.1 性能指标参考

表 1 Kbox云手机容器性能指标参考