{"id":39643419,"url":"https://github.com/frodeaa/status-checker","last_synced_at":"2026-01-18T09:02:36.982Z","repository":{"id":28779236,"uuid":"119303243","full_name":"frodeaa/status-checker","owner":"frodeaa","description":"check HTTP status/latency with lambda","archived":false,"fork":false,"pushed_at":"2024-12-24T10:31:34.000Z","size":578,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-24T11:43:37.934Z","etag":null,"topics":["cloudwatch-metrics","lambda","serverless"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frodeaa.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":"2018-01-28T22:21:15.000Z","updated_at":"2024-12-24T10:31:37.000Z","dependencies_parsed_at":"2023-01-14T10:01:17.023Z","dependency_job_id":"9634f95b-1c95-442c-aa50-1115abf456c0","html_url":"https://github.com/frodeaa/status-checker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/frodeaa/status-checker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frodeaa%2Fstatus-checker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frodeaa%2Fstatus-checker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frodeaa%2Fstatus-checker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frodeaa%2Fstatus-checker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frodeaa","download_url":"https://codeload.github.com/frodeaa/status-checker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frodeaa%2Fstatus-checker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28534154,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cloudwatch-metrics","lambda","serverless"],"created_at":"2026-01-18T09:02:36.294Z","updated_at":"2026-01-18T09:02:36.976Z","avatar_url":"https://github.com/frodeaa.png","language":"TypeScript","readme":"# status-checker\n\nstatus-checker is a small service which checks\nthe HTTP status code and latency for one or more\nendpoints\n\nThe result is saved to AWS CloudWatch, where you can use\nthe result to trigger other events.\n\n![Cloudwatch example](.images/aws-console.png)\n\nFollowing metrics are pushed to AWS CloudWatch using\nnamespace `status-checker/HTTP` and dimension `Endpoint`\nand `Method`.\n\n| MetricName   | Description            |         Unit |\n| :----------- | :--------------------- | -----------: |\n| Latency      | request time           | Milliseconds |\n| HTTPCode     | HTTP status code       |         None |\n| HTTPCode_YXX | Number of 2XX, 3XX,... |         None |\n\n## Getting Started\n\nstatus-checker is configured by providing a JSON list of objects\nwith following properties.\n\n-   `url`: fully qualified URI, the endpoint to check\n-   `method`: http method (default: \"GET\")\n-   `headers` - http headers (default: {})\n\n### Example\n\n```\n[\n    {\"url\": \"example.com\"},\n    {\"url\": \"post.example.com\", \"method\": \"POST\"},\n    {\"url\": \"test.example.com\", \"headers\": {\"Authorization\": \"Basic \"}}\n]\n```\n\n### Installing\n\nThe application can be deployed with aws cloudformation.\n\nhttps://github.com/frodeaa/status-checker/blob/b1e69d419767b323e779bf6b34b3fc8ce9eece08/e2e/scripts/create-status-checker-stack.sh#L3-L11\n\n#### Configure status checker\n\nSetup the status checker for an URL by creating a configuration stack\n\nhttps://github.com/frodeaa/status-checker/blob/b1e69d419767b323e779bf6b34b3fc8ce9eece08/e2e/scripts/create-status-checker-configuration-stack.sh#L2-L18\n\n\u003e The default schedule is every 5 minutes. It can be changed by using the\n\u003e `StatusCheckerScheduleExpression` parameter.\n\n### View metrics\n\nThe metrics can be view in AWS console or by querying using `aws`.\n\n```\naws cloudwatch get-metric-statistics \\\n    --metric-name Latency \\\n    --start-time 2020-07-25T20:00:00 \\\n    --end-time 2020-07-26T04:00:00 \\\n    --period 60 \\\n    --statistics Average \\\n    --namespace status-checker/HTTP \\\n    --dimensions \\\n       'Name=Method,Value=GET' \\\n       'Name=Endpoint,Value=http://example.com'\n{\n    \"Label\": \"Latency\",\n    \"Datapoints\": [\n        {\n            \"Timestamp\": \"2020-07-25T21:55:00+00:00\",\n            \"Average\": 249.07750599999986,\n            \"Unit\": \"Milliseconds\"\n        },\n        {\n            \"Timestamp\": \"2020-07-25T21:50:00+00:00\",\n            \"Average\": 235.51812300000006,\n            \"Unit\": \"Milliseconds\"\n        }\n    ]\n}\n```\n\n## Development\n\n\u003e You can use `make` to run build and testing\n\n```\nbuild lint test e2e/test e2e/create-stacks yarn scripts\ndown up                                    docker compose commands\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrodeaa%2Fstatus-checker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrodeaa%2Fstatus-checker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrodeaa%2Fstatus-checker/lists"}