[{"_1":2,"_161":-5,"_162":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_140":141},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_129":-5,"_130":11,"_131":21,"_132":11,"_133":-5,"_134":11,"_135":-5,"_136":137,"_138":91,"_139":-7},"canonicalUrl","https://hub.docker.com/r/f1yegor/grafcli/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","f1yegor","reponame","grafcli","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":62,"_64":65,"_66":-5,"_67":68,"_69":70,"_71":11,"_72":33,"_73":74,"_79":21,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2016-10-16T17:54:18.858439Z","description","Grafana CLI for fast and easy dashboards management.","is_private","last_updated","2016-10-16T17:56:25.802537Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",990,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","# grafcli\n\n[![Build Status](https://travis-ci.org/m110/grafcli.svg?branch=master)](https://travis-ci.org/m110/grafcli)\n\n[Grafana](http://grafana.org) CLI for fast and easy dashboards management.\n\n**Note that this is still alpha software.**\n\n## Featuring:\n\n* Dashboards backup and restore.\n* Easy rows and panels moving/copying between dashboards.\n* Editing dashboards/rows/panels in-place.\n* Templates of dashboards, rows and panels.\n* File export/import.\n* Interactive CLI with completions support.\n* Compatibility across Grafana 1 and 2.\n* ...and more!\n\n## Why?\n\n* Lets you easily manage your dashboards using just your keyboard.\n* Provides convenient way to backup dashboards and restore them.\n* Can be used by any shell script with even more logic added.\n\n## How?\n\nGrafcli connects directly to one of Grafana's backends (Elastic, SQLite, MySQL, PostgreSQL) and modifies dashboards. However, this is all hidden behind an interface you already know well, similar to *nix filesystem.\n\n## Requirements\n\n* [Python 3](http://python.org)\n* [climb](https://github.com/m110/climb)\n* Depending on which storage backends you use:\n * [elasticsearch-py](http://github.com/elastic/elasticsearch-py)\n * [psycopg2](http://initd.org/psycopg/)\n * [MySQL Connector/Python](http://dev.mysql.com/downloads/connector/python/)\n\n## Installation\n\n```\npip3 install grafcli\n```\n\nor get the source and run:\n\n```\npython3 setup.py install\n```\n\nThen define your hosts in the config file (see below for details).\n```\ncp /etc/grafcli/grafcli.conf.example /etc/grafcli/grafcli.conf\n```\n\nYou will need at least one of the backend libraries listed above.\n\n## TODO\n\n* Improve confirmation prompt.\n* Improve completions.\n* Implement asterisk (*) handling.\n\n# Usage\n\n## Navigation\n\nUse `cd` and `ls` commands to list nodes and move around.\n\n```\n[/]> cd templates\n[/templates]> ls\ndashboards\nrows\npanels\n[/templates]> ls dashboards\nexample_dashboard\nanother_dashboard\n[/templates]> ls dashboards/example_dashboard\n1-Example-Row\n2-Another-Row\n3-Yet-Another-Row\n[/templates]> ls dashboards/example_dashboard/1-Example-Row\n1-Example-Panel\n2-Another-Panel\n```\n\n## Directories\n\nIn the root directory, you will find three basic directories:\n\n* `backups` - for storing backups of your dashboards (surprised?).\n* `remote` - which lets you access remote hosts.\n* `templates` - that contains templates of dashboards, rows and panels.\n\n## Management\n\nMost of the arguments here are paths to a dashboard, row or panel.\n\n* `cat ` - display JSON of given element.\n* `$EDITOR ` - edit the JSON of given element in-place and update it afterwards. Editor name can be set in the config file.\n* `cp ` - copies one element to another. Can be used to copy whole dashboards, rows or single panels.\n* `mv ` - the same as `cp`, but moves (renames) the source.\n* `rm ` - removes the element.\n* `template ` - saves element as template.\n* `backup ` - saves backup of all dashboards from remote host as .tgz archive.\n* `restore ` - restores saved backup.\n* `export ` - saves the JSON-encoded element to file.\n* `import ` - loads the JSON-encoded element from file.\n* `pos ` - change position of row in a dashboard or panel in a row.\n\n# Configuration\n\nGrafcli will attempt to read `./grafcli.conf`, `~/.grafcli.conf` and `/etc/grafcli/grafcli.conf` in that order.\n\nHere is the configuration file explained.\n```ini\n[grafcli]\n# Your favorite editor - this name will act as a command!\neditor = vim\n# Commands history file. Leave empty to disable.\nhistory = ~/.grafcli_history\n# Additional verbosity, if needed.\nverbose = off\n# Answer 'yes' to all overwrite prompts.\nforce = on\n\n[resources]\n# Directory where all local data will be stored (including backups).\ndata-dir = ~/.grafcli\n\n# List of remote Grafana hosts.\n# The key names do not matter, as long as matching section exists.\n# Set the value to off to disable the host.\n[hosts]\nhost.example.com = on\n\n[host.example.com]\ntype = elastic\n# In case of more hosts, use comma-separated values.\nhosts = host1.example.com,host2.example.com\nport = 9200\nindex = grafana-dash\nssl = off\n# HTTP user and password, if any.\nuser =\npassword =\n```\n\nYou can use other backends as well.\n\nMySQL:\n```ini\n[mysql.example.com]\ntype = mysql\nhost = mysql.example.com\nport = 3306\nuser = grafana\npassword =\ndatabase = grafana\n```\n\nPostgreSQL:\n```ini\n[postgresql.example.com]\ntype = postgresql\nhost = postgresql.example.com\nport = 5432\nuser = grafana\npassword =\ndatabase = grafana\n```\n\nSQLite:\n```ini\n[sqlite.example.com]\ntype = sqlite\npath = /opt/grafana/data/grafana.db\n```\n\n# Tips\n\n## Batch mode\n\nAny command can be passed directly as arguments to grafcli, which will exit just after executing it. If you run it without arguments, you will get to interactive mode (preferable choice in most cases).\n\nBatch mode:\n```bash\n$ grafcli ls remote\nhost.example.com\nanother.example.com\n$ \n```\n\nInteractive mode:\n```bash\n$ grafcli\n[/]> ls remote\nhost.example.com\nanother.example.com\n[/]> \n```\n\n## Short names\n\nAll rows and panels names start with a number and it may seem that typing all that stuff gets boring soon. However, there are completions available (triggered by `TAB` key) to help you with that. What is more, it is enough to provide just the number of the row or panel, so take advantage of that!\n\nSo instead of typing:\n```\n[/]> cp /templates/dashboards/dashboard/1-Top-Row/1-Top-Panel /remote/example/dashboard/1-Top-Row\n```\nYou can just do:\n```\n[/]> cp /templates/dashboards/dashboard/1/1 /remote/example/dashboard/1\n```\n\nBut then again, TAB-completions make it easy enough to type full names.\n\n# Examples\n\nSome of the common operations.\n\n* Store dashboard as template (saved to `templates/dashboards/main_dashboard`):\n\n```\n[/]> template remote/example/main_dashboard\n```\n\n* Create the exact copy of dashboard's template:\n\n```\n[/templates/dashboards]> cp main_dashboard new_dashboard\n```\n\n* Update remote dashboard with local template:\n\n```\n[/]> cp templates/dashboards/new_dashboard remote/main_dashboard\n```\n\n* Move row from one dashboard to another (adds one more row to destination dashboard):\n\n```\n[/templates/dashboards]> cp main_dashboard/1-Top-Row new_dashboard\n```\n\n* Move row from one dashboard to another and replace existing row:\n\n```\n[/templates/dashboards]> cp main_dashboard/1-Top-Row new_dashboard/2-Some-Existing-Row\n```\n\n* Copy panel between rows (add one more panel to destination row).\n\n```\n[/templates/dashboards]> cp main_dashboard/1-Top-Row/1-Top-Panel new_dashboard/1-Top-Row\n```\n\n* Copy panel between rows and replace existing panel.\n\n```\n[/templates/dashboards]> cp main_dashboard/1-Top-Row/1-Top-Panel new_dashboard/1-Top-Row/2-Second-Panel\n```\n\n* Backup all dashboards.\n\n```\n[/] backup remote/example ~/backup.tgz\n```\n\n* Restore a backup.\n\n```\n[/] restore ~/backup.tgz remote/example\n```\n\n* Import dashboard from a file.\n\n```\n[/]> import ~/dashboard.json templates/dashboards/dashboard\n```\n\n* Export dashboard to a file.\n\n```\n[/]> export templates/dashboards/dashboard ~/dashboard.json\n```\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",36033012,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":65,"_128":21},"content_type","creator",90807,"full_size",36027409,"id",5486611,"images",[101],{"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":96,"_63":65,"_117":-5},"architecture","amd64","digest","sha256:6fba7d7e5dbcb07697335d8414ed1eddd95d6beda4a27964c064ec54193a017a","features","","last_pulled","2026-10-09T20:37:43.894215912Z","last_pushed","2016-10-16T17:56:26Z","os","linux","os_features","os_version","size","variant","2016-10-16T17:56:25.276186Z","last_updater","last_updater_username","media_type","latest","repository",983268,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":142,"_149":150,"_136":159,"_160":11},{"_40":143,"_42":144,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":145,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":62,"_64":65,"_66":-5,"_67":68,"_69":70,"_71":11,"_72":33,"_73":146,"_79":21,"_80":148,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":147},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_151":62,"_152":-5,"_153":-5,"_154":155},"count","next","previous","results",[156],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":157,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":65,"_128":21},[158],{"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":96,"_63":65,"_117":-5},[],"canDeleteTags","actionData","errors"]

f1yegor/grafcli

Tags for f1yegor/grafcli