terraform/website/source/docs/providers/grafana/r/data_source.html.md

2.5 KiB

layout page_title sidebar_current description
grafana Grafana: grafana_data_source docs-influxdb-resource-data-source The grafana_data_source resource allows a Grafana data source to be created.

grafana_data_source

The data source resource allows a data source to created on a Grafana server.

Example Usage

The required arguments for this resource vary depending on the type of data source selected (via the type argument). The following example is for InfluxDB. See Grafana's Data Sources Guides for more details on the supported data source types and the arguments they use.

resource "grafana_data_source" "metrics" {
  type          = "influxdb"
  name          = "myapp-metrics"
  url           = "http://influxdb.example.net:8086/"
  username      = "myapp"
  password      = "foobarbaz"
  database_name = "${influxdb_database.metrics.name}"
}

Argument Reference

The following arguments are supported:

  • type - (Required) The data source type. Must be one of the data source keywords supported by the Grafana server.

  • name - (Required) A unique name for the data source within the Grafana server.

  • url - (Required) The URL for the data source. The type of URL required varies depending on the chosen data source type.

  • is_default - (Optional) If true, the dashboard will be shown as the root page on the Grafana server. Only one dashboard on a server can be the default.

  • basic_auth_enabled - (Optional) - If true, HTTP basic authentication will be used to make requests.

  • basic_auth_username - (Required if basic_auth_enabled is true) The username to use for basic auth.

  • basic_auth_password - (Required if basic_auth_enabled is true) The password to use for basic auth.

  • username - (Required by some data source types) The username to use to authenticate to the data source.

  • password - (Required by some data source types) The password to use to authenticate to the data source.

  • database_name - (Required by some data source types) The name of the database to use on the selected data source server.

  • access_mode - (Optional) The method by which the browser-based Grafana application will access the data source. The default is "proxy", which means that the application will make requests via a proxy endpoint on the Grafana server.

Attributes Reference

The resource exports the following attributes:

  • id - The opaque unique id assigned to the data source by the Grafana server.