{"id":13478912,"url":"https://github.com/zalando/zmon","last_synced_at":"2025-03-27T08:31:09.393Z","repository":{"id":24727344,"uuid":"28139492","full_name":"zalando/zmon","owner":"zalando","description":"Real-time monitoring of critical metrics \u0026 KPIs via elegant dashboards, Grafana3 visualizations \u0026 more","archived":false,"fork":false,"pushed_at":"2024-06-28T12:31:09.000Z","size":5798,"stargazers_count":359,"open_issues_count":8,"forks_count":47,"subscribers_count":64,"default_branch":"master","last_synced_at":"2025-03-03T05:04:30.850Z","etag":null,"topics":["metrics","monitoring"],"latest_commit_sha":null,"homepage":"https://demo.zmon.io/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zalando.png","metadata":{"files":{"readme":"README.rst","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":"2014-12-17T13:59:06.000Z","updated_at":"2024-08-22T02:53:18.000Z","dependencies_parsed_at":"2024-10-30T12:44:08.252Z","dependency_job_id":null,"html_url":"https://github.com/zalando/zmon","commit_stats":{"total_commits":231,"total_committers":13,"mean_commits":17.76923076923077,"dds":0.5844155844155844,"last_synced_commit":"2b3652fa0e77e214d27948db5bdae45fdb345571"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzmon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzmon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzmon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zalando%2Fzmon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zalando","download_url":"https://codeload.github.com/zalando/zmon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245809778,"owners_count":20676052,"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":["metrics","monitoring"],"created_at":"2024-07-31T16:02:05.699Z","updated_at":"2025-03-27T08:31:08.815Z","avatar_url":"https://github.com/zalando.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"**ZMON source code on GitHub is no longer in active development. Zalando will no longer actively review issues or merge pull-requests.**\n\nZMON is still being used at Zalando and serves us well for many purposes. We are now deeper into our observability journey and understand better that we need other telemetry sources and tools to elevate our understanding of the systems we operate. We support the `OpenTelemetry \u003chttps://opentelemetry.io/\u003e`_ initiative and recommended others starting their journey to begin there.\n\nIf members of the community are interested in continuing developing ZMON, consider forking it. Please review the licence before you do.\n\n\n.. image:: https://readthedocs.org/projects/zmon/badge/?version=latest\n   :target: https://readthedocs.org/projects/zmon/?badge=latest\n   :alt: Documentation Status\n\nZMON\n====\n\nZMON is Zalando's open-source platform monitoring tool, used in production since early 2014. It supports our many engineering teams in observing their services and metrics on various layers, from low level system metrics to team's business KPIs.\n\nIntroduction\n------------\n\nTo get familiar with the ideas behind ZMON and how things work, you can take a quick dive in: `Intro \u003chttp://zmon.readthedocs.org/en/latest/intro.html\u003e`_\n\nFeatures\n--------\n\n* Define checks as data sources executed on self-defined entities\n* Define alerts on checks and entities, with thresholds, as it suits your and your teams needs\n* Define custom dashboards with widgets and alert filters based on teams and tags\n* Check commands and alert conditions are arbitrary Python expressions, giving you a lot of power\n* All metric/check data is stored as time series in KairosDB for later use\n* Grafana3 is included, enabling you to build rich data driven dashboards\n* Powerful REST API to integrate nicely into other tools: e.g. cmdb/deploy tools\n* Entity service to store entities of any kind describing your environment\n* Trial run in the UI to develop your checks/alerts with quick feedback\n* Auto discovery of AWS services using ZMON's aws agent and entity service, great for AWS deployments\n* Authentication via OAuth 2 e.g. GitHub\n* Frontend incl. Grafana 3 requires full authentication, no need for VPN. incl. onetime tokens for office TV displays\n* Command line client for easy automation and interaction with the REST API\n* ZMON data service allows you to connect DCs/Regions via HTTP for federated monitoring\n* Supports SQL for PostgreSQL incl. sharded deployments, MySQL, Redis, Scalyr, ...\n* Supports desktop and mobile notifications via Firebase Cloud Messaging\n* More on connectivity here: `Check commands \u003chttps://zmon.readthedocs.io/en/latest/user/check-commands.html\u003e`_\n\nLocal demo and single host deployment\n=====================================\n\nWe suggest to use docker compose for deploying zmon locally or on a single host:\n\nMore here: `compose \u003chttps://github.com/zalando/zmon/tree/master/compose\u003e`_ \n\nThe docker compose is also the most convient way to setup a development environment.\n\nIn cases where docker compose is not an options continue on (or fall back to obsolete vagrant box).\n\nManual Deployment\n=================\n\nYou best head for the documentation now: `Component overview \u003chttps://zmon.readthedocs.io/en/latest/installation/configuration.html\u003e`_\n\nRequirements\n------------\n\nZMON relies on a few great open source products to run, which you will need to operate.\n\n* Redis\n* PostgreSQL\n* Cassandra + KairosDB\n\nThis seems to be a lot, but we provide both a Vagrant box and the deployment scripts for our `demo host \u003chttps://github.com/zalando/zmon-demo/blob/master/bootstrap/bootstrap.sh\u003e`_, lowering the bar to get started :)\n\nComponents\n----------\n\n`Frontend / Controller \u003chttps://github.com/zalando/zmon-controller\u003e`_ UI and REST API\n\n`Scheduler \u003chttps://github.com/zalando/zmon-scheduler\u003e`_ Schedules check/alert execution\n\n`Worker \u003chttps://github.com/zalando/zmon-worker\u003e`_ Executes check/alert commands and data acquisition\n\nOptional components\n-------------------\n\n`Data service \u003chttps://github.com/zalando/zmon-data-service\u003e`_ Used for distributed monitoring where sites don't share network connectivity other than the Internet.\n\n`Metric cache \u003chttps://github.com/zalando/zmon-metric-cache\u003e`_ Fast special purpose cache for REST API metric data for ZMON's REST metrics/cloud UI\n\n\nVagrant Box (deprecated)\n========================\n\nInstall a recent Vagrant_ version (at least 1.7.4) and simply do:\n\n.. code-block:: bash\n\n    $ vagrant up\n\nPlease note that the provisioning process will take some time (~15min) while it downloads the Docker images.\n\nFrontend\n--------\n\n  https://localhost:8443/\n\nLogin with your own GitHub credentials (OAuth redirect).\n\nGrafana\n-------\n\n  https://localhost:8443/grafana/\n\nYou will be able to create/save dashboards.\n\nKairosDB\n--------\n\nKairosDB frontend, i.e. for manually query of metrics:\n\n  http://localhost:38083/\n\nIssues\n------\n\n* If single containers do not start up ssh into the vagrant box and run the ``start.sh`` script again manually or use the ``start-services.sh`` script to restart single components. Later one takes parameters like ``controller`` or ``worker``.\n\nInstall the Command Line Interface\n==================================\n\nUse PIP to install the ``zmon`` executable from PyPI_.\n\n.. code-block:: bash\n\n    $ pip3 install --upgrade zmon-cli\n\nUse the ZMON CLI to push/create/update entities (hosts, databases, etc.), check definitions and create optional alerts (also possible via UI).\n\n.. code-block:: bash\n\n    $ zmon entities push examples/entities/local-postgresql.yaml\n\n    $ zmon entities push examples/entities/local-scheduler-instance.json\n\nPush your first check definition:\n\n.. code-block:: bash\n\n    $ zmon check-definitions update examples/check-definitions/zmon-scheduler-rates.yaml\n\nModify the alert definition to point to the right check id before doing:\n\n.. code-block:: bash\n\n    $ zmon alert-definitions update examples/alert-definitions/scheduler-rate-too-low.yaml\n\n\n.. _Vagrant: https://www.vagrantup.com/\n.. _PyPI: https://pypi.python.org/pypi/zmon-cli\n\nBuild Environment\n=================\n\nIf you want to compile everything from source, you can do so with our separate \"build-env\" Vagrant box:\n\n.. code-block:: bash\n\n    $ cd build-env\n    $ vagrant up\n\nThanks\n======\n\nDocker images/scripts used in slightly modified versions are:\n\n* abh1nav/cassandra:latest\n* wangdrew/kairosdb\n* official Redis and PostgreSQL\n\nThanks to the original authors!\n\nLicense\n=======\n\nCopyright 2013-2016 Zalando SE\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzalando%2Fzmon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzalando%2Fzmon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzalando%2Fzmon/lists"}