VS Code Extension for Grafana
VS Code Extension for Grafana is an extension for VSCode that allows you to view, edit, and preview a dashboard in a running instance of Grafana without opening a browser - and without having to save the changes remotely before you are done. No more cutting/pasting JSON!
This extension gives you support for Git (and any other version control system for that matter) when editing dashboards as JSON. If it is available in VS Code, it is available for you immediately.
This library is experimental
The code in this repository should be considered experimental. Documentation is only
available alongside the code. It comes without support, but we are keen to receive
feedback on the product and suggestions on how to improve it, though we cannot commit to
resolution of any particular issue. No SLAs are available. It is not meant to be used in
production environments, and the risks are unknown/high.
Additional information can be found in Release life cycle for Grafana Labs.
- Reads a dashboard JSON you have locally.
- Opens the dashboard configured in the JSON in a running Grafana instance, right inside your IDE.
- Allows you to edit the dashboard from the UI.
- Saves your changes to your JSON when you hit "Save" in the IDE panel.
- Have a dashboard JSON handy.
- Have a running instance of Grafana locally or have access to a hosted Grafana instance.
- If you intend to use a dashboard across multiple Grafana instances, you will need to use datasources that have been deployed via the API, as these datasources will require consistent UIDs.
Install from the Marketplace
- Select the Extensions icon () on the left bar in VSCode.
Grafana into the search box. Select the option for
Grafana / Grafana Editor and click
- Open the Settings tab inside the extension (CTRL+, (comma) or
, on Mac) and search for
grafana. Then select
Configure the Extension
- Provide the default URL for your Grafana instance in the
URL field. If you are using a local Grafana instance, the default value is
- Create a Service account in Grafana and add a token to it.
- In the VS Code settings, click
Set your token, securely then paste your token into the popup. Press ENTER.
Using the Extension
- Open a folder on your computer that has some dashboard JSON (if you don't have any of your own, navigate to the
dashboards folder of this repo).
- Right-click on a dashboard JSON file in the file explorer and select
Edit in Grafana.
- Have fun!
- Note, clicking
save on your dashboard will update the JSON file in your local folder.
Run from Repository
- If using local Grafana, start Grafana locally or via Docker.
yarn install in this repo.
- Open this repo VS Code, then press
F5 to start the extension locally.
- Continue from step 4 above.
To make changes to this codebase, follow the instructions about how to run from this repository. Then, in your original VS Code window, make changes to the extension. Then, restart the extension with either CTRL+SHIFT+F5 (CMD+SHIFT+F5 on a Mac) or by clicking the green restart circle.
To view debug logs, use CTRL+SHIFT+P (CMD+SHIFT+P on Mac) then select "Developer: Open Webview Developer Tools".
grafana-vscode.URL: Set the URL of the Grafana instance you want to open the dashboard in. Defaults to 'http://localhost:3000'.
grafana-vscode.service-account-token: A Service Account token. This is stored in the operating system secret store. Defaults to an empty string.
Extension communication with Grafana
Details of how this extension communicates with Grafana is available here.