
This add-on is operated by Stackhero
InfluxDB on dedicated instances, up-to-date versions and attractive prices.
Stackhero for InfluxDB
Last updated January 24, 2022
Table of Contents
Stackhero for InfluxDB provides a preconfigured and ready to use InfluxDB instance, running on a fully dedicated instance. Stackhero for InfluxDB is easy to set up, fast, and has simple and predictive pricing: writes, queries, dashboards, tasks, buckets, and network transfers are unlimited.
The Stackhero for InfluxDB add-on provides the following features:
- A private instance (dedicated VM)
- A dedicated public IP (v4)
- Super fast servers with SSD disks
- TLS encryption (aka SSL)
- An automatic backup every 24 hours
- One click to update to new InfluxDB versions
Provisioning the Add-on
Stackhero for InfluxDB can be attached to a Heroku application via the CLI:
A list of all plans available can be found here.
$ heroku addons:create ah-influxdb-stackhero --app <your app name>
-----> Adding ah-influxdb-stackhero to sharp-mountain-4005... done
Configuring the Initial User
Before you can use InfluxDB, you must setup the initial user. To setup the initial user, open the Stackhero dashboard:
$ heroku addons:open ah-influxdb-stackhero
Opening ah-influxdb-stackhero for sharp-mountain-4005
Next, select your InfluxDB instance, and then choose Admin panel. Use the InfluxDB web UI to setup your initial user.
You must create a token before your app can connect to InfluxDB.
Creating a Token
Your app must have a token to connect to InfluxDB.
To create a token:
Open the Stackhero dashboard.
$ heroku addons:open ah-influxdb-stackhero Opening ah-influxdb-stackhero for sharp-mountain-4005
Retrieve your InfluxDB credentials by selecting the “Configure” button. You need your InfluxDB credentials to generate a token. You can also retrieve your credentials from the CLI:
$ heroku config:get STACKHERO_INFLUXDB_ADMIN_USERNAME $ heroku config:get STACKHERO_INFLUXDB_ADMIN_PASSWORD
Select your InfluxDB instance, and then choose Admin panel. Select Data, Tokens, Generate token and select choose Read/write token. Provide a description, select the bucket your token has access to then save.
When the token created, select its description to view it, and then choose Copy to clipboard to copy it to clipboard.
In the CLI, add the token to your environment variables:
$ heroku config:set STACKHERO_INFLUXDB_TOKEN=<yourToken> Setting RAILS_ENV and restarting ⬢ ah-influxdb-stackhero... done
Client Libraries
InfluxDB can be accessed directly from its HTTP API or from a client library. For more information about client libraries, see the official InfluxDB documentation.
To connect to your instance, you can retrieve its hostname with the following command:
heroku config:get STACKHERO_INFLUXDB_HOST
You can also read the environment variable STACKHERO_INFLUXDB_HOST
in your application.
Local Setup
After you provision the add-on, you must replicate its config variables locally.
Use the Heroku Local command-line tool to configure, run, and manage process types specified in your app’s Procfile. Heroku Local reads configuration variables from an .env
file. To view all of your app’s config variables, type heroku config
. Use the following command for each value you want to add to your .env
file:
heroku config:get <STACKHERO_INFLUXDB_VARIABLE> -s >> .env
For example:
$ heroku config:get STACKHERO_INFLUXDB_HOST -s >> .env
$ echo "STACKHERO_INFLUXDB_TOKEN=<TOKEN>" >> .env
Replace <TOKEN>
with the token you’ve generated.
Don’t commit credentials and other sensitive configuration values to source-control. In Git, exclude the .env
file with: echo .env >> .gitignore
.
For more information, see the Heroku Local article.
Dashboard and InfluxDB Console Web UI
You can use the Stackhero dashboard to see instance usage, restart an instance, and apply updates. You can also access the InfluxDB console web UI.
You can access the dashboard via the CLI:
$ heroku addons:open ah-influxdb-stackhero
Opening ah-influxdb-stackhero for sharp-mountain-4005
You can also visit the Heroku Dashboard, select your application, and then select Stackhero for InfluxDB from the Add-ons menu.
Upgrading Your Plan
You can’t downgrade an existing add-on.
Use the heroku addons:upgrade
command to migrate to a new plan.
$ heroku addons:upgrade ah-influxdb-stackhero:newplan
-----> Upgrading ah-influxdb-stackhero:newplan to sharp-mountain-4005... done
Your plan has been updated to: ah-influxdb-stackhero:newplan
Manage migration timing to ensure your application is available during the migration process.
Removing the Add-on
You can remove Stackhero for InfluxDB via the CLI:
This will destroy all associated data and can’t be undone!
$ heroku addons:destroy ah-influxdb-stackhero
-----> Removing ah-influxdb-stackhero from sharp-mountain-4005... done
Support
Stackhero for InfluxDB support and runtime issues should be submitted via one of the Heroku Support channels. We recommend adding support@stackhero.io in copy for urgent issues.
Additional Resources
- InfluxDB documentation by Stackhero
- InfluxDB managed cloud