{"id":13582172,"url":"https://github.com/esnet/gdg","last_synced_at":"2026-01-12T03:05:54.161Z","repository":{"id":39679392,"uuid":"357302171","full_name":"esnet/gdg","owner":"esnet","description":"Grafana Dash-n-Grab","archived":false,"fork":false,"pushed_at":"2025-05-12T00:58:09.000Z","size":13455,"stargazers_count":380,"open_issues_count":16,"forks_count":34,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-05-12T01:34:54.513Z","etag":null,"topics":["aws","azure-storage","backup","backups","dashboard","dashboards","gcloud","grafana","graphite","s3"],"latest_commit_sha":null,"homepage":"https://software.es.net/gdg/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/esnet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-04-12T18:41:18.000Z","updated_at":"2025-05-12T00:58:13.000Z","dependencies_parsed_at":"2023-09-25T23:15:59.823Z","dependency_job_id":"cc24f021-5a4b-40b9-bc3f-81db10d86b7d","html_url":"https://github.com/esnet/gdg","commit_stats":null,"previous_names":["netsage-project/grafana-dashboard-manager","esnet/grafana-dashboard-manager","netsage-project/gdg"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnet%2Fgdg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnet%2Fgdg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnet%2Fgdg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnet%2Fgdg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/esnet","download_url":"https://codeload.github.com/esnet/gdg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254448579,"owners_count":22072764,"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":["aws","azure-storage","backup","backups","dashboard","dashboards","gcloud","grafana","graphite","s3"],"created_at":"2024-08-01T15:02:28.192Z","updated_at":"2026-01-12T03:05:52.737Z","avatar_url":"https://github.com/esnet.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"[![Build Status](https://github.com/esnet/gdg/actions/workflows/go.yml/badge.svg)](https://github.com/esnet/gdg/actions/workflows/go.yml)\n[![Build Status](https://github.com/esnet/gdg/actions/workflows/hugo.yml/badge.svg)](https://github.com/esnet/gdg/actions/workflows/hugo.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/esnet/gdg)](https://goreportcard.com/report/github.com/esnet/gdg)\n[![GoDoc](https://godoc.org/github.com/esnet/gdg?status.svg)](https://godoc.org/github.com/esnet/gdg)\n[![codecov](https://codecov.io/gh/esnet/gdg/graph/badge.svg?token=sVEr9Zj6f3)](https://codecov.io/gh/esnet/gdg)\n[![GitHub release](https://img.shields.io/github/release/esnet/gdg.svg)](https://github.com/esnet/gdg/releases)\n\n\n# Grafana dash-n-grab\n\nGrafana Dash-n-Grab (GDG) -- Dashboard/DataSource Manager.  The purpose of this project is to provide an easy-to-use CLI to interact with the grafana API allowing you to backup and restore dashboard, connections (formerly datasources), and other entities.\n\nThe following remote backup locations are supported:\n  - AWS S3\n  - Google Storage\n  - Azure Storage\n  - S3 Compantible Storage (Minio, Ceph, etc)\n\nPlease find the generated documentation [here](https://software.es.net/gdg/) and the code for updating the docs is available [here](https://github.com/esnet/gdg/blob/main/documentation/content/docs/usage_guide.md)\n\n## Quickstart\n\n[\u003cimg src=\"https://raw.githubusercontent.com/esnet/gdg/main/website/static/quickstart.gif\" width=\"100%\" height=\"100%\" alt=\"Quickstart screen\"\u003e](https://raw.githubusercontent.com/esnet/gdg/main/website/static/quickstart.gif)\n\n## Supported Versions\n\nGDG community will try to support the last 2 major version of grafana.  Though there is nothing preventing you from using it with any version of grafana you are dependent on what the API supports/doesn't support and changes that have been added since then.\n\nNew features particularly related to Orgs, ACLs, roles etc are far less likely to work the older your version is.\n\nCurrent Entities supported (See official docs for more details)\n\n - Connections\n - Dashboards\n - Folders (With Permissions)\n - Organizations\n - Teams\n - Users\n - Library Elements\n - Alerting: \n   - Contact points (master branch only)\n\nGrafana Enterprise Only feature\n - Connection Permissions\n\n## Release conventions.\n\nGDG mostly follows the semver conventions with some minor modifications.\n\nFor those that are unfamiliar semver referes to X.Y.Z version patterns with\n\n  - X = Major version\n  - Y = Minor version\n  - Z= patch\n\nMost regular releases will increment the patch number.  ie. 0.4.5 is a regular release, and next normal release would be 0.4.6.\n\nMinor version change will likely introduce some breaking change.   For example, renaming datasources to connections or some\nconfiguration changes that are not backward compatible etc.\n\nMajor version: Is a major feature set change for example, removing cloud support in the base release and introducing a plugin system\nwould be 1.X release.  Splitting the GDG binary into a tools and backup cli, or introducing a diff tooling that allow you to compare\ncontexts.  i.e.  `gdg diff dashboards prod staging` is a major divergences from the current expectations so it'll be a major version bump.\n\nFor more info, please see the release notes and documentation both available [here](https://software.es.net/gdg/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesnet%2Fgdg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesnet%2Fgdg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesnet%2Fgdg/lists"}