{"id":25919707,"url":"https://github.com/antonioscardace/netwatch","last_synced_at":"2026-04-06T21:31:27.244Z","repository":{"id":280343822,"uuid":"941686533","full_name":"antonioscardace/NetWatch","owner":"antonioscardace","description":"Service to Check Local Utilities Health and Alert Their Owners.","archived":false,"fork":false,"pushed_at":"2025-03-02T21:55:29.000Z","size":0,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-02T22:18:20.698Z","etag":null,"topics":["api-gateway","docker","health-check","hibernate-jpa","microservices","rabbitmq","redis","rest-api","slack-api","spring-boot","telegram-api"],"latest_commit_sha":null,"homepage":"","language":"Java","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/antonioscardace.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-02T21:24:56.000Z","updated_at":"2025-03-02T21:55:32.000Z","dependencies_parsed_at":"2025-03-02T22:18:25.516Z","dependency_job_id":"75eb84df-a098-480c-8af7-03afcce5c3ef","html_url":"https://github.com/antonioscardace/NetWatch","commit_stats":null,"previous_names":["antonioscardace/netwatch"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonioscardace%2FNetWatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonioscardace%2FNetWatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonioscardace%2FNetWatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonioscardace%2FNetWatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/antonioscardace","download_url":"https://codeload.github.com/antonioscardace/NetWatch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241686830,"owners_count":20003112,"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":["api-gateway","docker","health-check","hibernate-jpa","microservices","rabbitmq","redis","rest-api","slack-api","spring-boot","telegram-api"],"created_at":"2025-03-03T15:15:51.600Z","updated_at":"2025-12-31T01:03:21.780Z","avatar_url":"https://github.com/antonioscardace.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NetWatch • Utilities Health Monitor\n\n[![CodeFactor](https://www.codefactor.io/repository/github/antonioscardace/netwatch/badge)](https://www.codefactor.io/repository/github/antonioscardace/netwatch)\n[![License](https://img.shields.io/github/license/antonioscardace/netwatch.svg)](https://github.com/antonioscardace/netwatch/blob/master/LICENSE)\n[![Open Issues](https://img.shields.io/github/issues/antonioscardace/netwatch.svg)](https://github.com/antonioscardace/netwatch/issues)\n[![CI for Testing](https://github.com/antonioscardace/NetWatch/actions/workflows/ci-test.yml/badge.svg)](https://github.com/antonioscardace/NetWatch/actions/workflows/ci-test.yml)\n\nThe project is a health checker. It aims to check in real-time the health of each observed local utility.\u003cbr/\u003e\nThe utility can be a Docker Container, a Machine, or a Network Device in your local network.\u003cbr/\u003e\nThe monitor notifies the utility referent if it changes its state (i.e. **goes offline** or **comes back online**).\u003cbr/\u003e\nThe alert can be a Slack message, an Email, or a Telegram message like these:\n\n\u003cimg src=\"/docs/snaps/telegram.png\" alt=\"Telegram\" width=\"500px\"/\u003e\n\u003cimg src=\"/docs/snaps/email-online.png\" alt=\"Telegram\" width=\"500px\"/\u003e\n\nAn accurate report can be found in [/docs/report.pdf](/docs/report.pdf)\u003cbr/\u003e\nThis project was created as an exam project to test a set of skills, including:\n\n+ Knowledge of Microservices \n+ Knowledge of Design Patterns\n+ Knowledge of Java, Maven, and Spring Boot\n+ Knowledge of Messaging Systems (RabbitMQ) and their Patterns\n+ Knowledge of Git \u0026 GitHub\n\nI also had the opportunity to practice the following skills:\n+ Knowledge of ORMs (Hibernate)\n+ Knowledge of Redis\n+ Use of the Static Analysis Tools (CodeFactor, Snyk Code, and Sonar Qube)\n\n## System Infrastructure\n\nEach microservice is contained in a Docker Container.\u003cbr/\u003e\nThe only reachable containers in the Docker Network are Frontend, API Gateway, and Grafana.\u003cbr/\u003e\nThe UML of the internal structure of each microservice is stored in [/docs/uml/](/docs/uml/)\u003cbr/\u003e\n\n\u003cimg src=\"/docs/images/infrastructure.svg\" alt=\"Infrastructure\"/\u003e\n\nMain Notes:\n\n- _RabbitMQ_ provides an Exchange implementing the Publish-Subscribe Design Pattern.\n- The HTTP connection between _Monitor_ and _Data Manager_ is a Keep-Alive (persistent) connection.\n- _Monitor_ implements the Factory-Method Design Pattern for the _request_ module.\n- _Notification_ implements the Factory-Method Design Pattern for the _sender_ module.\n\n## Getting Started\n\n* Get any set of valid credentials or tokens (e.g. for Telegram) to send notifications.\n* Download and install [Docker](https://docs.docker.com/get-docker/).\n\n```sh\n   $ git clone https://github.com/antonioscardace/NetWatch.git\n   $ cd YOUR_PATH/NetWatch/\n   $ bash run.sh\n``` \n\n### Useful Links\n\nContainer | URL | Description\n----- | ------- | -------\ngrafana-charts | [https://localhost:8800/](https://localhost:8800/d/2xZ6SccSz/netwatch-logs?orgId=1\u0026refresh=5s\u0026from=now-24h\u0026to=now) | Grafana Logs\nrabbitmq | http://localhost:15672/ | RabbitMQ UI\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonioscardace%2Fnetwatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantonioscardace%2Fnetwatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonioscardace%2Fnetwatch/lists"}