{"id":18445789,"url":"https://github.com/voronenko/errbot-grafana","last_synced_at":"2026-05-09T06:05:53.051Z","repository":{"id":145345344,"uuid":"171534805","full_name":"Voronenko/errbot-grafana","owner":"Voronenko","description":"Opinionated errbot plugin for grafana.  Suitable for use with https://github.com/softasap/sa-grafana, https://github.com/softasap/sa-chatops-errbot   as well as with any custom installation.","archived":false,"fork":false,"pushed_at":"2019-03-29T14:41:34.000Z","size":247,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-24T02:32:54.423Z","etag":null,"topics":["cichosza","errbot","grafana","python","slack"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/Voronenko.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":"2019-02-19T19:19:51.000Z","updated_at":"2020-05-04T08:14:48.000Z","dependencies_parsed_at":"2023-07-03T09:17:20.145Z","dependency_job_id":null,"html_url":"https://github.com/Voronenko/errbot-grafana","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Voronenko/errbot-grafana","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voronenko%2Ferrbot-grafana","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voronenko%2Ferrbot-grafana/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voronenko%2Ferrbot-grafana/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voronenko%2Ferrbot-grafana/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Voronenko","download_url":"https://codeload.github.com/Voronenko/errbot-grafana/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voronenko%2Ferrbot-grafana/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273868128,"owners_count":25182423,"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","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"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":["cichosza","errbot","grafana","python","slack"],"created_at":"2024-11-06T07:07:21.398Z","updated_at":"2026-05-09T06:05:52.995Z","avatar_url":"https://github.com/Voronenko.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Grafana plugin for Errbot\n=========================\n\nMember of `sa-cichosza` family\n\nChatops features for Grafana\n----------------------------\n\nThis plugin allows you to refer grafana dashboards and panels for your team in a Slack channel.\n`More information about Errbot \u003chttp://errbot.io\u003e`_.\n\nQuickstart\n----------\n\nFirst you need to install Errbot, you can follow this documentation http://errbot.io/en/latest/user_guide/setup.html.\nErrbot server can be installed with https://github.com/softasap/sa-chatops-errbot ansible role or manually\n\nThen you'll need to install this plugin on your Errbot instance doing \n```\n!repos install https://github.com/Voronenko/errbot-grafana\n```\n, you can do that by talking to your bot locally with `errbot -T`. \n\nInitially, you need also to let bot know how to connect to your grafana instance, providing grafana address and access token.\n\n```\n!plugin config SaGrafana {'server_address': 'http://10.9.0.138/grafana', 'token': 'eyJrIjoicmNveFpac0tBZm81YzFrMDRNdWVQelRaN3VEOG5tblMiLCJuIjoiZS1ncmFmYW5hIiwiaWQiOjF9'}\n```\n\nOnce everything is setup, you can connect your bot to your Slack channel following `this documentation \u003chttp://errbot.io/en/latest/user_guide/configuration/slack.html\u003e`_.\n\n\nBot commands\n------------\n\n### Dashboard global listing  `!grafana dashboards list`\n\n![!grafana dashboards list](docs/grafana_dashboards_list.jpg \"!grafana dashboards list\")\n\nNote, that you get immediate hint on getting more info about dashboard \nwith `!grafana dashboard \u003cslug\u003e` command\n\n### Filtering dashboard listing by tag  `!grafana dashboards bytag`\n\n![!grafana dashboards bytag](docs/grafana_dashboards_bytag.jpg \"!grafana dashboards bytag\")\n\nGet only tagged dashboards with `!grafana dashboards query \u003ctext\u003e`\ncommand\n\n### Fuzzy finding of the dashboard by fragment `!grafana dashboards query`\n\n![!grafana dashboards query](docs/grafana_dashboards_query.jpg \"!grafana dashboards query\")\n\nReturn filtered dashboard list by fragment in title\nwith `!grafana dashboard query \u003ctext\u003e` command\n\n### Getting dashboard details `!grafana dashboard \u003cslug\u003e`\n\nHelps you to discover dashboard and find out possible input parameters and existing panels with command `!grafana dashboard \u003cslug\u003e`\n\n![!grafana dashboard details](docs/grafana_dashboard_details.jpg \"!grafana dashboard details\")\n\nTake a note on panel id or some unique word in panel title. You will need it to render specific panel.\n\n\n### Render specific panel with parameters `!grafana render \u003cslug\u003e \u003cpanel\u003e \u003cparameters\u003e`\n\n![!grafana render panel](docs/grafana_render_panel.jpg \"!grafana render \u003cslug\u003e \u003cpanel\u003e \u003cparameters\u003e\")\n\nYou can use change timespan by providing optional `--from`  and `--to` parameters: `!grafana render --from=now-2d vyacheslav-2-node-stats 9 server=i-02ed6d01291ce5260`\n\nYou can replace panelid with some unique text from panel title, for example, `system`\n\n`!grafana render vyacheslav-2-node-stats system server=i-02ed6d01291ce5260`\n\nIf your panel supports default parameters, you can skip parameters with dash:  `!grafana render --from=now-2d vyacheslav-2-node-stats system`\n\n![!grafana render panel](docs/grafana_render_panel2.jpg \"!grafana render \u003cslug\u003e \u003cpanel\u003e \u003cparameters\u003e\")\n\n\n### Ping `!grafana status`\n\nThis command, `!grafana status`, if succeeded returns some debug info about plugin.\nUse it to ensure that plugin is actually alive.\n\nContributing\n------------\n\nContributions to this plugin are always welcome and highly encouraged.\n\nLicense\n-------\n\nMIT - See LICENSE for more information.\n\n\nInterested in other plugins or roles ?\n--------------------------------------\n\nSubscribe for roles updates at [FB] (https://www.facebook.com/SoftAsap/)\n\nJoin gitter discussion channel at [Gitter](https://gitter.im/softasap)\n\nDiscover other roles at  http://www.softasap.com/roles/registry_generated.html\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoronenko%2Ferrbot-grafana","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoronenko%2Ferrbot-grafana","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoronenko%2Ferrbot-grafana/lists"}