命令行与文本处理 / 系统课时

生成统一的巡检结果文件

生成统一的巡检结果文件

零散的终端输出不利于归档,也无法方便地比较两次巡检差异。本节把各检查命令统一收集到一份报告中,为报告补充生成时间、主机名和总体状态,并使用固定格式写入文件,便于定时任务保存和后续分析。

学习目标

  • 为巡检报告加入时间、主机和检查状态等基础元数据
  • 把多个检查函数的输出集中写入同一个结果文件
  • 使用退出码和固定文本格式生成既适合阅读、又适合脚本继续处理的报告

设计统一报告格式

报告只保留两类信息:顶部元数据和逐项检查结果。元数据描述“谁在什么时候生成了报告”,检查结果保持每行一个项目,后续可以直接用 grep、awk 或其他脚本解析。

示例格式如下:

text
inspection_time=<TIME>
hostname=<HOST>
overall_status=FAIL

SERVICE sshd OK
PORT 22 OK
PORT 80 FAIL
DISK / OK

<TIME> 和 <HOST> 是动态值,实际运行时会替换成当前时间和主机名。

编写报告生成脚本

下面示例同时检查两个服务、两个端口和根分区使用率。每个检查函数通过返回码表示成功或失败,主流程据此计算 overall_status,最后一次性写入目标文件。

bash
#!/usr/bin/env bash
set -u

report_file="${1:-inspection-report.txt}"
tmp_file="$(mktemp)"
trap 'rm -f "$tmp_file"' EXIT

overall_status="OK"

record_result() {
  local status="$1"
  shift
  printf '%s %s\n' "$*" "$status" >> "$tmp_file"
  if [[ "$status" != "OK" ]]; then
    overall_status="FAIL"
  fi
}

check_service() {
  local service="$1"
  if systemctl is-active --quiet "$service"; then
    record_result "OK" "SERVICE $service"
  else
    record_result "FAIL" "SERVICE $service"
  fi
}

check_port() {
  local port="$1"
  if ss -lntH | awk '{print $4}' | grep -Eq "(^|:)$port$"; then
    record_result "OK" "PORT $port"
  else
    record_result "FAIL" "PORT $port"
  fi
}

check_disk() {
  local mount_point="$1"
  local limit="$2"
  local usage

  usage="$(df -P "$mount_point" | awk 'NR==2 {gsub(/%/, "", $5); print $5}')"
  if [[ "$usage" =~ ^[0-9]+$ ]] && (( usage < limit )); then
    record_result "OK" "DISK $mount_point usage=${usage}%"
  else
    record_result "FAIL" "DISK $mount_point usage=${usage:-unknown}%"
  fi
}

check_service "sshd"
check_service "cron"
check_port "22"
check_port "80"
check_disk "/" "90"

{
  printf 'inspection_time=%s\n' "$(date '+%Y-%m-%dT%H:%M:%S%z')"
  printf 'hostname=%s\n' "$(hostname)"
  printf 'overall_status=%s\n' "$overall_status"
  printf '\n'
  cat "$tmp_file"
} > "$report_file"

printf 'report=%s status=%s\n' "$report_file" "$overall_status"

运行脚本:

bash
chmod +x generate-report.sh
./generate-report.sh inspection-report.txt

预期输出示例:

text
report=inspection-report.txt status=FAIL

如果所有项目都正常,status 会是 OK;任意一项失败则为 FAIL。结果取决于当前主机状态。

检查生成的报告

使用 cat 查看文件内容:

bash
cat inspection-report.txt

预期结果示例:

text
inspection_time=<TIME>
hostname=<HOST>
overall_status=FAIL

SERVICE sshd OK
SERVICE cron OK
PORT 22 OK
PORT 80 FAIL
DISK / usage=41% OK

其中 <TIME>、<HOST> 和磁盘使用率都是动态值,实际输出会不同。报告中每个检查项占一行,因此既适合人工阅读,也方便后续按 FAIL 过滤。

为归档保留唯一文件名

定时巡检不应每次覆盖同一个文件。可以在调用脚本时把时间戳放入文件名:

bash
mkdir -p reports
./generate-report.sh "reports/inspection-$(date '+%Y%m%d-%H%M%S').txt"

预期结果示例:

text
report=reports/inspection-<TIME>.txt status=FAIL

这里 <TIME> 代表实际文件名中的时间戳。归档目录应由定时任务提前创建,并根据磁盘容量设置保留周期,避免长期运行后报告文件无限增长。

统一报告的关键不是追求复杂格式,而是保证字段固定、检查项一行一个、总体状态可快速判断。这样后续无论做历史对比、压缩归档还是发送告警,都可以直接复用同一份结果文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

生成统一的巡检结果文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通