{
    "info": {
        "author": "Matthias Ludwig",
        "author_email": "m.ludwig@datalyze-solutions.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 3 - Alpha",
            "Intended Audience :: Developers",
            "License :: OSI Approved :: MIT License",
            "Natural Language :: English",
            "Operating System :: MacOS",
            "Operating System :: Microsoft",
            "Operating System :: POSIX :: Linux",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7",
            "Topic :: System :: Networking :: Monitoring"
        ],
        "description": "# prometheus-url-checker\n\nThis little script periodically checks all configured urls with a HTTP HEAD request. The requests http code will be returned as prometheus compatible metric (gauge).\n\n## Links\n\n* [official docs](https://prom-url-checker.readthedocs.io)\n\n## Install\n\nThe packages uses the `flit` packager and requires `python 3.6`.\n\n* `pip3 install flit`\n* `flit install`\n\n## Usage\n\nThe application is very simple to configure. Simply set the `URLS` environment variable and start the server with `prom-url-checker`. You can see the metrics opening `http://127.0.0.1:9999/metrics`. To integrate this into your prometheus environment, simply add a new prometheus endpoint.\n\nA very simple cli allows the configuration of all necessary parameters.\n\n* `prom-url-checker` starts the metrics server on `127.0.0.1:9999` using the `URLS` environmental variable\n* `prom-url-checker --help` show's available cli options:\n\n```bash\nOptions:\n--host=STR            Host ip to serve on. (default: 127.0.0.1)\n--port=STR            Port to use (default: 9999)\n-s, --sleeptime=INT   Sleeptime during checks (default: 5)\n--urls=STR            Comma seperated list of urls to check, e.g. --urls https://test.domain.de,http://domain.de.  If unset, the environment variable URLS will be used instead.\n-d, --debug           Enable debugging mode\n\nOther actions:\n-h, --help            Show the help\n```\n\n## Metrics\n\n```\n# HELP request_in_progress Number of requests in progress\n# TYPE request_in_progress gauge\nrequest_in_progress{app=\"url_health_checker\",host=\"f8cad31124a6\",route=\"/\"} 0\n\n# HELP url_health Health status of a url.\n# TYPE url_health gauge\nurl_health{app=\"url_health_checker\",host=\"f8cad31124a6\",url=\"https://google.com\"} 301\nurl_health{app=\"url_health_checker\",host=\"f8cad31124a6\",url=\"https://github.com\"} 200\n\n# HELP url_health_request_processing_seconds Time spent processing request\n# TYPE url_health_request_processing_seconds summary\nurl_health_request_processing_seconds{app=\"url_health_checker\",host=\"f8cad31124a6\",quantile=\"0.5\"} 0.17756042900145985\nurl_health_request_processing_seconds{app=\"url_health_checker\",host=\"f8cad31124a6\",quantile=\"0.9\"} 0.2960943900034181\nurl_health_request_processing_seconds{app=\"url_health_checker\",host=\"f8cad31124a6\",quantile=\"0.99\"} 0.2960943900034181\nurl_health_request_processing_seconds_count{app=\"url_health_checker\",host=\"f8cad31124a6\"} 14\nurl_health_request_processing_seconds_sum{app=\"url_health_checker\",host=\"f8cad31124a6\"} 3.8046043350186665\n```",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/datalyze-solutions/prom-url-checker",
        "keywords": "http domain url monitoring prometheus check",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "prom-url-checker",
        "package_url": "https://pypi.org/project/prom-url-checker/",
        "platform": "",
        "project_url": "https://pypi.org/project/prom-url-checker/",
        "project_urls": {
            "Homepage": "https://github.com/datalyze-solutions/prom-url-checker"
        },
        "release_url": "https://pypi.org/project/prom-url-checker/0.0.4/",
        "requires_dist": [
            "clize==4",
            "aiohttp==3.5.4",
            "aioprometheus==18.7.1",
            "black; extra == \"dev\"",
            "bumpversion; extra == \"dev\"",
            "flake8; extra == \"dev\"",
            "flit; extra == \"dev\"",
            "mypy; extra == \"dev\"",
            "mkdocs; extra == \"doc\"",
            "pytest; extra == \"test\"",
            "pytest-cov; extra == \"test\"",
            "pytest-asyncio; extra == \"test\"",
            "pytest-aiohttp; extra == \"test\"",
            "tox; extra == \"test\""
        ],
        "requires_python": ">=3.6",
        "summary": "Prom-url-checker, a url checker with prometheus metrics output",
        "version": "0.0.4"
    },
    "last_serial": 5539860,
    "releases": {
        "0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c6ac9f9bf4ef7a70d97bcacf7be0be2f",
                    "sha256": "e30f3047bf3c580877ec81b29f2d85c36eb14dbc0b47e43d514babad4f91a783"
                },
                "downloads": -1,
                "filename": "prom_url_checker-0.0.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "c6ac9f9bf4ef7a70d97bcacf7be0be2f",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 13175,
                "upload_time": "2019-07-16T07:42:43",
                "url": "https://files.pythonhosted.org/packages/95/9f/78576db5a4beda03f37b7a694d9c73c0bfdfcdbd3169aa9d32d4e5a9a0d3/prom_url_checker-0.0.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "647129263311b84ffcc9c310fa924a7b",
                    "sha256": "f6e5bc8025e52ea14b712a07e4f042ea24421edeed1c41e0cdf4dc7c0d8784b1"
                },
                "downloads": -1,
                "filename": "prom-url-checker-0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "647129263311b84ffcc9c310fa924a7b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 7662,
                "upload_time": "2019-07-16T07:42:45",
                "url": "https://files.pythonhosted.org/packages/9b/c0/45ed1604310c10f0a275cf2b4f14d135d78b5face376696f512c8db9d238/prom-url-checker-0.0.2.tar.gz"
            }
        ],
        "0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "55e69eedc6934cdbd68e68958b9395af",
                    "sha256": "62d155e9cdca771cbf48027db468f338d89258bf1093f65a20952c9b70bf37fc"
                },
                "downloads": -1,
                "filename": "prom_url_checker-0.0.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "55e69eedc6934cdbd68e68958b9395af",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 13199,
                "upload_time": "2019-07-16T07:54:37",
                "url": "https://files.pythonhosted.org/packages/3d/c9/8916093ffdc14924e2d42286d6e5831fd8f5ed33ee1a10b7532260561e72/prom_url_checker-0.0.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "ca711105d0a23cfc1fda6c898f16c255",
                    "sha256": "066f1f15b242d33b0d9bc6cf06d51c3b52544df1939b0b9ac3b6de6587024487"
                },
                "downloads": -1,
                "filename": "prom-url-checker-0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "ca711105d0a23cfc1fda6c898f16c255",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 7698,
                "upload_time": "2019-07-16T07:54:39",
                "url": "https://files.pythonhosted.org/packages/a2/fd/b1526ec5405a5130cd12702a378d9746bd2dadcec9262aa4dc38de00dde1/prom-url-checker-0.0.3.tar.gz"
            }
        ],
        "0.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "017bd969531b1cbb547de60e122aa298",
                    "sha256": "414dfb7eb1b18ba816016c6c0bc5c3233d47ba014512de19a1e05d211db416e9"
                },
                "downloads": -1,
                "filename": "prom_url_checker-0.0.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "017bd969531b1cbb547de60e122aa298",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 14144,
                "upload_time": "2019-07-16T10:57:43",
                "url": "https://files.pythonhosted.org/packages/cf/94/a023c49bf0aa638d72a8ff7743058300556a2e54c1c2f588e59032f47b3f/prom_url_checker-0.0.4-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "642ffe9828f129a0409ebcee59564537",
                    "sha256": "c72af73219944721e1b70c34f22d1a255cc3d65bb893b0b71a0ba3c03d38d75f"
                },
                "downloads": -1,
                "filename": "prom-url-checker-0.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "642ffe9828f129a0409ebcee59564537",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 7976,
                "upload_time": "2019-07-16T10:57:44",
                "url": "https://files.pythonhosted.org/packages/bb/20/a721dcea19bd927d33483b31bb1c1118a22812e8116ae03bfeafb8a70e9d/prom-url-checker-0.0.4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "017bd969531b1cbb547de60e122aa298",
                "sha256": "414dfb7eb1b18ba816016c6c0bc5c3233d47ba014512de19a1e05d211db416e9"
            },
            "downloads": -1,
            "filename": "prom_url_checker-0.0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "017bd969531b1cbb547de60e122aa298",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 14144,
            "upload_time": "2019-07-16T10:57:43",
            "url": "https://files.pythonhosted.org/packages/cf/94/a023c49bf0aa638d72a8ff7743058300556a2e54c1c2f588e59032f47b3f/prom_url_checker-0.0.4-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "642ffe9828f129a0409ebcee59564537",
                "sha256": "c72af73219944721e1b70c34f22d1a255cc3d65bb893b0b71a0ba3c03d38d75f"
            },
            "downloads": -1,
            "filename": "prom-url-checker-0.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "642ffe9828f129a0409ebcee59564537",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 7976,
            "upload_time": "2019-07-16T10:57:44",
            "url": "https://files.pythonhosted.org/packages/bb/20/a721dcea19bd927d33483b31bb1c1118a22812e8116ae03bfeafb8a70e9d/prom-url-checker-0.0.4.tar.gz"
        }
    ]
}