Skip to content
/ hamara Public

Export datasource from the existing Grafana DB into a YAML provisioning file

License

Notifications You must be signed in to change notification settings

trivago/hamara

Repository files navigation

Logo

Build Status Codecov branch Report Card

Build Status Docker Automated build Docker Image Size

hamara is a tool to export datasources from the existing Grafana DB into a YAML provisioning file by utilizing the Grafana REST API.

Usage

Retrieve datasources from existing Grafana and export it into a YAML provisioning file

Usage:
  hamara export [flags]

Flags:
  -h, --help          help for export
  -H, --host string   Grafana host
  -k, --key string    API key with Admin rights from Grafana

or using Docker:

docker run --rm trivago/hamara

Example

export GRAFANA_API_KEY=<your API key here>
hamara export --host=localhost:3000 --key=$GRAFANA_API_KEY > datasources.yaml
cat datasources.yaml

or using Docker (MacOS/Windows):

export GRAFANA_API_KEY=<your API key here>
docker run --rm trivago/hamara ./hamara export --host=host.docker.internal:3000 --key=$GRAFANA_API_KEY > datasources.yaml
cat datasources.yaml

or using Docker (Linux):

export GRAFANA_API_KEY=<your API key here>
docker run --add-host host.docker.internal:host-gateway --rm trivago/hamara ./hamara export --host=host.docker.internal:3000 --key=$GRAFANA_API_KEY > datasources.yaml
cat datasources.yaml

Installation Options

  1. Download the hamara binary from Releases tab.

  2. Install with go get (Installed Go required)

    • $ go get -u github.com/trivago/hamara
    • $ hamara

How to Contribute

  1. Clone repo and create a new branch: $ git checkout https://github.com/trivago/hamara -b name_for_new_branch.
  2. Make changes and test
  3. Submit Pull Request with comprehensive description of changes