Welcome to our guide on how to install and configure Telegraf on FreeBSD 12. If you are looking at collecting and monitoring FreeBSD 12 system metrics, then you might want to use the powerful TIG stack monitoring and visualization tool. In this case, you can install Telegraf agent for collecting these metrics for analysis. <\/p>\n\n\n\n
We have covered the installation and setup of TIG stack on Fedora 30 in our previous guide. See the link below.<\/p>\n\n\n\n
Install and Setup TIG Stack on Fedora 30<\/a><\/p>\n\n\n\n Telegraf is already available on the default FreeBSD 12 repositories and hence can be installed directly using the PKG package manager.<\/p>\n\n\n\n Before you can run the installation of Telegraf, ensure that your system packages are re-synchronized to the latest versions.<\/p>\n\n\n\n Verify the availability of the Telegraf package on the FreeBSD 12 repos.<\/p>\n\n\n\n To install Telegraf on FreeBSD 12, run the command below;<\/p>\n\n\n\n Once the installation is done, enable Telegraf to run on system boot and then start it.<\/p>\n\n\n\n Configuration of Telegraf is similar across various systems. However, the location of the default configuration file varies with the OS variants. For the case of FreeBSD 12, the default Telegraf configuration file is located under, \/usr\/local\/etc\/telegraf.conf<\/strong>.<\/p>\n\n\n\n As you already know, Telegraf supports various input as well as output plugins. In a basic configuration, we will configure Telegraf to collect a number of system metrics and ingest them on InfluxDB time series database.<\/p>\n\n\n\n Hence, to create a configuration file with specific metrics input plugins, create a new configuration file using the telegraf command as shown below.<\/p>\n\n\n\n Next, edit the configuration file to define the InfluxDB (output plugin) connection details.<\/p>\n\n\n\n Replace the <Influx-DB-Host-IP><\/strong>, <influxdb-database><\/strong>, <influxdb-user><\/strong> and <Password><\/strong> with your connection details appropriately. Your configuration file in basic form should look like;<\/p>\n\n\n\n Next, ensure that there is a connection to the InfluxDB from the Telegraf agent server host, FreeBSD 12 in this case. You can test this with telnet, as shown below.<\/p>\n\n\n\n Restart Telegraf and run some basic configuration test.<\/p>\n\n\n\n To run configuration test;<\/p>\n\n\n\n Next, Login to InfluxDB and verify that system metrics from Telegraf agent are received. For example to check the CPU usage metrics;<\/p>\n\n\n\n Well, that looks good and that is just it about how to install and configure Telegraf on FreeBSD 12.<\/p>\n\n\n\n You can also check our related guides by following the links below;<\/p>\n\n\n\n Install Telegraf on Fedora 30\/Fedora 29<\/a><\/p>\n\n\n\n Install InfluxDB on Fedora 30\/Fedora 29<\/a><\/p>\n\n\n\n Install Grafana Monitoring Tool on Fedora 29<\/a><\/p>\n\n\n\n Install Grafana Metrics Monitoring Tool on Debian 9<\/a><\/p>\n\n\n\nInstall and Configure Telegraf on FreeBSD 12<\/h2>\n\n\n\n
Update and Upgrade System Packages<\/h3>\n\n\n\n
pkg update
pkg upgrade<\/code><\/pre>\n\n\n\npkg search telegraf
telegraf-1.10.1 Time-series data collection<\/code><\/pre>\n\n\n\nInstall Telegraf on FreeBSD 12<\/h3>\n\n\n\n
pkg install telegraf\nUpdating FreeBSD repository catalogue...\nFreeBSD repository is up to date.\nAll repositories are up to date.\nThe following 1 package(s) will be affected (of 0 checked):\n\nNew packages to be INSTALLED:\n\ttelegraf: 1.10.1\n\nNumber of packages to be installed: 1\n\nThe process will require 72 MiB more space.\n24 MiB to be downloaded.\n\nProceed with this action? [y\/N]: y<\/code><\/pre>\n\n\n\nStart and Enable Telegraf<\/h3>\n\n\n\n
sysrc telegraf_enable=yes\ntelegraf_enable: -> yes<\/code><\/pre>\n\n\n\nservice telegraf start\nStarting telegraf<\/code><\/pre>\n\n\n\nConfigure Telegraf on FreeBSD 12<\/h3>\n\n\n\n
mv \/usr\/local\/etc\/telegraf.conf \/usr\/local\/etc\/telegraf.conf.bak<\/code><\/pre>\n\n\n\ntelegraf config -input-filter cpu:mem:swap:system:processes -output-filter influxdb > \/usr\/local\/etc\/telegraf.conf<\/code><\/pre>\n\n\n\nvim \/usr\/local\/etc\/telegraf.conf<\/code><\/pre>\n\n\n\n...\n[[outputs.influxdb]]\n urls = [\"http:\/\/<Influx-DB-Host-IP>:8086\"]\n database = \"<influxdb-database>\"\n username = \"<influxdb-user>\"\n password = \"<Password>\"\n...<\/code><\/pre>\n\n\n\ntelnet 192.168.0.107 8086\nTrying 192.168.0.107\u2026\nConnected to 192.168.0.107.\nEscape character is '^]'.<\/code><\/pre>\n\n\n\nservice telegraf restart<\/code><\/pre>\n\n\n\ntelegraf -config \/usr\/local\/etc\/telegraf.conf -test<\/code><\/pre>\n\n\n\ninflux
Connected to http:\/\/localhost:8086 version 1.7.6
InfluxDB shell version: 1.7.6
Enter an InfluxQL query
> use telegraf
Using database telegraf
> auth
username: telegraf
password: StrongP@SS<\/strong>
> select * from cpu where host='freebsd12.example.com' and dc='freebsd12' limit 5<\/strong><\/code><\/pre>\n\n\n\nname: cpu\ntime cpu dc host usage_guest usage_guest_nice usage_idle usage_iowait usage_irq usage_nice usage_softirq usage_steal usage_system usage_user\n---- --- -- ---- ----------- ---------------- ---------- ------------ --------- ---------- ------------- ----------- ------------ ----------\n1557396600000000000 cpu-total freebsd12 freebsd12.example.com 0 0 99.13589945011783 0 0 0 0 0 0.4713275726630008 0.3927729772191673\n1557396600000000000 cpu0 freebsd12 freebsd12.example.com 0 0 99.13589945011783 0 0 0 0 0 0.4713275726630008 0.3927729772191673\n1557396610000000000 cpu-total freebsd12 freebsd12.example.com 0 0 99.84251968503936 0 0 0 0 0 0.15748031496062992 0\n1557396610000000000 cpu0 freebsd12 freebsd12.example.com 0 0 99.84251968503936 0 0 0 0 0 0.15748031496062992 0\n1557396620000000000 cpu-total freebsd12 freebsd12.example.com 0 0 99.84301412872841 0 0 0 0 0 0.15698587127158556 0<\/code><\/pre>\n\n\n\n