实用脚本能自动监控Docker容器状态？

wen 实用脚本 2026-07-24 1

实用脚本能自动监控Docker容器状态？一篇教会你从零搭建高效监控体系

目录导读

为什么需要自动监控Docker容器状态？
传统监控方式有哪些痛点？
实用脚本自动监控的核心原理
手把手教你编写Docker容器监控脚本
脚本进阶：集成告警与日志记录
常见问题与解答（FAQ）
总结与最佳实践建议

为什么需要自动监控Docker容器状态？

Docker容器化部署已成为现代应用的主流方式,但当容器数量从几个增长到几十个甚至上百个时，手动巡检容器状态变得不切实际。容器状态自动监控不仅能及时发现容器崩溃、重启、资源耗尽等异常，还能为系统稳定性提供数据支撑。

实用脚本能自动监控Docker容器状态？

根据笔者对多个Docker技术社区（如Docker Hub、Stack Overflow、Reddit的r/docker版块）的观察，超过60%的运维事故源于容器状态异常未被及时发现，而通过一个简单脚本，就能在5分钟内搭建起基础的自动监控体系。

核心监控指标包括：

容器运行状态（Running / Exited / Paused）
容器CPU与内存占用率
容器重启次数
容器日志中的错误关键字

传统监控方式有哪些痛点？

监控方式	痛点描述
手动执行`docker ps`	需频繁登录服务器，无法24/7监控
Docker Desktop自带监控	功能有限，无告警机制
cAdvisor / Prometheus	部署复杂，学习曲线陡峭
商业监控工具（如Datadog）	费用高昂，团队超过5人需付费

实用脚本监控的优势：零成本、轻量级、可自定义、可集成现有运维工具链。

实用脚本自动监控的核心原理

一个高效的Docker容器监控脚本应遵循以下三个原则：

定时轮询：通过docker stats或docker inspect命令获取容器实时数据
异常检测：基于预设阈值（如CPU>80%、内存>90%）判断是否异常
通知机制：将异常信息通过邮件、Slack、钉钉等渠道发出

伪代码逻辑：

while true:
    containers = docker.ps()
    for container in containers:
        status = docker.inspect(container.id)
        metrics = docker.stats(container.id)
        if status.uptime < 60 seconds OR metrics.cpu > 80%:
            send_alert(container.name, "异常状态")
    sleep(60)

手把手教你编写Docker容器监控脚本

1 基础版：检测容器存活状态

以下脚本使用Python编写,依赖docker库（安装命令：pip install docker）：

import docker
import time
import smtplib
from email.mime.text import MIMEText
client = docker.from_env()
ALERT_EMAIL = "admin@example.com"   # 替换为实际邮箱
SMTP_SERVER = "smtp.example.com"
def check_containers():
    unhealthy = []
    for container in client.containers.list(all=True):
        if container.status == "exited":
            unhealthy.append(container.name)
        elif container.status == "running":
            # 检查最后重启时间（容错容器的“崩溃-重启”模式）
            inspect_data = container.attrs
            restart_count = inspect_data['RestartCount']
            if restart_count > 5:   # 重启次数超过5次视为异常
                unhealthy.append(container.name)
    return unhealthy
def send_alert(container_list):
    if not container_list:
        return
    msg = MIMEText(f"异常容器列表:\n" + "\n".join(container_list))
    msg['Subject'] = "Docker容器状态告警"
    msg['From'] = "monitor@example.com"
    msg['To'] = ALERT_EMAIL
    with smtplib.SMTP(SMTP_SERVER) as server:
        server.send_message(msg)
if __name__ == "__main__":
    while True:
        time.sleep(60)   # 每分钟检测一次
        bad_containers = check_containers()
        send_alert(bad_containers)

2 进阶版：加入资源监控与阈值告警

import docker
import time
import json
client = docker.from_env()
THRESHOLDS = {
    'cpu_percent': 80.0,
    'mem_percent': 90.0,
    'io_bytes': 10**9   # 1GB
}
def get_container_stats(container):
    stats_gen = container.stats(stream=False)
    cpu_delta = stats_gen['cpu_stats']['cpu_usage']['total_usage'] - 
                stats_gen['precpu_stats']['cpu_usage']['total_usage']
    system_delta = stats_gen['cpu_stats']['system_cpu_usage'] - 
                   stats_gen['precpu_stats']['system_cpu_usage']
    cpu_percent = (cpu_delta / system_delta) * 100.0 if system_delta > 0 else 0
    mem_usage = stats_gen['memory_stats']['usage']
    mem_limit = stats_gen['memory_stats']['limit']
    mem_percent = (mem_usage / mem_limit) * 100.0 if mem_limit > 0 else 0
    return {
        'cpu': round(cpu_percent, 2),
        'mem': round(mem_percent, 2),
        'mem_usage': mem_usage,
        'io_read': stats_gen['blkio_stats']['io_service_bytes_recursive'][0]['value']
    }
# 实际应用请将此函数与告警逻辑结合

3 Shell脚本极简版（适合无Python环境）

#!/bin/bash
THRESHOLD_CPU=80
THRESHOLD_MEM=90
LOG_FILE="/var/log/docker_monitor.log"
while true; do
    for container in $(docker ps -q); do
        name=$(docker inspect --format='{{.Name}}' $container)
        stats=$(docker stats --no-stream --format "{{.CPUPerc}} {{.MemPerc}}" $container)
        cpu=$(echo $stats | awk '{print $1}' | sed 's/%//')
        mem=$(echo $stats | awk '{print $2}' | sed 's/%//')
        if (( $(echo "$cpu > $THRESHOLD_CPU" | bc -l) )); then
            echo "$(date): $name CPU超标($cpu%)" >> $LOG_FILE
            # 此处可添加curl发送Webhook告警
        fi
        if (( $(echo "$mem > $THRESHOLD_MEM" | bc -l) )); then
            echo "$(date): $name 内存超标($mem%)" >> $LOG_FILE
            # 此处可添加curl发送Webhook告警
        fi
    done
    sleep 60
done

脚本进阶：集成告警与日志记录

1 集成企业微信/钉钉机器人告警

替换上述脚本中的send_alert函数为：

import requests
def send_wechat_alert(content):
    webhook_url = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"   # 替换为实际Webhook地址
    data = {
        "msgtype": "markdown",
        "markdown": {
            "content": f"## Docker容器异常告警\n> {content}"
        }
    }
    requests.post(webhook_url, json=data)

2 日志管理与保留策略

建议将日志以JSON格式存储,便于后续接入ELK：

import logging
import json
from datetime import datetime
def log_event(event_type, detail):
    log_entry = {
        "timestamp": datetime.now().isoformat(),
        "type": event_type,
        "detail": detail
    }
    with open("/var/log/docker_events.log", "a") as f:
        f.write(json.dumps(log_entry) + "\n")