01 - Telegraf: First Steps and Guide-Lines: Unterschied zwischen den Versionen

Aus Wiki-WebPerfect
Wechseln zu: Navigation, Suche
K
 
(32 dazwischenliegende Versionen des gleichen Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
[[Datei:01-telegraf architecture.gif|800px|right]]<br>
 
== Installation ==
 
== Installation ==
−
== Installing Telegraf Agent as a Windows Service with a configuration directory (recommended) ==
+
=== Installing Telegraf Agent as a Windows Service with a configuration directory (recommended) ===
 
  .\telegraf.exe --service install --config-directory "C:\Program Files\Telegraf\telegraf.d"
 
  .\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 ==
+
=== 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"
 
  .\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 ==
+
=== Installing Telegraf Agent as a Windows Service ===
 
''The Telegraf Agent searches the configuration: "C:\Program Files\Telegraf\telegraf.conf"''
 
''The Telegraf Agent searches the configuration: "C:\Program Files\Telegraf\telegraf.conf"''
 
  .\telegraf.exe --service install
 
  .\telegraf.exe --service install
 +
 +
 +
== Deinstallation ==
 +
=== Deinstallation of the Telegraf agent (Windows Service) ===
 +
.\telegraf.exe --service uninstall
 +
 +
 +
== Testing / Debugging ==
 +
=== Testing Telegraf input configurations ===
 +
.\telegraf.exe --config-directory .\telegraf.d\ --test --debug
 +
 +
 +
== Useful Telegraf queries ==
 +
=== Show Telegraf version ===
 +
.\telegraf.exe version
 +
 +
=== Show all Telegraf input plugins ===
 +
.\telegraf.exe --input-list
 +
 +
=== Create a Telegraf config (example with the Input-Plugin "disk") ===
 +
.\telegraf.exe --section-filter agent:inputs --input-filter disk config > telegraf.conf
 +
If you get an error: ''[telegraf] Error running agent: Error loading config file telegraf.conf: Error parsing data: line 1: invalid TOML syntax'' then maybe the enconding of the file "telegraf.conf" is not UTF-8.
  
  
Zeile 22: Zeile 45:
 
'''Example: An Input-Plugin to collect VHD informations with a PowerShell-Script:''' inputs.exec.vhd.conf <br>
 
'''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 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: An Input-Plugin to collect Hyper-V informations with Perfmon:''' inputs.win_perf_counters.hyper-v.conf <br>
 
'''Example: Telegraf-Agent configurations:''' agent.global.conf <br>
 
'''Example: Telegraf-Agent configurations:''' agent.global.conf <br>
 
'''Example: Global tagging:''' tags.global.conf <br>
 
'''Example: Global tagging:''' tags.global.conf <br>
 
'''Example: InfluxDB configurations:''' outputs.global.influxdb.conf <br>
 
'''Example: InfluxDB configurations:''' outputs.global.influxdb.conf <br>
 
'''Example: Internal Monitoring of the Telegraf Agent:''' inputs.internal.telegraf.conf <br>
 
'''Example: Internal Monitoring of the Telegraf Agent:''' inputs.internal.telegraf.conf <br>
 +
'''Example: Aggregator "BasicStats":''' aggregators.basicstats.global.conf <br>
 +
  
 
'''Telegraf-Types'''
 
'''Telegraf-Types'''
Zeile 37: Zeile 62:
  
  
−
=== Telegraf-Inputs ===
 
−
exec
 
−
 
−
timeout = "1m"
 
−
data_format = "influx"
 
−
PowerShell Parameter = -NoProfile
 
−
Examples
 
−
PowerShell-Skript Get-VHD (with PowerShell Module)
 
  
−
'''Telegraf Configuration'''
 
−
\[\[inputs.exec\]\]
 
−
commands = ['powershell -NoProfile -File "C:\Program Files\Telegraf\scripts\input.get-vhd.ps1"']
 
−
data_format = "influx"
 
−
timeout = "1m"
 
  
−
'''PowerShell-Skript "input.get-vhd.ps1"'''
+
=== Telegraf Inputs ===
−
Import-Module 'C:\Program Files\Telegraf\scripts\psmodules\Influx' -Force
+
Telegraf Inputs are documented in: [[Telegraf: Input Plugins]]
−
+
−
$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
+
  
  
 +
=== Telegraf Processors ===
 +
Telegraf Processors are documented in: [[Telegraf: Processor Plugins]]
  
  

Aktuelle Version vom 20. Januar 2022, 10:51 Uhr

01-telegraf architecture.gif

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


Deinstallation

Deinstallation of the Telegraf agent (Windows Service)

.\telegraf.exe --service uninstall


Testing / Debugging

Testing Telegraf input configurations

.\telegraf.exe --config-directory .\telegraf.d\ --test --debug


Useful Telegraf queries

Show Telegraf version

.\telegraf.exe version

Show all Telegraf input plugins

.\telegraf.exe --input-list

Create a Telegraf config (example with the Input-Plugin "disk")

.\telegraf.exe --section-filter agent:inputs --input-filter disk config > telegraf.conf

If you get an error: [telegraf] Error running agent: Error loading config file telegraf.conf: Error parsing data: line 1: invalid TOML syntax then maybe the enconding of the file "telegraf.conf" is not UTF-8.


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".
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
Example: An Input-Plugin to collect Basic Windows informations with Perfmon: inputs.win_perf_counters.basic.conf
Example: An Input-Plugin to collect Hyper-V informations with Perfmon: inputs.win_perf_counters.hyper-v.conf
Example: Telegraf-Agent configurations: agent.global.conf
Example: Global tagging: tags.global.conf
Example: InfluxDB configurations: outputs.global.influxdb.conf
Example: Internal Monitoring of the Telegraf Agent: inputs.internal.telegraf.conf
Example: Aggregator "BasicStats": aggregators.basicstats.global.conf


Telegraf-Types

  • input
  • output
  • aggregator
  • processor
  • agent (Agent configurations: Global Intervalls,...)
  • tags (Definition of global tags)



Telegraf Inputs

Telegraf Inputs are documented in: Telegraf: Input Plugins


Telegraf Processors

Telegraf Processors are documented in: Telegraf: Processor Plugins

Von „http://wiki.webperfect.ch/index.php?title=01_-_Telegraf:_First_Steps_and_Guide-Lines&oldid=3208“