← Back to Skills Marketplace
67
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install laolaoqi-docker-health
Description
Monitor Docker container health: running status, CPU/memory usage, restart counts, and available image updates. Use when a user requests Docker health checks...
README (SKILL.md)
Docker Health Monitor
Script
scripts/docker-health.sh — the single entry point for all checks.
The script is self-contained and works on any system with Docker installed. It auto-detects the Docker socket availability and gracefully handles permission issues.
Quick Start
Run a full health report:
bash scripts/docker-health.sh --all
Or with no arguments (same as --all):
bash scripts/docker-health.sh
Individual Checks
Run any single check by name:
| Command | What it checks |
|---|---|
--status |
Lists all containers with their current status (running, stopped, paused, etc.) |
--resources |
Shows CPU and memory usage per container via docker stats |
--restarts |
Flags containers that have restarted more than 3 times |
--images |
Checks for available image updates by comparing local image digests with registry |
--full |
Runs all checks in sequence (same as --all) |
Example:
bash scripts/docker-health.sh --status --restarts
Full Audit Workflow
- Run
bash scripts/docker-health.sh --all - The script outputs a formatted report to stdout
- Key sections: container status summary, resource usage table, restart warnings, image update availability
Common Findings & Recommendations
- High restart counts (>3): Indicates container instability — check logs with
docker logs \x3Ccontainer>and review healthcheck configuration - High memory usage: Consider setting
--memorylimits in the container's run/stack config; check for memory leaks in the application - High CPU usage: Investigate application processes; consider CPU limits or horizontal scaling
- Outdated images: Run
docker pullto update images; consider automated update workflows (watchtower, renovate-bot) - Exited containers: Check exit codes — 0 means intentional stop, non-zero indicates errors
Notes
- Requires access to the Docker socket (
/var/run/docker.sock) — run as root or add user to thedockergroup --resourcesrunsdocker statsin non-streaming mode (one-shot per container) for quick snapshots--imageschecks are advisory — usesdocker inspectfor image digests and checks for newer versions; requires network access to the registry- Works with both local Docker and remote Docker contexts (DOCKER_HOST env var)
Usage Guidance
Install only if you want the agent to inspect Docker with Docker-socket-level privileges. Avoid --all or --images on production or remote Docker contexts unless you accept that the script may pull images and change the Docker image cache; use --status, --resources, or --restarts for read-only checks until the image-check behavior is clarified or fixed.
Capability Assessment
Purpose & Capability
Status, stats, and restart reporting are aligned with Docker health monitoring, but the image freshness check mutates Docker image state by pulling images rather than only reporting.
Instruction Scope
The default --all/no-argument workflow includes the image check, so a routine health report may perform network pulls without a separate approval step.
Install Mechanism
There is no automatic installer and the shell script is readable, but registry requirements do not declare the Docker dependency or Docker access capability.
Credentials
Docker daemon access, root/docker group use, and DOCKER_HOST remote contexts are disclosed and expected for monitoring, but they are high-privilege environments.
Persistence & Privilege
docker pull can persistently update the Docker image cache/tag on the selected daemon, including remote contexts, which exceeds a purely read-only health check.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install laolaoqi-docker-health - After installation, invoke the skill by name or use
/laolaoqi-docker-health - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
docker-health-monitor 1.0.0 initial release:
- Provides a single script (`docker-health.sh`) to monitor Docker container health.
- Supports checks for running status, CPU/memory usage, restart counts, and image updates.
- Offers both targeted checks (by flag) and a full health report.
- Handles Docker socket detection and permission issues gracefully.
- Outputs comprehensive, formatted reports to stdout.
Metadata
Frequently Asked Questions
What is Docker Health Monitor?
Monitor Docker container health: running status, CPU/memory usage, restart counts, and available image updates. Use when a user requests Docker health checks... It is an AI Agent Skill for Claude Code / OpenClaw, with 67 downloads so far.
How do I install Docker Health Monitor?
Run "/install laolaoqi-docker-health" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Docker Health Monitor free?
Yes, Docker Health Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Docker Health Monitor support?
Docker Health Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Docker Health Monitor?
It is built and maintained by new (@laolaoqi); the current version is v1.0.0.
More Skills