FreeBSD Host Integration
FreeBSD is a free and open-source Unix-like operating system. Monitoring FreeBSD hosts is easy with Wavefront. This integration steps you through installing and configuring the Wavefront proxy and the Telegraf. Telegraf is a light-weight server process capable of collecting, processing, aggregating, and sending metrics to a Wavefront proxy.
In addition to setting up the metrics flow, this integration also installs a dashboard. Here are the Summary and CPU sections of a dashboard displaying FreeBSD host metrics.
FreeBSD Host Setup
Step 1: Install and Configure the Wavefront Proxy Manually
- Download the Wavefront proxy jar and Wavefront config file.
- Open the
wavefront.conffile for edit, add the following proxy properties and save the file:
server = https://YOUR_CLUSTER.wavefront.com/api/ token = YOUR_API_TOKEN hostname = HOSTNAME
hostnamefield is for the machine on which the proxy is running. The name can have alphanumeric characters and periods, and must be unique. Wavefront does not use the hostname to tag your data but uses it to tag data internal to the proxy, such as JVM statistics, per-proxy point rates, and so on.
- Start the Wavefront proxy service:
sudo java -cp ./proxy-4.26-uber.jar \ -XX:+AggressiveHeap -Xss2049k -XX:OnOutOfMemoryError="kill -1 %p" \ -debug com.wavefront.agent.PushAgent -f ./wavefront.conf &
NOTE: If Java is not installed, run
pkg install openjdk8.
- Verify that the proxy has registered with the Wavefront server.
Step 2: Install and Configure the Telegraf Agent Manually
- Download the Telegraf package: amd64 / i386
- Extract the
telegraf-*.tar.gzfile and change the working directory to the extracted directory:
- Open the
./etc/telegraf/telegraf.conffile for edit, add the following information and save the file.
[[outputs.wavefront]] host = "WAVEFRONT_PROXY_ADDRESS" port = 2878 metric_separator = "." source_override = ["hostname", "agent_host", "node_host"] convert_paths = true # Enable net plugin [[inputs.net]]
- Start the Telegraf agent
./usr/bin/telegraf --config ./etc/telegraf/telegraf.conf