{"id":17067304,"url":"https://github.com/schu/tinymonitoring","last_synced_at":"2025-06-26T07:31:48.552Z","repository":{"id":44619067,"uuid":"189259556","full_name":"schu/tinymonitoring","owner":"schu","description":"tinymonitoring is a set of simple Ansible roles to set up Prometheus, Alertmanager and Blackbox exporter  behind Caddy \u0026 OAuth2 Proxy.","archived":false,"fork":false,"pushed_at":"2025-05-19T16:17:00.000Z","size":138,"stargazers_count":2,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-19T17:31:30.844Z","etag":null,"topics":["alertmanager","grafana","monitoring","prometheus"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/schu.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,"zenodo":null}},"created_at":"2019-05-29T16:14:55.000Z","updated_at":"2025-05-19T16:17:03.000Z","dependencies_parsed_at":"2023-01-30T18:31:09.465Z","dependency_job_id":"c7efdd87-68c5-4b7b-8bc0-5551c32cfd03","html_url":"https://github.com/schu/tinymonitoring","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/schu/tinymonitoring","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schu%2Ftinymonitoring","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schu%2Ftinymonitoring/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schu%2Ftinymonitoring/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schu%2Ftinymonitoring/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schu","download_url":"https://codeload.github.com/schu/tinymonitoring/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schu%2Ftinymonitoring/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262022037,"owners_count":23246239,"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":["alertmanager","grafana","monitoring","prometheus"],"created_at":"2024-10-14T11:10:16.167Z","updated_at":"2025-06-26T07:31:48.529Z","avatar_url":"https://github.com/schu.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tinymonitoring\n\ntinymonitoring is a set of simple Ansible roles to set up\n\n* Prometheus\n* Alertmanager\n* Blackbox exporter\n\nbehind Caddy \u0026 OAuth2 Proxy.\n\nThe goal is to provide a low-cost and low-maintenance monitoring option\nfor individuals and small teams.\n\ntinymonitoring is meant to be installed on a separate VM or system container.\nTested on Ubuntu LTS.\n\n## Configuration\n\n### Example `playbook.yml`\n\n```\nhosts: all\n  roles:\n    - iptables # Not required but recommended (only allow ports 22,80,443)\n    - caddy\n    - oauthproxy\n    - prometheus\n    - grafana\n  vars:\n    caddy_site_address: \"https://monitoring.example.com\"\n\n    oauthproxy_config: \"{{ playbook_dir }}/files/oauthproxy/oauth2-proxy.cfg\"\n\n    prometheus_config: \"{{ playbook_dir }}/files/prometheus/prometheus.yml\"\n    prometheus_web_external_url: \"https://monitoring.example.com/prometheus/\"\n\n    install_blackbox_exporter: true\n    install_alertmanager: true\n\n    # Note: if alertmanager has a path prefix (as in this example,\n    # \"/alertmanager\"), it needs to be set accordingly in the Prometheus\n    # config file.\n    alertmanager_web_external_url: \"https://monitoring.example.com/alertmanager/\"\n    alertmanager_rules_config: \"{{ playbook_dir }}/files/prometheus/alert_rules.yml\"\n    alertmanager_config: \"{{ playbook_dir }}/files/prometheus/alertmanager.yml\"\n\n    grafana_web_external_url: \"https://monitoring.example.com/grafana/\"\n    grafana_admin_user: \"demo\"\n    grafana_dashboards_dir: \"{{ playbook_dir }}/files/grafana/dashboards\"\n```\n\n### Example `oauthproxy_config` for GitHub auth\n\n```\nhttp_address = \"127.0.0.1:4180\"\n\nupstreams = [\n  \"file:///var/lib/oauthproxy/www-index/#/\",\n  \"http://127.0.0.1:9090/prometheus/\",\n  \"http://127.0.0.1:3000/grafana/\",\n  \"http://127.0.0.1:9093/alertmanager/\",\n]\n\nemail_domains = \"*\"\n\npass_user_headers = \"true\"\n\n# See https://oauth2-proxy.github.io/oauth2-proxy/docs/configuration/oauth_provider\n# for a list of supported providers and config options\nprovider = \"github\"\n\nclient_id = \"aaa\"\nclient_secret = \"bbb\"\n\ngithub_org = \"ccc\"\n\n# Make sure to create and set a cookie secret\n# python -c 'import os,base64; print(base64.urlsafe_b64encode(os.urandom(32)).decode())'\ncookie_secret = \"\"\ncookie_secure = \"true\"\n\n# The OAuth2 Proxy default is \"168h0m0s\", you might want to reduce the\n# cookie lifetime\ncookie_expire = \"24h0m0s\"\n```\n\n## Updating tinymonitoring\n\nNote: look for `Breaking change` in the commit log before updating.\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschu%2Ftinymonitoring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschu%2Ftinymonitoring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschu%2Ftinymonitoring/lists"}