grafana-all-in-one-release

Features

• Bosh Release to Deploy a single Job/VM with the following:

  • Graphite
  • Postgresql
  • Grafana

• Will auto-deploy statsd listener bound to Graphite w/ Postgres backend DB

• Will auto-deploy carbon

• Will auto-deploy graphite-web ( defaults to 8080 )

• Will auto-deploy grafana ( defaults to 80 )

• Will auto-register the graphite instance as a source in grafana

NOT Intended for Production use. Primarily for POCs & Dojos.

Requirements

• A functional BOSH instance on a supported IaaS/CPI
  • (bosh-lite can be used for dev & test)
  • (cloud config samples included for typical bosh deployment)
• The BOSH cli. Installation documentation can be found here

Installation / Deployment

1. Download the latest release from here.
2. Upload the release to your bosh target:

bosh upload release /tmp/grafana-all-in-one-release-#.tgz

3. Verify an ubuntu-trusty stemcell => 3262 is deployed:

$ bosh stemcells
Acting as user 'admin' on 'bosh'
+------------------------------------------+---------------+---------+----------------------------------------------------+
| Name                                     | OS            | Version | CID                                                |
+------------------------------------------+---------------+---------+----------------------------------------------------+
| bosh-azure-hyperv-ubuntu-trusty-go_agent | ubuntu-trusty | 3262.2* | bosh-stemcell-48e110cc-4897-440e-920c-cde986456f1a |
+------------------------------------------+---------------+---------+----------------------------------------------------+

4. Generate a manifest for grafana-all-in-one-release. Sample manifests can be found here.
   • There are cloud-config samples for multiple CPI's. Cloud config manifests are deployed as such after the samples have been updated for your IaaS:

   • bosh update cloud-config sample_manifests/cloud-config-[IAAS]/cloud-config.yml
     

5. Edit & Deploy the sample_manifests/grafana-all-in-one.yml manifest. It can typically be deployed with no modification when using cloud config:

bosh deployment sample_manifests/grafana-all-in-one.yml
bosh -n deploy

* The `sample_manifests/bosh-lite/graphite-bosh-lite.yml` manifest can be used with [bosh-lite](https://github.com/cloudfoundry/bosh-lite) for quick testing and devlopment
* If using bosh-lite, you will need to add a custom route to access the resultant instance on your desktop.  For example, with default bosh-lite network settings on a mac, you would exec:
<pre><code>sudo route -n add 10.244.0.0/19 192.168.50.4</code></pre>

6. After the deployment has succeeded, generate some sample data to statsd. This can be done by:

   scripts/gen_stats.sh [IP ADDR OF GRAFANA JOB] [STATSD PORT/Defaults to 8125]

   • Next log into Grafana UI [default creds = grafana/gr4f4n4] ...
   • & then track the new "foo" metrics...

Development

Documentation on the bosh release development process can be found here.

Please file any bugs/frs here.

Helpful notes:

• If attempting to build the release from source bosh sync blob, you may experience the following error:

  simple_blobstore_client.rb:44:in `get_file': Could not fetch object, 404/ (Bosh::Blobstore::BlobstoreError)

  • This can typically be resolved by creating a config/private.yml manifest with appropriate s3 creds. More data can be found here.