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
  • Linux Systems
  • Macos
  • Windows (via Powershell)
  • Telegraf Input Plugins

Was this helpful?

  1. Agents Guide

Telegraf

Telegraf is an easy to use monitoring client compatible with many operating systems that has a Graphite output plugin, and many useful input plugins for collecting a wide variety of system metrics.

PreviousSystem LayoutNextK8 Telegraf Daemon

Last updated 2 months ago

Was this helpful?

Contents

Ubuntu/Debian (AMD)

wget https://dl.influxdata.com/telegraf/releases/telegraf_1.30.0-1_amd64.deb
sudo dpkg -i telegraf_1.30.0-1_amd64.deb

RedHat/CentOS

wget https://dl.influxdata.com/telegraf/releases/telegraf-1.30.0-1.x86_64.rpm
sudo yum localinstall telegraf-1.30.0-1.x86_64.rpm
  1. Locate the configuration file at /etc/telegraf/telegraf.conf and open it in your preferred text editor, or a VIM shell. Make the following changes to the telegraf.conf file:

    • uncomment/configure the following lines:

    [[outputs.graphite]]

    servers = ["carbon.hostedgraphite.com:2003"]

    prefix = "YOUR_API_KEY.telegraf"

    • alternatively, you can download a preconfigured telegraf.conf file from the Agents => Telegraf as mentioned above. Download the preconfigured file, move it to /etc/telegraf, and replace the original.

  2. Save your changes and start the telegraf service: sudo service telegraf start or sudo systemctl start telegraf. Within minutes, telegraf will start sending metrics into your Hosted Graphite account (with the ‘telegraf’ prefix).

  3. Troubleshoot errors by running telegraf in the root directory of the telegraf.conf file: telegraf --config /etc/telegraf/telegraf.conf

  1. Install Telegraf: brew install telegraf

    1. Packages are usually installed at: /usr/local/etc/ (intel) or: /opt/homebrew/etc/ (silicon)

  2. Similar to the Linux steps listed above, locate the configuration file and open it in your preferred text editor. Uncomment/configure the following lines in your telegraf.conf file:

[[outputs.graphite]]

servers = ["carbon.hostedgraphite.com:2003"]

prefix = "YOUR_API_KEY.telegraf"

  1. Restart telegraf: brew services restart telegraf. Metrics usually take about 3-5 minutes to appear in your Hosted Graphite account and will include the ‘telegraf’ prefix in the name.

  2. Additionally, you can ‘serve’ the telegraf.conf file which can be helpful for troubleshooting any configuration issues: telegraf --config /etc/telegraf/telegraf.conf

  1. Download Telegraf using the wget command (an alias for Invoke-Webrequest) and unzip it:

wget https://dl.influxdata.com/telegraf/releases/telegraf-1.5.2_windows_amd64.zip -O telegraf-1.5.2_windows_amd64.zip
Expand-Archive .\telegraf-1.5.2_windows_amd64.zip
  1. Create a directory in Program Files, move the two telegraf files into it, and change the directory to the same location:

mkdir 'C:\Program Files\Telegraf'
mv .\telegraf-1.5.2_windows_amd64\telegraf\*.* 'C:\Program Files\Telegraf'
cd 'C:\Program Files\Telegraf'
  1. Create a new configuration file that includes the Graphite output-filter.

./telegraf.exe --output-filter graphite config > telegraf.conf
  1. Open the telegraf.conf file using your preferred text editor. Uncomment the section titled [[outputs.graphite]] and uncomment/update the servers and prefix options:

[[outputs.graphite]]
   servers = ["carbon.hostedgraphite.com:2003"]
   prefix = "YOUR_API_KEY.telegraf"
  1. Install telegraf to your services, and start it up:

./telegraf.exe -service install -config 'C:\Program Files\telegraf\telegraf.conf'
net start telegraf

Once telegraf is installed, you can download a custom telegraf config in your Hosted Graphite account if you navigate to Agents => Telegraf. Then install telegraf using the steps below, and replace the default config with the custom config at the path that telegraf is installed at.

Download Telegraf and unzip it (see the for up-to-date versions and installation commands for many operating systems). Packages and files are generally installed at /etc/telegraf/

Note: The link for the most up-to-date version of the config file can be found on the .

Metrics will now appear in your Hosted Graphite account with the ‘telegraf’ prefix. More options for collecting Windows metrics include using the Windows Performance Counters plugin, which you can read more about in the ).

We love the Telegraf agent because it offers a wide variety of easy-to-install that allow you to collect additional metrics from a range of popular services and technologies like:

Database (, , , , , )

Network (, , , , , , , , , , )

DNS (, , )

MQTT (, )

Apache (, , , , , , )

System Applications/Running Processes: (, )

Other: (, , , , , , , , , , , , , and many more!)

If you need help or advice on configuring the telegraf agent to include some input plugins, send us a message at and we would be happy to walk you through the process.

telegraf installation docs
Telegraf downloads page
win_perf_counters docs
input plugins
MySQL
PostgreSQL
MongoDB
Redis
Riak
RethinkDB
SNMP
Cisco Telemetry
Nstat
SFlow
IPtables
Bond
Ethtool
LeoFS
InfiniBand
JTI
Ping
Unbound
PowerDNS
NSD
RabbitMQ
ActiveMQ
Aurora
Kafka
Mesos
Solr
Tomcat
CouchDB
Zipkin
Procstat
Monit
Kubernetes
Jenkins
Jolikia
Elasticsearch
Logstash
Kibana
Nginx
HAproxy
uWSGI
Docker
GitHub
Mailchimp
Salesforce
support@hostedgraphite.com
Linux Systems
Macos
Windows (via Powershell)
Telegraf Input Plugins
Telegraf
Linux Systems
Macos
Windows (via Powershell)
Telegraf Input Plugins
Telegraf Video Tutorial
Custom Telegraf Config