# 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`

## 安装后自检（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`