grafana-ds-convert allows Grafana users to convert assets like dashboards and alerts from different supported query languages to Circonus Analytics Query Language (CAQL).
Normal usage is to query against a Grafana instance for all dashboards in the config-specified folder, and translate all of the panel's query targets from Graphite, into an CAQL equivalent (via use of Circonus APIs). Alternatively, a local file (one graphite query per line) can be used as input.
Usage:
grafana-ds-convert [flags]
Flags:
-c, --config string config file (default: $HOME/.grafana-ds-convert.yaml|.json|.toml)
-f, --file string Take a local file to translate.
-h, --help help for grafana-ds-convert
--show-config string show config (json|toml|yaml) and exit
-v, --version show version and exit
For -f, If it's a .json file, assume it's a Grafana dashboard, otherwise graphite queries; one query per line. Will output translations to STDOUT.Config files may be in TOML, YAML, or JSON
# Global settings
debug = false
# Circonus section defines connection params to either
# IRONdb directly or the Circonus API
[circonus]
direct_irondb = false # whether or not to communicate directly with IRONdb
host = "api.circonus.com" # defaults to api.circonus.com, can be set to IRONdb node URI
port = "" # defaults to empty for Circonus API, set to HTTP port of IRONdb for direct IRONdb functionality
api_token = "<API Token>" # required for Circonus API, not required for direct IRONdb
account_id = <account_id>
# statsd_interval is the interval at which Circonus is receiving StatsD metrics (Default: 10s)
statsd_interval = 10
# statsd_aggregations section defines what to do with StatsD
# aggregations, and which ones to act on
[circonus.statsd_aggregations]
remove = true
agg_list = ["mean","sum","count_ps","count","upper","upper_90","upper_95","upper_99","median"]
# Optional period override (in seconds) for histogram:rate() and histogram:sum() to set period=Ns
# period = 10
# Grafana section defines parameters for connecting to Grafana and
# managing assets within Grafana
[grafana]
api_token = "<Grafana API Token>"
anonymous_auth = false # boolean value if Grafana supports anonymous auth, comment out api token if set
host = "<Grafana Host>" # e.g. "grafana.example.com"
port = "<Grafana Port>" # optional
path = "<Grafana Path>" # optional e.g. "grafana.example.com/<path>" include the leading "/"
src_folder = "<Source Folder>"
dest_folder = "<Destination Folder>"
# whether or not to connect with HTTP or HTTPS
secure = false
# name of the configured Circonus datasource
circonus_datasource = "<Datasource Name>"
# list of graphite datasource names to convert, leave empty to convert all
graphite_datasources = ["ds1", "ds2", "ds3"]
# the below setting nulls out alerts on panels
no_alerts = falseThe General folder (id=0) is special and is not part of the Folder API which means that you will need to move any dashboards within the General folder to another before conversion.