TrueNas/telegraf - Revision history

R00t at 02:39, 12 September 2022

2022-09-12T02:39:31Z

R00t: /* TrueNAS telegraf setup */

2022-09-11T07:11:21Z

‎TrueNAS telegraf setup

R00t: /* Final steps */

2022-09-11T07:05:51Z

‎Final steps

R00t: /* Final steps */

2022-09-11T04:54:20Z

‎Final steps

R00t: /* TrueNAS telegraf setup */

2022-09-11T03:54:25Z

‎TrueNAS telegraf setup

R00t: Created page with "=Overview= reference: [https://blog.victormendonca.com/2020/10/28/how-to-install-telegraf-on-freenas/ https://blog.victormendonca.com/2020/10/28/how-to-install-telegraf-on-fre..."

2022-09-11T03:52:55Z

Created page with "=Overview= reference: [https://blog.victormendonca.com/2020/10/28/how-to-install-telegraf-on-freenas/ https://blog.victormendonca.com/2020/10/28/how-to-install-telegraf-on-fre..."

New page

=Overview=
reference: [https://blog.victormendonca.com/2020/10/28/how-to-install-telegraf-on-freenas/ https://blog.victormendonca.com/2020/10/28/how-to-install-telegraf-on-freenas/]<br>
Setup and configure telegraf for TrueNAS (and probably any other FreeBSD OS)

=Download and extract telegraf tar.gz=
Find the latest telegraf release here<br>
[https://github.com/influxdata/telegraf/releases https://github.com/influxdata/telegraf/releases]<br>
Download and extract it on a vm with GNUtar (ubuntu, centos, etc) as tar included with FreeBSD will not unpack it.

=Copy files over=
You only need (2) files, the binary and conf file. Copy them over to TrueNAS.
<nowiki>~$ ./telegraf-[version]/usr/bin/telegraf
./telegraf-[version]/etc/telegraf/telegraf.conf</nowiki>

=TrueNAS telegraf setup=
Create the directory your files will live in. I chose <code>/usr/local/telegraf-[version]_freebsd_amd64</code> because <code>/usr/local/</code> is the closest thing to <code>/opt/</code> in freebsd
<nowiki>~$ sudo mkdir /usr/local/telegraf-[version]_freebsd_amd64
~$ cp /tmp/telegraf* /usr/local/telegraf-[version]_freebsd_amd64

==Create the init script==
Modify the telegraf conf and bin dir vars.
<nowiki>~$ sudo vim /usr/local/telegraf-1.23.4_freebsd_amd64/telegraf.init
#!/bin/sh
# $FreeBSD$

# PROVIDE: telegraf
# REQUIRE: DAEMON NETWORKING
# BEFORE: LOGIN
# KEYWORD: shutdown

# Add the following lines to /etc/rc.conf to enable telegrafb:
# telegraf_enable="YES"
#
# telegraf_enable (bool): Set to YES to enable telegraf
# Default: NO
# telegraf_conf (str): telegraf configuration file
# Default: ${PREFIX}/etc/telegraf.conf
# telegraf_flags (str): Extra flags passed to telegraf

. /etc/rc.subr

name="telegraf"
rcvar=telegraf_enable

load_rc_config "${name}"
: ${telegraf_enable:="YES"}
: ${telegraf_flags:="-quiet"}
: ${telegraf_conf:="/usr/local/telegraf-1.23.4_freebsd_amd64/telegraf.conf"}
: ${telegraf_bindir:="/usr/local/telegraf-1.23.4_freebsd_amd64"}

pidfile="/var/run/${name}.pid"
command=/usr/sbin/daemon
command_args="-crP ${pidfile} ${telegraf_bindir}/${name} ${telegraf_flags} -config=${telegraf_conf}"

telegraf_prestart() {
# Have to empty rc_flags so they don't get passed to daemon(8)
touch $pidfile
rc_flags=""
}

telegraf_start() {
${command} ${command_args} ${rc_arg} >> /var/log/telegraf.log 2>&1
}

start_precmd="${name}_prestart"
start_cmd="${name}_start"

run_rc_command "$1"</nowiki>

==Final steps==
create a symlink for telegraf.init
<nowiki>~ ln -s /usr/local/telegraf-1.23.4_freebsd_amd64/telegraf.init /usr/local/etc/rc.d/telegraf</nowiki>
test the service
<nowiki>~$ service telegraf start</nowiki>

@@ Line 3: / Line 3: @@
 Setup and configure telegraf for TrueNAS (and probably any other FreeBSD OS)
-=Download and extract telegraf tar.gz=
+=Dependencies=
 Find the latest telegraf release here<br>
 [https://github.com/influxdata/telegraf/releases https://github.com/influxdata/telegraf/releases]<br>
 Download and extract it on a vm with GNUtar (ubuntu, centos, etc) as tar included with FreeBSD will not unpack it.
-=Copy files over=
+==Copy files over==
 You only need (2) files, the binary and conf file.  Copy them over to TrueNAS.
   <nowiki>~$ ./telegraf-[version]/usr/bin/telegraf
@@ Line 89: / Line 90: @@
 Add the following lines to /etc/rc.conf to enable telegrafb:
   <nowiki>telegraf_enable="YES"</nowiki>

@@ Line 14: / Line 14: @@
 =TrueNAS telegraf setup=
 Create the directory your files will live in.  I chose <code>/usr/local/telegraf-[version]_freebsd_amd64</code> because <code>/usr/local/</code> is the closest thing to <code>/opt/</code> in freebsd
   <nowiki>~$ sudo mkdir /usr/local/telegraf-[version]_freebsd_amd64
 ~$ cp /tmp/telegraf* /usr/local/telegraf-[version]_freebsd_amd64</nowiki>
 ==Create the init script==

@@ Line 69: / Line 69: @@
 ==Final steps==
 create a symlink for telegraf.init
-  <nowiki>~ ln -s /usr/local/telegraf-1.23.4_freebsd_amd64/telegraf.init /usr/local/etc/rc.d/telegraf</nowiki>
+  <nowiki>~$ ln -s /usr/local/telegraf-1.23.4_freebsd_amd64/telegraf.init /usr/local/etc/rc.d/telegraf</nowiki>
 test the service
   <nowiki>~$ service telegraf start</nowiki>
 Add the following lines to /etc/rc.conf to enable telegrafb:
   <nowiki>telegraf_enable="YES"</nowiki>

← Older revision		Revision as of 04:54, 11 September 2022
Line 73:		Line 73:
	test the service		test the service
	<nowiki>~$ service telegraf start</nowiki>		<nowiki>~$ service telegraf start</nowiki>
		+	Add the following lines to /etc/rc.conf to enable telegrafb:
		+	<nowiki>telegraf_enable="YES"</nowiki>