cloudControl

Hosted Graphite provides a cloudControl add-on! The Hosted Graphite add-on is managed by the cloudControl command line client.

To install the add-on, issue the following command:

$ cctrlapp APP_NAME/DEP_NAME addon.add hostedgraphite.OPTION

Replace hostedgraphite.OPTION with a valid option, e.g. hostedgraphite.free.

When added, Hosted Graphite automatically creates a new user account with your email adress. You can manage the add-on within the web console by going to the specific deployment and clicking the link hostedgraphite.OPTION.

To upgrade from a smaller to a more powerful plan use:

$ cctrlapp APP_NAME/DEP_NAME addon.upgrade hostedgraphite.OPTION_OLD hostedgraphite.OPTION_NEW

To downgrade to a smaller plan use:

$ cctrlapp APP_NAME/DEP_NAME addon.downgrade hostedgraphite.OPTION_OLD hostedgraphite.OPTION_NEW

To remove the add-on, use:

$ cctrlapp APP_NAME/DEP_NAME addon.remove hostedgraphite.OPTION

For more information, check out the add-on documentation on cloudControl.

Accessing the API Key within your app

Now that the add-on has been setup, the Hosted Graphite API Key will be available via the environment variable HOSTEDGRAPHITE_APIKEY. See the appropriate language snippet below for an example on how to access this variable in your app.

Ruby

apikey = ENV['HOSTEDGRAPHITE_APIKEY']

See also: Sending Metrics with Ruby

Python

apikey = os.environ['HOSTEDGRAPHITE_APIKEY']

See also: Sending Metrics with Python

Java

String apikey = System.getenv("HOSTEDGRAPHITE_APIKEY");

See also: Sending Metrics with Java

PHP

$apikey = getenv('HOSTEDGRAPHITE_APIKEY');

See also: Sending Metrics with PHP

Node.js

var apikey = process.env.HOSTEDGRAPHITE_APIKEY;

See also: Sending Metrics with Node.js

Troubleshooting

  • If I have trouble with my metrics, should I remove and re-add the Hosted Graphite plugin?
    No! Removing the Hosted Graphite plugin permanently deletes your metrics from Hosted Graphite. If you’re having trouble and can’t find help in these docs or our FAQ, then just get in touch. We’re happy to help.