Quelltext der Seite 01 - Telegraf: First Steps and Guide-Lines

== Installation ==
== Installing Telegraf Agent as a Windows Service with a configuration directory (recommended) ==
 .\telegraf.exe --service install --config-directory "C:\Program Files\Telegraf\telegraf.d"

== Installing Telegraf Agent as a Windows Service with a configuration directory and the default configuration file ==
 .\telegraf.exe --service install --config "C:\Program Files\Telegraf\telegraf.conf" --config-directory "C:\Program Files\Telegraf\telegraf.d"

== Installing Telegraf Agent as a Windows Service ==
''The Telegraf Agent searches the configuration: "C:\Program Files\Telegraf\telegraf.conf"''
 .\telegraf.exe --service install



== Telegraf Configurations/Plugins ==
'''All Telegraf Plugins are Built-In.''' That means you don't use extra plugin file, you can use the plugin directly you only have to write a configuration file ".conf".<br>
Guide-Line: Save all Telegraf configurations/plugins in .conf files at: C:\Program Files\Telegraf\telegraf.d


=== Naming (Guide-Line) ===
 <Telegraf-Type>.<Plugin>.<Component>.<Optionals>.conf

'''Example: An Input-Plugin to collect VHD informations with a PowerShell-Script:''' inputs.exec.vhd.conf <br>
'''Example: An Input-Plugin to collect Basic Windows informations with Perfmon:''' inputs.win_perf_counters.basic.conf <br>
'''Example: An Input-Plugin to collect Hyper-V informations with Perfmon:''' inputs.win_perf.hyper-v.conf <br>
'''Example: Telegraf-Agent configurations:''' agent.global.conf <br>
'''Example: Global tagging:''' tags.global.conf <br>
'''Example: InfluxDB configurations:''' outputs.global.influxdb.conf <br>
'''Example: Internal Monitoring of the Telegraf Agent:''' inputs.internal.telegraf.conf <br>

'''Telegraf-Types'''
*input
*output
*aggregator
*processor
*agent (Agent configurations: Global Intervalls,...)
*tags (Definition of global tags)


=== Telegraf-Inputs ===
exec

timeout = "1m"
data_format = "influx"
PowerShell Parameter = -NoProfile
Examples
PowerShell-Skript Get-VHD (with PowerShell Module)

'''Telegraf Configuration'''
 <pre>[[inputs.exec\]\]</pre>
 commands = ['powershell -NoProfile -File "C:\Program Files\Telegraf\scripts\input.get-vhd.ps1"']
 data_format = "influx"
 timeout = "1m"

'''PowerShell-Skript "input.get-vhd.ps1"'''
 Import-Module 'C:\Program Files\Telegraf\scripts\psmodules\Influx' -Force
 
 $VHDs = (Get-VM).Id | ForEach {Get-VHD -Id $_} | select Path, DiskIdentifier, VhdFormat, VhdType, Size, MinimumSize, FileSize, LogicalSectorSize, PhysicalSectorSize, BlockSize, FragmentationPercentage
 $VHDs | ConvertTo-Metric -Measure hyperv_vhd -MetricProperty Size, MinimumSize, FileSize, LogicalSectorSize, PhysicalSectorSize, BlockSize, FragmentationPercentage -TagProperty Path, DiskIdentifier, VhdFormat, VhdType | ConvertTo-InfluxLineString







[[Kategorie:TIG-Stack]]