45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
# Argus Metric 客户端安装指南（容器内普通用户场景）
|
||
|
||
## 准备与连通性检查
|
||
- FTP 连接（需要账号密码，默认 `ftpuser / ZGClab1234!`）
|
||
- `curl -u ftpuser:ZGClab1234! -I ftp://<FTP_IP>:21/LATEST_VERSION`
|
||
- `curl -u ftpuser:ZGClab1234! -s ftp://<FTP_IP>:21/ | head`
|
||
- 下载安装脚本
|
||
- `curl -u ftpuser:ZGClab1234! -fsSL ftp://<FTP_IP>:21/setup.sh -o /tmp/setup.sh`
|
||
- `chmod +x /tmp/setup.sh`
|
||
|
||
## 元数据与主机名
|
||
- Agent 需要元数据（env/user/instance）与 Master 地址：
|
||
- 方式A：hostname 形如 `env-user-instance-xxx`（推荐）
|
||
- 方式B：导出环境变量：
|
||
- `export AGENT_ENV=dev`
|
||
- `export AGENT_USER=<your_user>`
|
||
- `export AGENT_INSTANCE=<node_id>`
|
||
- Master 地址：
|
||
- `export MASTER_ENDPOINT=http://master.argus.com:3000`
|
||
|
||
> 安装脚本会在开头检查上述条件，缺失时会终止并给出修复提示。
|
||
|
||
## 执行安装
|
||
- 以 root 运行（容器内如为非 root 用户请切换为 root）：
|
||
- `sudo /tmp/setup.sh --server <FTP_IP> --user ftpuser --password 'ZGClab1234!' --port 21`
|
||
- 如需自定义安装根目录：`--install-dir /opt/argus-metric`
|
||
|
||
提示（容器接入 overlay 网络时）：
|
||
- 在执行 setup 前，先将容器内 DNS 指向 Bind9 的 overlay IP：
|
||
- `echo "nameserver <BIND_OVERLAY_IP>" > /etc/resolv.conf`
|
||
- 这样 `master.argus.com`、`es.log.argus.com` 等域名即可解析；首次下载 `setup.sh` 仍建议使用 FTP 的 overlay IP。
|
||
|
||
更多快速步骤请参考：`QUICK_NODE_DEPLOY_zh.md`。
|
||
|
||
## 安装后自检（setup 自动执行）
|
||
- setup 会等待最多 5 分钟，确认以下条件后才报告完成：
|
||
- `/private/argus/agent/<hostname>/node.json` 已生成；
|
||
- `last_report` 在持续更新；
|
||
- `health.metric-argus-agent|metric-node-exporter|metric-fluent-bit|metric-dcgm-exporter` 均为 `healthy` 且 `error` 为空。
|
||
|
||
## 手工验证（可选）
|
||
- `cat /private/argus/agent/$(hostname)/node.json | jq '.'`
|
||
- `curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9100/metrics` 应为 200
|
||
- 查看日志：`/var/log/argus-agent.log`、`/opt/argus-metric/versions/*/.install.log`
|