Help build the future of open source observability software Open positions

Check out the open source projects we support Downloads

Grot cannot remember your choice unless you click the consent notice at the bottom.


Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.


DynamoDB datasource for Grafana - Beta

Note: The latest release of this datasource plug is Beta. Bugs may occur.

The DynamoDB datasource allows a direct connection to DynamoDB to query and visualize DynamoDB data in Grafana.

This datasource supports PartiQL and provides an editor to format and color code your PartiQL statements.

Note: This plugin is for Grafana Enterprise only.


For detailed instructions on how to install the plugin on Grafana Cloud or locally, please checkout the Plugin installation docs.

Manual configuration

Once the plugin is installed on your Grafana instance, follow these instructions to add a new DynamoDB data source, and enter configuration options.

With a configuration file

It is possible to configure data sources using configuration files with Grafana’s provisioning system. To read about how it works, including all the settings that you can set for this data source, refer to Provisioning Grafana data sources.

Here are some provisioning examples for this data source using basic authentication:

apiVersion: 1
  - name: DynamoDB
    type: grafana-dynamodb-datasource
      region: us-west-2
      accessId: AID1234567
      accessKey: xxxxxxxxx

Time series

Time series visualization options are selectable after adding a datetime field type to your query. This field will be used as the timestamp. You can select time series visualizations using the visualization options. Grafana interprets timestamp rows without explicit time zone as UTC. Any column except time is treated as a value column.

Multi-line time series

To create multi-line time series, the query must return at least 3 fields in the following order:

  • field 1: datetime field with an alias of time
  • field 2: value to group by
  • field 3+: the metric values

For example:

SELECT log_time AS time, machine_group, avg(disk_free) AS avg_disk_free
FROM mgbench.logs1
GROUP BY machine_group, log_time
ORDER BY log_time

Templates and variables

To add a new DynamoDB query variable, refer to Add a query variable.

After creating a variable, you can use it in your DynamoDB queries by using Variable syntax. For more information about variables, refer to Templates and variables. |

Learn more