Plugins 〉Amazon Timestream
The Timestream datasource plugin provides a support for Amazon Timestream. Add it as a data source, then you are ready to build dashboards using timestream query results
Add the data source
- In the side menu under the Configuration link, click on Data Sources.
- Click the Add data source button.
- Select Timestream in the Time series databases section.
The Timestream plugin authentication system matches the standard Cloudwatch plugin system. See the grafana documentation for authentication options and setup.
Once authentication is configured, click "Save and Test" to verify the service is working. Once this is configured, you can specify default values for the configuration.
The query editor accepts timestream syntax in addition to the macros listed above and any dashboard template variables.
ctrl+space to open open the IntelliSense suggestions
To simplify syntax and to allow for dynamic parts, like date range filters, the query can contain macros.
|$__database||Will specify the selected database. This may use the default from the datasource config, or the explicit value from the query editor.|
|$__table||Will specify the selected database. This may use the default from the datasource config, or the explicit value from the query editor.|
|$__measure||Will specify the selected measure. This may use the default from the datasource config, or the explicit value from the query editor.|
|$__timeFilter||Will be replaced by an expression that limits the time to the dashboard range|
|$__interval_ms||Will be replaced by a number that represents the amount of time a single pixel in the graph should cover|
Using Variables in Queries
Grafana template variables can be used in query Timestream query. See the grafana documentaiton on template variables for more information on how to setup and use variables.
Disabling quoting for multi-value variables
Grafana automatically creates a quoted, comma-separated string for multi-value variables. For example: if
server02 are selected then it will be formatted as:
'server01', 'server02'. To disable quoting, use the csv formatting option for variables:
Read more about variable formatting options in the Variables documentation.
See the Alerting documentation for more on Grafana alerts.
Configure the data source with provisioning
You can configure data sources using config files with Grafana's provisioning system. You can read more about how it works and all the settings you can set for data sources on the provisioning docs page.
Here are some provisioning examples for this data source.
Using a credentials file
If you are using Credentials file authentication type, then you should use a credentials file with a config like this.
- name: Timestream type: grafana-timestream-datasource jsonData: authType: credentials defaultRegion: us-east-1
- name: Timestream type: grafana-timestream-datasource jsonData: authType: keys defaultRegion: us-east-1 secureJsonData: accessKey: ‘<your access key>’ secretKey: ‘<your secret key>’
This plugin contains one sample dashboard. Please consult the Sample Application section in the official Timestream doc to set it up.
Installing Amazon Timestream on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Data Source
Use the grafana-cli tool to install Amazon Timestream from the commandline:
grafana-cli plugins install
The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Configure the Data Source
Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.
Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.
To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.
All notable changes to this project will be documented in this file.
- Execute each query in its own request, this will support multiple queries that require multiple pages to complete
- Upgrade shared authenticaiton library
- Bump minimum grafana runtime to 7.5
- fix bug with supporting multi-page timeseries results
- Use a shared authentication library and UI component
- Bump minimum grafana runtime to 7.4
- Support $__timefilter on armhf (#52, @mg-arne)
- Add $__now_ms macro (#49, @squalou)
- Fixed region picker default values
- Fix template variable queries
- Only show valid regions
- Avoid double escaping
- support template variables in query
- Updated authentication to match builtin cloudwatch authentication
- Include query status in metadata
- Examples and query suggestions now quote all names
- Initial Release
Introducing the new Open Distro for Elasticsearch plugin for Grafana, also available in Amazon Managed Service for Grafana
Blog post 3 min
Want to visualize software development insights with Grafana? With our new Jira Enterprise plugin, you can!
Blog post 5 min
A closer look at the admin API and plugin for centralized tenant adminstration and control in Grafana Enterprise Logs
Blog post 4 min
The new Splunk Infrastructure Monitoring plugin brings the SaaS formerly known as SignalFx to your Grafana dashboards
Blog post 5 min
The Splunk plugin for Grafana now supports data links for jumping directly from logs to traces
Blog post 5 min
With the new AWS IoT SiteWise plugin, you can visualize and monitor your equipment data in Grafana dashboards
Blog post 2 min
The new Wavefront Enterprise plugin brings the high-scale, high-speed SaaS to your Grafana dashboards
Blog post 5 min