Hosted Graphite Docs
Get StartedBook a Demo
  • Welcome to Hosted Graphite
  • Getting Started
  • HG-CLI
  • Sending Metrics
    • Supported Protocols
    • Graphite Tag Support
    • Metric Management
    • Metric APIs
  • Language Guide
    • Metric Libraries
    • .NET
    • Go
    • Java
    • Javascript
    • Node.js
    • PHP
    • Postman
    • Python 2.x
    • Python 3.x
    • Python Pickle
    • Ruby
    • Shell
    • TypeScript
  • Dashboard and Graphs
    • Primary Dashboards
    • Dashboard Library
    • Local Dashboard Integration
    • Worldmap Panel
    • Graphite Dashboard Guide
    • Graphite Graph Menu Reference
    • Other Dashboard Options
  • Alerting Guide
    • Alerting Overview
    • Alerts API
    • Notification Channels API
    • Scheduled Mutes API
    • Using Your Own Alerting
  • Agents Guide
    • The Hosted Graphite Agent
      • Base Metrics
      • System Layout
    • Telegraf
    • K8 Telegraf Daemon
    • OpenTelemetry
    • collectd Agent
    • StatsD Agent
    • Diamond
  • Add-Ons and Integrations Guide
    • AWS CloudWatch
    • Azure Monitor Metrics
    • GCP Metrics
    • Carbon-C-Relay
    • Circle CI
    • Cloudbees
    • Collectd Add Ons
    • GitHub
    • GitLab
    • Heroku
    • Hosted StatsD
    • New Relic
    • Papertrail
    • Pingdom
    • Sentry
    • Sitespeed
    • StatsD Add-on
    • Statuspage
  • Account Management
    • Access Keys
    • Account Diagnostics
    • Account Settings
    • Team Access: Limited Access Groups
    • SAML Authentication
    • Team Access
  • Additional Features
    • Aggregation Rules
    • Data Views
  • API Guides
    • Metrics API
    • Tag API
    • Graphite Render API
    • Render Variables API
    • Dashboard API
    • Annotations and Events API
    • Aggregation Rules API
    • Alerts APIs
  • FAQ
    • General
    • Business
    • Technical
    • Account Metrics and Limiting
    • Customization
    • Troubleshooting
    • Support
    • Changelog
Powered by GitBook
On this page

Was this helpful?

  1. Agents Guide

Diamond

To collect useful system metrics in Hosted Graphite such as System CPU, User CPU, Load Average, and Physical Memory you can use a python daemon called Diamond.

PreviousStatsD AgentNextAdd-Ons and Integrations Guide

Last updated 1 year ago

Was this helpful?

Diamond runs on your server, and intermittently sends these useful system metrics to Graphite. Here’s a quick primer on how to configure it.

Configuring Diamond

  • Download Diamond - Available at .

  • Install Diamond - Follow the installation instructions at .

  • Edit the config file - Usually located at /etc/diamond/diamond.conf

    1. At the top of the config file, add the HostedGraphiteHandler

    # Handlers for published metrics.
    handlers =  diamond.handler.hostedgraphite.HostedGraphiteHandler
    1. Under the [handlers] [[HostedGraphiteHandler]] section, set:

    apikey = YOUR_API_KEY
    timeout = 15
    batch = 1
    1. Under the [[default]] section, you can change how frequently metrics are reported:

    1. On our servers we also enable collectors for network metrics and MySQL:

    [[NetworkCollector]]
    enabled = True
    
    [[MySQLCollector]]
    enabled = True
    hosts = username:pass@localhost:3306/mysql,
    master = True
    innodb = True
  • More collectors - Here is a for various systems e.g. Hadoop, NetApp, Nginx, Postgres, RabbitMQ, Redis, and Zookeeper.

  • Start Diamond - Usually with /etc/init.d/diamond start but it may differ depending on your OS.

Diamond should now be configured to send data to Hosted Graphite and it will appear under the ‘servers’ entry in your tree of metrics. Once you start receiving Diamond metrics, an automatic Diamond dashboard will be created in your account which offers a great starting point and can be customized further.

https://github.com/BrightcoveOS/Diamond
https://github.com/BrightcoveOS/Diamond/wiki/Installation
full list of Diamond collectors