{"id":24272439,"url":"https://github.com/kobeep/docker_container_monitor","last_synced_at":"2026-04-13T05:46:27.882Z","repository":{"id":272476390,"uuid":"916701820","full_name":"Kobeep/Docker_Container_monitor","owner":"Kobeep","description":"Docker_Container_monitor is a lightweight CLI tool written in Go that helps monitor running Docker containers and their services.","archived":false,"fork":false,"pushed_at":"2025-02-27T20:34:47.000Z","size":176,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T05:22:32.348Z","etag":null,"topics":["containers","docker","docker-compose","go","golang","python","remote-monitoring"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kobeep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-14T15:55:32.000Z","updated_at":"2025-02-24T20:50:25.000Z","dependencies_parsed_at":"2025-01-14T18:34:16.516Z","dependency_job_id":"57846d14-b81e-4abc-ab32-fe0152697af3","html_url":"https://github.com/Kobeep/Docker_Container_monitor","commit_stats":null,"previous_names":["kobeep/docker_container_monitor"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kobeep%2FDocker_Container_monitor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kobeep%2FDocker_Container_monitor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kobeep%2FDocker_Container_monitor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kobeep%2FDocker_Container_monitor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kobeep","download_url":"https://codeload.github.com/Kobeep/Docker_Container_monitor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241977496,"owners_count":20051832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containers","docker","docker-compose","go","golang","python","remote-monitoring"],"created_at":"2025-01-15T18:26:27.674Z","updated_at":"2025-12-31T00:57:05.071Z","avatar_url":"https://github.com/Kobeep.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Container Monitor 🚀\n\n[![CI Status](https://github.com/Kobeep/Docker_Container_monitor/actions/workflows/CI.yml/badge.svg)](https://github.com/Kobeep/Docker_Container_monitor/actions)\n\nDocker Container Monitor is a lightweight CLI tool written in Go that monitors running Docker containers and their services. It provides real-time information about container states, checks service availability, and even supports remote monitoring via SSH. The project also includes a Python installer script for an automated setup.\n\n---\n\n## Table of Contents\n\n- [Docker Container Monitor 🚀](#docker-container-monitor-)\n  - [Table of Contents](#table-of-contents)\n  - [Overview](#overview)\n  - [Features](#features)\n  - [Installation](#installation)\n    - [Prerequisites](#prerequisites)\n    - [Steps to Install](#steps-to-install)\n  - [Usage](#usage)\n    - [Display full container and service status:](#display-full-container-and-service-status)\n    - [Display only container states:](#display-only-container-states)\n    - [Display only service availability:](#display-only-service-availability)\n    - [Monitor Docker containers on a remote host:](#monitor-docker-containers-on-a-remote-host)\n    - [Monitor Docker events in real time:](#monitor-docker-events-in-real-time)\n      - [For JSON output, use:](#for-json-output-use)\n    - [Check systemd service status:](#check-systemd-service-status)\n  - [How It Works](#how-it-works)\n  - [Uninstallation](#uninstallation)\n  - [Contributing](#contributing)\n  - [License](#license)\n  - [Author](#author)\n  - [GitHub](#github)\n\n---\n\n## Overview\n\n**Docker Container Monitor** is a powerful yet lightweight CLI tool designed to help you keep an eye on your Docker containers and the services running within them. With features ranging from automatic container detection to remote monitoring support via SSH, this tool makes it easy to ensure that your containerized applications are running smoothly.\n\n---\n\n## Features\n\n- ✅ **Automatic container detection**\n  No manual container naming needed.\n- ✅ **Service health check**\n  Automatically verifies the accessibility of container services.\n- ✅ **Remote monitoring support**\n  Monitor containers on remote hosts over SSH.\n- ✅ **Real-time Docker events monitoring**\n  Subscribe to Docker events for dynamic updates.\n- ✅ **Multiple output modes**\n  Choose from full status, container state, service availability, or event monitoring displays.\n- ✅ **Simple CLI commands**\n  Use `monitor` for an instant overview.\n- ✅ **Systemd integration**\n  Run as a background service for continuous monitoring.\n- ✅ **Easy installation**\n  Fully automated setup with `install.py`.\n\n---\n\n## Installation\n\n### Prerequisites\n\n- 🐳 **Docker** installed and running.\n- 🐍 **Python 3** installed.\n- 🦫 **Go** installed (the installer will install it automatically if not present).\n- 🔑 **(Optional)** SSH access for remote monitoring:\n  - A configured `~/.ssh/config` file, or\n  - A private key for manual SSH authentication.\n\n### Steps to Install\n\n1. **Clone the repository:**\n\n  ```sh\n  git clone https://github.com/Kobeep/Docker_Container_monitor.git\n  cd Docker_Container_monitor\n  ```\n\n2. **Run the installation script:**\n\n```sh\npython3 install.py\n```\n\n3. **Verify installation:**\n\n```sh\nmonitor --help\n```\n\n## Usage\n### Display full container and service status:\n\n```sh\nmonitor\n```\n\n![monitor](./readme/monitor.png)\n\n### Display only container states:\n\n```sh\nmonitor state\n```\n\n![monitor](./readme/monitor-state.png)\n\n### Display only service availability:\n\n```sh\nmonitor service\n```\n\n![monitor](./readme/monitor-service.png)\n\n### Monitor Docker containers on a remote host:\n\n```sh\nmonitor remote --host \u003chostalias\u003e\n```\n\n### Monitor Docker events in real time:\n\n```sh\nmonitor events\n```\n\n#### For JSON output, use:\n\n```sh\nmonitor events --json\n```\n\n### Check systemd service status:\n\n```sh\nsystemctl status monitor\n```\n\n## How It Works\n\n🚀 **Retrieves a list of running Docker containers** using `docker ps`\n🔌 **Gets exposed ports** for each container\n🌐 **Attempts an HTTP request** to determine if the service inside the container is responsive\n🔔 **Subscribes to Docker events** for real-time monitoring.\n📊 **Displays results** based on the selected mode\n\n## Uninstallation\n\nTo remove the tool:\n```sh\nsudo systemctl stop monitor\nsudo systemctl disable monitor\nsudo rm /usr/local/bin/monitor\nsudo rm /etc/systemd/system/monitor.service\nrm -rf ~/Docker_Container_monitor\n```\n## Contributing\n\n💡 Contributions are welcome! Feel free to submit a pull request or open an issue.\n\n## License\n\n📜 This project is licensed under the `GNU GPL License`.\n\n## Author\n\n👨‍💻 **Author:** Jakub Pospieszny\n\n## GitHub\n\n📌 **GitHub:** [Kobeep](https://github.com/Kobeep)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkobeep%2Fdocker_container_monitor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkobeep%2Fdocker_container_monitor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkobeep%2Fdocker_container_monitor/lists"}