M2X Heroku Ruby Demo
Introduction
This repo provides a framework for a Heroku application with Ruby code that reports data to AT&T M2X. The application reports the current system load every minute.
Please note that the Heroku machine and M2X are using times in UTC, not in your local time zone.
Pre-Requisites
You will need to have an account on Heroku. Because this example application uses only one Heroku dyno, it should be free for you to use, no matter how many other applications you have.
You will also need an account on AT&T's M2X service (m2x.att.com), which is currently free to everyone. (Future plans call for M2X to keep a free "Developer" plan, but to charge for very large volumes of data.)
You will need the Heroku Toolbelt installed and configured with your Heroku login credentials.
Installation
Creating Your Application
git clone https://github.com/attm2x/m2x-demo-heroku-ruby.git
cd m2x-demo-heroku-ruby
heroku apps:create APPNAME
M2X API Key
Next you'll need to get your M2X API Master Key. Log into M2X, and click your name in the upper right-hand corner, then the "Account Settings" dropdown, then the "Master Keys" tab. Here's a direct link. Copy the Master Key and paste it into the m2x_api_key.txt file. It's just the API key, by itself, in a text file.
Then you'll need to send those changes to Heroku:
git add m2x_api_key.txt
git commit -m "Updating to use my correct API key."
git push heroku master
Another way of setting the M2X API Master Key is using Heroku environment variables:
heroku config:set M2X_API_KEY=<Your M2X API key>
Either one works okay here
Scaling Your Application
Now your code should be uploaded. However, because you're using the "Clock" process type, your code isn't running automatically. You'll need to scale the number of clock workers to 1:
heroku ps:scale clock=1
Testing
Your loadreport.rb should now be reporting the system load to AT&T M2X every minute.
If there are any errors from loadreport.rb, they will be logged via Heroku's log system. Use heroku logs --tail to see the live output from your application.
License
This library is released under the MIT license. See LICENSE for the terms.