> For the complete documentation index, see [llms.txt](https://docs.hostedgraphite.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hostedgraphite.com/agents-guide/collectd-agent.md).

# collectd Agent

collectd is a simple monitoring client which can be installed on most Linux systems. To simplify the setup, we provide a configuration file for you to use

### Installing and configuring collectd

* Install [collectd](https://collectd.org/documentation.shtml) on your system. It’s usually available via your normal package manager, e.g. `apt-get install collectd`
* From the Hosted Graphite Add-ons page, select collectd and download the appropriate configuration file. Version 5.4 works with most versions of collectd
* Copy the downloaded configuration file to `/etc/collect/collectd.conf`. If you want to keep the original configuration file, rename it to collectd.conf.old
* Configure optional plugins to collect data from many different technologies and running processes on your servers, see their table of plugins [here](https://collectd.org/wiki/index.php/Table_of_Plugins)
* Restart collectd so that it uses the new configuration file, and metrics will appear in your Hosted Graphite account, prefixed with `collectd`

### **Generating and viewing the collectd dashboard**

Once collectd is up and running, you can automatically generate a dashboard from our dashboard library. Navigate to Dashboards => [Dashboard Library](https://docs.hostedgraphite.com/dashboard-and-graphs/dashboard-library) and click 'Generate'.

<figure><img src="https://495119770-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZtHmoGZNsmARIViZEdbz%2Fuploads%2FOiJ3ljwpI9A8kfEO37ez%2Fcollectd-agent.png?alt=media&amp;token=84a84953-37a3-4ef2-9b0f-f272c810fbc6" alt=""><figcaption></figcaption></figure>

For more detailed information on how to manually configure collectd, see our [collectd doc](/add-ons-and-integrations-guide/collectd-add-ons.md) in the Add-Ons and Integrations Guide.