怎么利用 Docker API 编写自动化脚本批量提取容器运行时长

胖枫小哥_6088

胖枫小哥_6088

2026-06-23

258人浏览

原创

直接调用 Docker API 获取容器运行时长最可靠轻量,通过 /containers/{id}/json 接口读取 Created 时间戳并与当前时间差值计算;推荐用 curl --unix-socket 或 Python requests + dateutil.parser 解析 ISO 8601 时间,支持批量处理。

直接调用 docker api 获取容器运行时长,比进容器装 psutil 或解析日志更可靠、更轻量,也更适合批量操作。核心思路是:通过 /containers/{id}/json 接口拿到容器的 created 时间戳,再与当前时间做差,即可算出已运行时长。

获取容器创建时间并计算运行时长

Docker 守护进程的 REST API 返回的 JSON 中,Created 字段是 ISO 8601 格式的时间字符串(如 "2026-06-15T09:23:41.123456789Z"),代表容器创建时刻。只要知道当前系统时间,就能准确推算出运行了多久。

  • API 地址为 http://localhost/containers/{container_id}/json,需通过 Unix socket 或 TCP 访问(默认监听 unix:///var/run/docker.sock
  • 推荐使用 curl --unix-socket 直接调用,无需额外开启 TCP 端口,更安全
  • Python 中可用 requests + dateutil.parser 解析时间,避免手动处理时区和纳秒精度

Python 脚本示例:批量提取所有容器运行时长

以下脚本一次性获取全部容器(无论状态)的创建时间,并输出格式化后的运行时长:

#!/usr/bin/env python3
import requests
import json
from datetime import datetime
from dateutil import parser
import sys
<p>SOCKET_PATH = "/var/run/docker.sock"</p><p>def get_container_list():
r = requests.get(f"<a href="https://www.php.cn/link/79c3489e2392afd26733d285dee3abd0">https://www.php.cn/link/79c3489e2392afd26733d285dee3abd0</a>",
unix_socket=SOCKET_PATH)
r.raise_for_status()
return r.json()</p><p>def get_container_info(cid):
r = requests.get(f"<a href="https://www.php.cn/link/f0547ecd4e64a31e247c34b64547f812">https://www.php.cn/link/f0547ecd4e64a31e247c34b64547f812</a>",
unix_socket=SOCKET_PATH)
r.raise_for_status()
return r.json()</p><p>def format_duration(seconds):
days, s = divmod(int(seconds), 86400)
hours, s = divmod(s, 3600)
mins, secs = divmod(s, 60)
if days > 0:
return f"{days}d {hours}h"
elif hours > 0:
return f"{hours}h {mins}m"
else:
return f"{mins}m {secs}s"</p><p>if <strong>name</strong> == "<strong>main</strong>":
containers = get_container_list()
now = datetime.now().astimezone()</p><pre class="brush:php;toolbar:false;">print(f"{'ID':12} {'NAME':20} {'STATUS':12} {'RUNTIME'}")
print("-" * 65)

for c in containers:
    cid = c["Id"][:12]
    name = c["Names"][0].lstrip("/")
    status = c["Status"]

    try:
        info = get_container_info(cid)
        created = parser.isoparse(info["Created"])
        runtime = now - created
        duration_str = format_duration(runtime.total_seconds())
    except Exception as e:
        duration_str = "N/A"

    print(f"{cid:12} {name:20} {status:12} {duration_str}")

python-docx
python-docx

python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能,主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践;生成安全服务方案文档;核心要点生成技术架构设计文档;生成任何需要专业排版的Word文档;核心库 : python-docx;使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns;标准代码模板;1. 文档初始化;2. 字体设置(必须!它将相关步骤、工具调用和结果整理方式集

下载

保存为 docker-runtime.py,确保当前用户有读取 /var/run/docker.sock 的权限(通常需加入 docker 用户组),然后运行:
python3 docker-runtime.py

Shell 版本:轻量快速,适合 CI 或定时任务

如果不想依赖 Python,纯 Bash 也能完成关键逻辑(借助 jqdate):

#!/bin/bash
# 需安装 jq:apt install jq / brew install jq
SOCKET="/var/run/docker.sock"
<p>echo "ID              NAME                 STATUS         RUNTIME"
echo "-----------------------------------------------------------"</p><p>docker ps -aq --format '{{.ID}} {{.Names}} {{.Status}}' | while read cid name status; do
name=${name#/}  # 去掉开头的 /
created=$(curl -s --unix-socket "$SOCKET" "<a href="https://www.php.cn/link/3e53ae683f8e8c84221db763b30fe907">https://www.php.cn/link/3e53ae683f8e8c84221db763b30fe907</a>" 2>/dev/null | jq -r '.Created' | cut -d'T' -f1)</p><p>if [[ -n "$created" && "$created" != "null" ]]; then</p><h1>粗略按天计算(跳过时分秒,避免 date 处理时区复杂性)</h1><pre class="brush:php;toolbar:false;">age_days=$(( ( $(date -d "$(date +%Y-%m-%d)" +%s) - $(date -d "$created" +%s) ) / 86400 ))
if [ $age_days -gt 0 ]; then
  runtime="${age_days}d"
else
  runtime="<p>else
runtime="N/A"
fi</p><p>printf "%-15s %-20s %-12s %s\n" "${cid:0:12}" "$name" "$status" "$runtime"
done
</p>

注意事项与优化点

  • 权限问题:脚本需能访问 /var/run/docker.sock。生产环境不建议直接赋权给普通用户,可考虑用 systemd socket 拦截或改用 Docker-in-Docker 方式隔离
  • 性能考虑:批量查上百个容器时,逐个请求 /json 接口会有延迟。如需极致性能,可先用 docker ps -a --format 获取 ID+状态+创建时间(部分版本支持 {{.CreatedAt}}),再只对关键容器查详细信息
  • 状态 vs 运行时长:已退出容器的 Created 时间仍有效,但“运行时长”应理解为“自创建至今”,而非“持续运行时长”。若需精确的**持续运行时间**(即排除重启间隔),需结合 State.StartedAt 字段
  • 健康检查补充:运行时长只是基础指标,搭配 State.Health.Status 可判断是否长期卡在 unhealthy 状态,用于自动告警

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

docker docker 容器 python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

625

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

4299

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5157

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

1913

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

199

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

371

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

340

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

245

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

365

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习