20260701 installer接入RTR监控目录

deploy/arm64-installer/docs/README.en.md

@@ -43,6 +43,7 @@ Defaults:
 - `METRICS_PLATFORM=__PACKAGE_PLATFORM__`
 - `MONITOR_PLATFORM=__PACKAGE_PLATFORM__`
 - `ALLOW_CROSS_ARCH=0`
+- `RTR_REPORT_DIR=__HOST_DATA_DIR__/empty-rtr-report`, which mounts an empty fallback directory by default; set it to a real host directory such as `/root/rpki/report` to ingest reports from a separately deployed RTR service
 
 ## First Start Semantics
 
@@ -89,6 +90,17 @@ GRAFANA_ADMIN_PASSWORD=admin
 
 Change the password and restrict public access for production deployments.
 
+## Optional RTR report metrics input
+
+If a separately deployed RTR service on the same host continuously writes `rtr-source-*`, `rtr-runtime-*`, and `rtr-clients-*` JSON reports, configure:
+
+```bash
+RTR_REPORT_DIR=/root/rpki/report
+RTR_REPORT_CONTAINER_DIR=/var/lib/ours-rp/rtr-report
+```
+
+The `artifact-metrics` container mounts the host directory read-only and reads it through `RPKI_METRICS_RTR_REPORT_DIR`, producing `ours_rp_rtr_*` metrics. By default, `RTR_REPORT_DIR` points at an empty fallback directory under the installer data root, so the metrics container also starts cleanly without an RTR service.
+
 ## Data Directory
 
 Default host directory:

deploy/arm64-installer/docs/README.zh-CN.md

@@ -43,6 +43,7 @@ vim .env
 - `METRICS_PLATFORM=__PACKAGE_PLATFORM__`
 - `MONITOR_PLATFORM=__PACKAGE_PLATFORM__`
 - `ALLOW_CROSS_ARCH=0`
+- `RTR_REPORT_DIR=__HOST_DATA_DIR__/empty-rtr-report`，默认挂载空目录；如需接入独立 RTR 服务 report，可设置为宿主机真实目录，例如 `/root/rpki/report`
 
 ## 首次启动语义
 
@@ -89,6 +90,17 @@ GRAFANA_ADMIN_PASSWORD=admin
 
 生产部署时应修改密码并限制外部访问。
 
+## 可选 RTR report 监控接入
+
+如果同一台机器上已经有独立部署的 RTR 服务，并且它持续输出 `rtr-source-*`、`rtr-runtime-*`、`rtr-clients-*` JSON report，可在 `.env` 中配置：
+
+```bash
+RTR_REPORT_DIR=/root/rpki/report
+RTR_REPORT_CONTAINER_DIR=/var/lib/ours-rp/rtr-report
+```
+
+`artifact-metrics` 容器会以只读方式挂载该目录，并通过 `RPKI_METRICS_RTR_REPORT_DIR` 读取 report，输出 `ours_rp_rtr_*` 指标。默认 `RTR_REPORT_DIR` 指向安装包数据目录下的空 fallback 目录，因此未接入 RTR 服务时 metrics 容器也能稳定启动。
+
 ## 数据目录
 
 默认宿主机目录：

deploy/arm64-installer/docs/operations.en.md

@@ -67,6 +67,14 @@ Important checks:
 - `allow_cross_arch`
 - `periodic_snapshot_reset`
 - `periodic_snapshot_max_deltas`
+- `rtr_report_dir`
+- `rtr_report_container_dir`
+
+To verify RTR report ingestion:
+
+```bash
+curl -s "http://127.0.0.1:${METRICS_PORT:-9556}/metrics" | grep '^ours_rp_rtr_' | head
+```
 
 ## Upgrade
 

deploy/arm64-installer/docs/operations.zh-CN.md

@@ -67,6 +67,14 @@ ALLOW_CROSS_ARCH=1
 - `allow_cross_arch`
 - `periodic_snapshot_reset`
 - `periodic_snapshot_max_deltas`
+- `rtr_report_dir`
+- `rtr_report_container_dir`
+
+如需确认 RTR report 已接入：
+
+```bash
+curl -s "http://127.0.0.1:${METRICS_PORT:-9556}/metrics" | grep '^ours_rp_rtr_' | head
+```
 
 ## 升级
 

deploy/arm64-installer/docs/troubleshooting.en.md

@@ -53,6 +53,22 @@ docker run --rm --platform __PACKAGE_PLATFORM__ \
   /opt/ours-rp/bin/rpki_artifact_metrics --help
 ```
 
+## RTR report metrics are empty
+
+Check `.env`:
+
+```bash
+grep '^RTR_REPORT_DIR=' .env
+test -d "$(grep '^RTR_REPORT_DIR=' .env | cut -d= -f2-)" && echo ok
+```
+
+Check the metrics container mount:
+
+```bash
+docker inspect "$(grep '^COMPOSE_PROJECT_NAME=' .env | cut -d= -f2-)-artifact-metrics" \
+  | jq '.[0].Mounts[] | select(.Destination=="/var/lib/ours-rp/rtr-report")'
+```
+
 ## First Snapshot Times Out
 
 All-five snapshot can be slow, especially under QEMU. Increase timeout:

deploy/arm64-installer/docs/troubleshooting.zh-CN.md

@@ -53,6 +53,22 @@ docker run --rm --platform __PACKAGE_PLATFORM__ \
   /opt/ours-rp/bin/rpki_artifact_metrics --help
 ```
 
+## RTR report 指标为空
+
+检查 `.env`：
+
+```bash
+grep '^RTR_REPORT_DIR=' .env
+test -d "$(grep '^RTR_REPORT_DIR=' .env | cut -d= -f2-)" && echo ok
+```
+
+检查 metrics 容器是否挂载该目录：
+
+```bash
+docker inspect "$(grep '^COMPOSE_PROJECT_NAME=' .env | cut -d= -f2-)-artifact-metrics" \
+  | jq '.[0].Mounts[] | select(.Destination=="/var/lib/ours-rp/rtr-report")'
+```
+
 ## 首轮 snapshot 超时
 
 all5 snapshot 可能很慢，尤其在 QEMU 环境。可以提高超时：