Stackhero for InfluxDB

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

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.

InfluxDB initial setup

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:

  1. Open the Stackhero dashboard.

    $ heroku addons:open ah-influxdb-stackhero
Opening ah-influxdb-stackhero for sharp-mountain-4005

  2. 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

  3. 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.

  4. When the token created, select its description to view it, and then choose Copy to clipboard to copy it to clipboard. InfluxDB token

  5. 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

Feedback

Log in to submit feedback.