Skip to main content

🛡️ DockWatch - Docker container monitoring and image analysis cli tool.

Project description

License: MIT

🛡️ DockWatch

Docker container monitoring and image analysis CLI tool


🚀 Overview

DockWatch is a powerful yet beginner-friendly CLI tool to monitor your Docker containers, analyze crashes, and inspect Docker image layers for optimization. It provides real-time alerts for container status changes, crash analysis with clear explanations, and an interactive Dockerfile creator to help you build optimized images.


Features

  • 🛡️ Real-time container monitoring: Track container status changes (running, exited, created) with easy-to-understand alerts.
  • 💥 Crash analysis: Detect container crashes with clear explanations based on exit codes and logs.
  • 📊 Docker image analyzer: Inspect image layers for size and bloat, with smart tips for optimization.
  • 🐳 Multi-runtime support: Works well with Node.js, Python, Go, Java, Ruby, PHP, and .NET images.
  • 🔧 Dockerfile Creator: Interactive session to generate optimized single-stage or multi-stage Dockerfiles for various runtimes.
  • 🎨 Beautiful, color-coded console output powered by Rich.

Installation

You can install DockWatch directly from PyPI:

pip install dockwatch

Usage

Monitor containers

Monitor running containers by name:

dockwatch monitor [container1] [container2] ...

Add the --show-logs or -l flag to show logs on crashes:

dockwatch monitor backend frontend --show-logs

Analyze Docker images

Analyze a local Docker image to identify large layers and optimize size:

dockwatch analyze [my-image:latest]

Create Dockerfiles interactively

Generate Dockerfiles with guided prompts (supports multi-stage builds):

dockwatch create

Supported Runtimes

  • Node.js
  • Python
  • Go
  • Java
  • Ruby
  • PHP
  • .NET Core

Examples

# Monitor containers
dockwatch monitor backend --show-logs

# Analyze image layers
dockwatch analyze node:18-alpine

# Create Dockerfile
dockwatch create

Contributing

Contributions and issues are welcome! Feel free to open a pull request or issue on GitHub.

License

This project is licensed under the MIT License.

Contact

For questions or support, email: bsse1402@iit.du.ac.bd

Project details


Release history Release notifications | RSS feed

This version

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dockwatch-1.0.tar.gz (10.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dockwatch-1.0-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file dockwatch-1.0.tar.gz.

File metadata

  • Download URL: dockwatch-1.0.tar.gz
  • Upload date:
  • Size: 10.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for dockwatch-1.0.tar.gz
Algorithm Hash digest
SHA256 33d0e908245ddde8c918f00b163a124b8201cd3532015658d395584632d47d40
MD5 a5d7ec3e26980e575d63d242a46ea2d3
BLAKE2b-256 94253d853617ba988dcb74e8873a7fe59ef64f6868382f5b41615c1147a672f6

See more details on using hashes here.

File details

Details for the file dockwatch-1.0-py3-none-any.whl.

File metadata

  • Download URL: dockwatch-1.0-py3-none-any.whl
  • Upload date:
  • Size: 10.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for dockwatch-1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eef13a7ff9f035f8e463b283218684e1aa007ad4492a5eb6a9c40c8dae4a7a08
MD5 b4f5990c449747062868713096dc959f
BLAKE2b-256 b2b1c67eb123d8d8f165c94301b4928fe6f812fab145776fe1e786c344925d7f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page