Skip to content

Grafana Plugin for querying files on AWS S3 using S3 Select API

License

Notifications You must be signed in to change notification settings

tvarit-foggy/grafana-s3-plugin

Repository files navigation

AWS S3 Plugin tvarit-foggy

This plugin queries files on AWS S3 using S3 Select API

Config Editor Query Editor



Installation

To install, download zip file from release page (for stable version) or download repository as zip file (for installing from git master)

grafana-cli --pluginUrl <path_to_zip_file> plugins install tvarit-s3-datasource

The plugin is not signed. To enable this plugin, change the following

[plugins]
...
# Enter a comma-separated list of plugin identifiers to identify plugins that are allowed to be loaded even if they lack a valid signature.
allow_loading_unsigned_plugins =

to

[plugins]
...
# Enter a comma-separated list of plugin identifiers to identify plugins that are allowed to be loaded even if they lack a valid signature.
allow_loading_unsigned_plugins = tvarit-s3-datasource

File Upload

To allow file upload from inbuilt file browser, add the following CORS policy in the bucket permissions (replace <<>> with the url in your browser)

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
    <AllowedOrigin><<<URL>>></AllowedOrigin>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedMethod>POST</AllowedMethod>
    <AllowedMethod>DELETE</AllowedMethod>
    <ExposeHeader>ETag</ExposeHeader>
    <AllowedHeader>*</AllowedHeader>
</CORSRule>
<CORSRule>
    <AllowedOrigin>*</AllowedOrigin>
    <AllowedMethod>GET</AllowedMethod>
</CORSRule>
</CORSConfiguration>

Reference Links

S3 Select API Reference: https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html
Query Reference: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html