Skip to main content

快速开始

Last updated on

APO 分为两部分：

  • APO-server: APO 服务侧组件
  • APO-one-agent: APO 用户侧组件，用于采集Kubernetes集群或者虚机环境下被监控业务以及集群、主机信息。

本文档包含使用 Helm 在同一 Kubernetes 集群上安装和运行 APO-server 与 APO-one-agent 的说明。

warning

本文档仅供 POC 测试阶段快速部署使用，为非持久化配置，请勿在生产环境中使用。如需在生产环境中使用，推荐将 APO-server 安装在独立环境中，安装方式请参考安装 APO-server。

准备工作​

要使用 Helm 安装 APO，请确保已完成以下操作：

  • 准备 8核16G 的硬件资源，磁盘资源根据您的监控规模而定，最小不低于50G。
  • 在计算机上安装 Kubernetes 服务器。有关安装 Kubernetes 的信息，请参阅官方文档安装 Kubernetes。也可参考简化安装方式Sealos 部署 Kubernetes集群（需8核16G）。
  • 安装 Helm 的最新稳定版本。有关安装 Helm 的信息，请参阅安装 Helm。

设置 APO Helm 仓库​

要设置 APO Helm 存储库，以便在计算机上下载正确的 APO Helm charts，请完成以下步骤： 使用下方命令添加 apo Helm 仓库

helm repo add apo https://apo-charts.oss-cn-hangzhou.aliyuncs.com
helm repo update apo

部署 APO Helm charts​

运行以下命令，部署 APO-server 与 APO-one-agent。

helm install apo apo/apo -n apo --create-namespace \
--set apo-one-agent.enabled=true

配置： apo-one-agent 默认监控 apo 以及 kubernetes 系统组件以外的所有组件，更多配置参考如何配置Kubernetes环境OneAgent自动监控范围

warning

本文档仅供 POC 测试阶段快速部署使用，为非持久化配置，数据库组件重启会导致数据丢失或者服务崩溃；请勿在生产环境中使用。如需在生产环境中使用，推荐将 APO-server 安装在独立环境中，安装方式请参考安装 APO-server。

验证​

输入下方命令检查pod是否启动成功

kubectl get po -n apo
info

安装成功后需重启目标被监控服务！！！ 遇到问题：可以参考《常见问题》进一步排查，或者联系我们

访问 APO​

您可以通过以下方式访问 APO，其中 NodeIP 为集群中任意一个节点的 IP 地址。

  • APO 向导式可观测性平台地址：http://<NodeIP>:31364

apo-home-page

  • Grafana 地址：http://<NodeIP>:31364/#/system-dashboard

apo-grafana

DEMO 测试​

我们提供应用 DEMO，您可以使用一键安装命令帮助您验证 APO 系统的功能完整性。 详情请见：一键部署测试服务 Demo

更新与卸载​

更新 APO Helm charts 配置​

如果您的 APO 需要更新使用下方命令进行更新

helm upgrade apo apo/apo -n apo \
--set apo-one-agent.enabled=true

卸载 APO Helm charts​

kubectl delete clickhouseinstallation apo -napo
helm uninstall apo -n apo
kubectl delete ns apo

更多配置​

本文档提供的为 APO 部署的基础配置，如果您要进行更多配置更改，请从 APO Helm Charts 库中下载values.yaml文件：

helm show values apo/apo > values.yaml

更多安装方式​

部署 APO 社区版​

默认情况下，APO 会安装企业版，相比于社区版，企业版提供更多数据分析能力，区别请查阅版本区别。

通告

当前APO的企业版本功能正在免费公测中🔥！！！

如果需要也可以使用社区版本，要部署社区版本请在 Helm 仓库中搜索APPVERSON带ce结尾的 charts 版本号.

helm search repo apo -l

并在 Helm 安装的时候携带该版本参数

# 例如
helm install apo apo/apo -n apo --create-namespace \
--set apo-one-agent.enabled=true \
--version x.x.xxx