{"id":41792862,"url":"https://github.com/hctrdev/grafana-matrix-forwarder","last_synced_at":"2026-01-25T05:07:48.381Z","repository":{"id":48091674,"uuid":"315101612","full_name":"hctrdev/grafana-matrix-forwarder","owner":"hctrdev","description":"[MIRROR] Forward alerts from Grafana to a Matrix chat room","archived":false,"fork":false,"pushed_at":"2024-11-20T22:14:01.000Z","size":11601,"stargazers_count":17,"open_issues_count":3,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-03T13:36:18.807Z","etag":null,"topics":["alerts","go","golang","grafana","matrix"],"latest_commit_sha":null,"homepage":"https://gitlab.com/hectorjsmith/grafana-matrix-forwarder","language":"Go","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/hctrdev.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-11-22T18:09:43.000Z","updated_at":"2025-09-06T11:10:52.000Z","dependencies_parsed_at":"2025-10-03T13:36:27.321Z","dependency_job_id":null,"html_url":"https://github.com/hctrdev/grafana-matrix-forwarder","commit_stats":null,"previous_names":["hctrdev/grafana-matrix-forwarder","hectorjsmith/grafana-matrix-forwarder"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/hctrdev/grafana-matrix-forwarder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hctrdev%2Fgrafana-matrix-forwarder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hctrdev%2Fgrafana-matrix-forwarder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hctrdev%2Fgrafana-matrix-forwarder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hctrdev%2Fgrafana-matrix-forwarder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hctrdev","download_url":"https://codeload.github.com/hctrdev/grafana-matrix-forwarder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hctrdev%2Fgrafana-matrix-forwarder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28744421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T02:46:29.005Z","status":"ssl_error","status_checked_at":"2026-01-25T02:44:29.968Z","response_time":113,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["alerts","go","golang","grafana","matrix"],"created_at":"2026-01-25T05:07:47.769Z","updated_at":"2026-01-25T05:07:48.376Z","avatar_url":"https://github.com/hctrdev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grafana to Matrix Forwarder\n*Forward alerts from [Grafana](https://grafana.com) to a [Matrix](https://matrix.org) chat room.*\n\n[![documentation](https://img.shields.io/badge/docs-latest-orange)](https://hctrdev.gitlab.io/grafana-matrix-forwarder/)\n [![pipeline status](https://gitlab.com/hctrdev/grafana-matrix-forwarder/badges/main/pipeline.svg)](https://gitlab.com/hctrdev/grafana-matrix-forwarder/-/commits/main) [![Go Report Card](https://goreportcard.com/badge/gitlab.com/hctrdev/grafana-matrix-forwarder)](https://goreportcard.com/report/gitlab.com/hctrdev/grafana-matrix-forwarder)\n\n---\n\nThis project provides a simple way to forward alerts generated by Grafana to a Matrix chat room.\n\nDefine a Grafana webhook alert channel that targets an instance of this application.\nThis tool will convert the incoming webhook to a Matrix message and send it on to a specific chat room.\n\n![screenshot of matrix alert message](_docs/static/img/alertExample.png)\n\n## 1. Features\n\n  * 📦 **Portable**\n    * As a single binary the tool is easy to run in any environment\n  * 📎 **Simple**\n    * No config files, all required parameters provided on startup\n  * 🪁 **Flexible**\n    * Support multiple grafana alert channels to multiple matrix rooms\n  * 📈 **Monitorable**\n    * Export metrics to track successful and failed forwards\n\n## 2. How to use\n*This applies to unified alerts, check the [documentation](https://hctrdev.gitlab.io/grafana-matrix-forwarder/gettingStarted/grafana-legacy/) for legacy alerts*\n\n**Step 1**\n\nRun the forwarder by providing a matrix account to send messages from.\n\n```\n$ ./grafana-matrix-forwarder --user @userId:matrix.org --password xxx --homeserver matrix.org\n```\n\n**Step 2**\n\nAdd a new **Contact Point** in Grafana with the **POST webhook** type. Use the following URL: \n```\nhttp://\u003cip address\u003e:6000/api/v1/unified?roomId=\u003croomId\u003e\n```\n\n*Replace with the server ID and matrix room ID.*\n\n**Step 3**\n\nAdd a new Notification Policy in Grafana to send alerts to the new contact point.\n\n*If you use the root policy, all alerts will be sent to that contact point*\n\n**Step 4**\n\nCreate alert rules in grafana and add text to the a \"Summary\" field to be displayed in the Matrix message.\n\n## 3. Docker\n\nAn official docker image is available on the Gitlab container registry.\nUse it by pulling the following image:\n\n```\nregistry.gitlab.com/hctrdev/grafana-matrix-forwarder:latest\n```\n\nExample run command:\n```\ndocker run -d \\\n    --name \"grafana-matrix-forwarder\" \\\n    -e GMF_MATRIX_USER=@user:matrix.org \\\n    -e GMF_MATRIX_PASSWORD=password \\\n    -e GMF_MATRIX_HOMESERVER=matrix.org \\\n    registry.gitlab.com/hctrdev/grafana-matrix-forwarder:latest\n```\n\nRead the [documentation](https://hctrdev.gitlab.io/grafana-matrix-forwarder/) for more detail on using Docker.\n\n## Thanks\n\nMade possible by the [maunium.net/go/mautrix](https://maunium.net/go/mautrix/) library and all the contributors to the [matrix.org](https://matrix.org) protocol.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhctrdev%2Fgrafana-matrix-forwarder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhctrdev%2Fgrafana-matrix-forwarder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhctrdev%2Fgrafana-matrix-forwarder/lists"}