{"id":13581840,"url":"https://github.com/dgl/alertmanager-webhook-signald","last_synced_at":"2025-10-17T04:37:32.275Z","repository":{"id":48245149,"uuid":"244152132","full_name":"dgl/alertmanager-webhook-signald","owner":"dgl","description":"Alertmanager webhook server for Signald","archived":false,"fork":false,"pushed_at":"2023-02-15T03:21:58.000Z","size":44,"stargazers_count":22,"open_issues_count":4,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-26T16:07:04.325Z","etag":null,"topics":["alertmanager","alertmanager-webhook","golang","prometheus","signal","signald"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/dgl.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":"2020-03-01T13:14:52.000Z","updated_at":"2025-01-03T06:45:52.000Z","dependencies_parsed_at":"2024-06-19T00:26:34.310Z","dependency_job_id":"4546ebed-48df-434e-bd5d-67a94402c5ec","html_url":"https://github.com/dgl/alertmanager-webhook-signald","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dgl/alertmanager-webhook-signald","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Falertmanager-webhook-signald","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Falertmanager-webhook-signald/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Falertmanager-webhook-signald/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Falertmanager-webhook-signald/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dgl","download_url":"https://codeload.github.com/dgl/alertmanager-webhook-signald/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Falertmanager-webhook-signald/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262099717,"owners_count":23258668,"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","alertmanager-webhook","golang","prometheus","signal","signald"],"created_at":"2024-08-01T15:02:16.224Z","updated_at":"2025-10-17T04:37:27.255Z","avatar_url":"https://github.com/dgl.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Signal notifier for Prometheus alertmanager\n\nThis implements an alertmanager webhook that can connect to\n[signald](https://github.com/thefinn93/signald).\n\n## Building\n\n```shell\ngo get github.com/dgl/alertmanager-webhook-signald\n```\n\nWill give you a *alertmanager-webhook-signald* binary to run, in your Go bin\ndirectory (`$(go env GOPATH)/bin/alertmanager-webhook-signald`).\n\n## Setup\n\nFollow the account creation steps at\nhttps://signald.org/articles/getting-started/ and get a number registered in\nyour signald instance. Set this number as the 'sender' in the config below.\n\nExample:\n\n```\ngo get gitlab.com/signald/signald-go/cmd/signaldctl\nsignaldctl account register +1555...\n```\n\n## Configuration\n\nSave something like the following as *config.yaml*:\n\n```yaml\ndefaults:\n  # Phone number of sender, must be registered in this signald per Setup.\n  sender: +1555...\n  template: '{{ template \"signal.message\" . }}'\n  # Subscribe to responses from signald. May help to keep the connection alive.\n  subscribe: true\n\ntemplates:\n  # Copy this file to the same place as the configuration file.\n  - \"alerts.tmpl\"\n\nreceivers:\n  - name: something\n    to:\n      - group:xxxx\n      - tel:+44...\n    # Optional: the sender, template, etc. fields as in defaults above.\n```\n\nSee [example.yaml](example.yaml) for a more complete configuration example.\n\nTo get ID to put after `group:` you can use `signaldctl`, add the account to\nthe group, then run `signaldctl group list -a +1555...`.\n\nYou'll also need a template file for the alert message text, just putting\n[alerts.tmpl](alerts.tmpl) in the same directory as the configuration file will\nwork for most cases.\n\n### Alertmanager configuration\n\n```yaml\nreceivers:\n  - name: something\n    webhook_configs:\n      - url: http://localhost:9716/alert\n```\n\nThe receiver name defined in alertmanager configuration will be sent to the\nreceiver with the matching name in the receivers section of the configuration\nfile (i.e. \"something\" in this example must be the same string in both\nalertmanager configuration and this webhook's configuration).\n\n## Running\n\n```shell\nalertmanager-webhook-signald -config config.yaml\n```\n\n## Monitoring\n\n### Prometheus configuration\n\nUse Prometheus to check the health of the webhook itself.\n\nConfigure Prometheus to scrape it:\n```yaml\nscrape_configs:\n  - job_name: alertmanager-signald-webhook\n    static_configs:\n      - targets: ['localhost:9716']\n```\n\nConfigure some rules like the rules in [example-rules.yaml](example-rules.yaml)\nto alert you -- ideally via another alert receiver!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgl%2Falertmanager-webhook-signald","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdgl%2Falertmanager-webhook-signald","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgl%2Falertmanager-webhook-signald/lists"}