[{"_1":2,"_169":-5,"_170":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_144":145},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_135":-5,"_136":11,"_137":17,"_138":11,"_139":-5,"_140":11,"_141":-5,"_142":143},"canonicalUrl","https://hub.docker.com/r/karimsa/patrol/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","karimsa","reponame","patrol","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-10-18T01:06:39.2527Z","description","Host your own status pages.","is_private","last_updated","2020-11-02T02:23:26.786018Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",9072,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"PATROL\"$ \n

\n\n

Host your own status pages.

\n\n

\n \n $\"CircleCI\"$ \n \n

\n\n - [Usage](#usage)\n - [Docker tags](#docker-tags)\n - [Creating a service](#creating-a-service)\n - [Creating health checks](#creating-health-checks)\n\t- [Health check images](#health-check-images)\n\t- [Health check options](#health-check-options)\n - [Badges](#badges)\n - [License](#license)\n\n## Usage\n\nThe purpose of `patrol` is to be able to self-host an automated status page that gives you an overview of\nyour operations. The idea is different from something like Atlassian's Statuspage, since that is more for\ncommunicating your operation status to external stakeholders while `patrol` is more for just monitoring.\n\nTo run `patrol` on your own, you simply need access to a machine with `docker` installed. To start, you should write your own configuration file, to something like [this](example.yml).\n\nYou can then run `patrol` via docker:\n\n```shell\n$ ls\npatrol.yml\n$ docker run \\\n\t-v \"$PWD:/config\" \\\n\t-v /var/run/docker.sock:/var/run/docker.sock \\\n\t-p 80:8080 \\\n\tkarimsa/patrol:latest \\\n\t--config /config/patrol.yml\n```\n\nThis will start patrol on ports `80` and `8080`, where `80` will host the web interface and `8080` will host\nthe API server. It will also give patrol access to your host machine's docker daemon so that it can spin up\nadditional containers.\n\n## Docker tags\n\nThere are two tags that are published to the docker repo for this project:\n\n - `latest`: As per docker convention, this is the latest stable release of patrol.\n - `unstable`: This is the latest copy of the image from `master` - if you like to live life on the edge.\n\n## Creating a service\n\nServices in patrol are simply a collection of health checks. For now, they are mostly a visual grouping - checks belonging to the same service will be grouped together on the status page. To create a new service, you simply need to add a new key-value pair to the `services` key of the configuration.\n\nFor example, a simple service assigned to 'google.ca' could have the configuration:\n\n```yaml\nservices:\n google.ca:\n - name: Delivers homepage\n cmd: 'curl -fsSL https://www.google.ca/'\n```\n\n## Creating health checks\n\nHealth checks are the core of patrol. Each health check is a simple shell script that tests the availability of a given feature in a service. If the script executes successfully, the health check is considered to be passed. If the script exits with a non-zero exit code, the health check is considered to be failed.\n\nA simple health check might test an HTTP server's ability to deliver content by simplying executing a `curl` request. In the example above, `curl -fsSL https://www.google.ca/` is used to simply hit the google homepage at `www.google.ca` and will fail if the content is not delivered.\n\nSince health checks can be any shell script, it is not necessary that you only use one command. For instance, if you are testing the availability of a specific page (let's say login) and your SPA might have a 404 but the HTTP server might not return a 404, you can use `grep` to verify that the right content was received instead of 'any content was received'.\n\nFor example:\n\n```yaml\nservices:\n My App:\n - name: Delivers login\n cmd: 'curl -fsSL https://myapp.com/login | grep MyApp'\n```\n\nSince the errors are carried forward in the pipe (patrol enables the `-e` flag by default when executing your scripts), and `grep` fails when it cannot find the query, this check is complete.\n\nAs you can see, layering multiple checks might help you diagnose *where* the issue is when there is an issue. In this case, having both the `Delivers homepage` and `Delivers login` checks might tell you that if the first succeeds and the second fails, there is most likely a content delivery issue as opposed to an infrastructure issue.\n\n**Note:** Since the exit code of the health check is used to determine whether the service is running or not, it is important that your command is setup to only fail if the service is failing. In the example of a `curl` request, you must specify the `-f, --fail` flag to ensure that curl exits with a non-zero exit code if the web server does not respond with a 2XX/3XX response.\n\n### Health check images\n\nPatrol runs each health check in its own docker container which are by default configured to be siblings of the patrol container itself. Though this might be useful for isolation, its main use case is to make it really easy to encapsulate your command into the right virtual environment.\n\nFor instance, let's say that you need to create a health check against a Redis deployment. You might be able to use general network tools like `ping` and `telnet` to test its uptime, but ideally, you should use the `redis-cli` to send commands.\n\nTo do this, you can simply specify the docker image that should be used when executing your health check. If at the time of running the health check the image is not available, patrol will pull the image from the docker registry.\n\nHere's an example for redis:\n\n```yaml\nservices:\n Redis:\n - name: Responds to PING\n image: redis:5\n cmd: 'redis-cli -h myredis.com -a myauth PING'\n - name: Job stream exists\n image: redis:5\n cmd: 'redis-cli -h myredis.com -a myauth XINFO STREAM mystream'\n```\n\nCurrently, patrol does not support encrypting your sensitive information when pushing to git, so please be weary.\n\n### Health check options\n\n - **name** (required): a string specifying the name to give this health check. If this name is changed, the entire history for the health check will be reset.\n - **cmd** (required; string/array):\n\t- If this is a string, it must be a command which can be passed to the shell via `/bin/sh -c 'cmd'`.\n\t- If this is an array, it must have all string elements and the contents will be concatenated with a ';' in between and then passed to the shell.\n - **image** (default: `karimsa/patrol`): this is the Docker image within which you want to run the command. It defaults to the patrol image which contains `curl`, `ping`, and `jq`.\n - **type** (optional; values: 'metric'): if specified as 'metric', the health check will considered to be of type metric and therefore its stdout will be parsed as a numeric value.\n - **unit** (optional): if specified and type is metric, will be used when displaying the metric chart on the status page.\n\n## Badges\n\nTo embed live badges in your README or elsewhere, you can simply add `/badge` to the end of your patrol URL.\nFor instance, if your public URL is `https://status.myapp.com`, your badge will be available at: `https://status.myapp.com/badge`.\n\nYou can also pass a custom `style` query param which is passed directly to [shields.io](https://shields.io). For example, `https://status.myapp.com/badge?style=flat`.\n\n## License\n\nLicensed under MIT license.\n\nCopyright © 2019-present Karim Alibhai.\n\nBadge in logo created by **Artdabana@Design** from the Noun Project.\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",4964814958,"orgData","recentTags",[87,125],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",810130,"full_size",378951211,"id",74411425,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:4950538636121062f1212065695cb219f881b34f3b4038b7ad751bdfc77b05db","features","","last_pulled","2026-09-28T10:11:24.259020542Z","last_pushed","2020-07-11T17:54:09Z","os","linux","os_features","os_version","size","variant","2020-07-11T17:54:10.241102Z","last_updater","last_updater_username","media_type","latest","repository",7874860,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":126,"_93":127,"_95":128,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},378254339,73011325,[129],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},"sha256:82ad3a5d70e8706c85c53b113e4e64ec3527be5f6758238fde598544d92fd707","2026-09-07T09:19:55.636307591Z","2020-11-02T02:23:27Z","2020-11-02T02:23:26.393569Z","unstable","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":146,"_153":154,"_142":167,"_168":11},{"_36":147,"_38":148,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":149,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":150,"_75":11,"_76":152,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":151},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_155":156,"_157":-5,"_158":-5,"_159":160},"count",2,"next","previous","results",[161,164],{"_88":40,"_89":90,"_91":126,"_93":127,"_95":162,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},[163],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},{"_88":40,"_89":90,"_91":92,"_93":94,"_95":165,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[166],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

karimsa/patrol

Tags for karimsa/patrol