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

Aus Wiki-WebPerfect
Wechseln zu: Navigation, Suche
Zeile 52: Zeile 52:
  
  
−
=== Telegraf-Inputs ===
 
−
==== exec ====
 
−
timeout = "1m" <br>
 
−
data_format = "influx" <br>
 
−
PowerShell Parameter = -NoProfile <br>
 
  
  
−
=== PowerShell Module "PSInfluxLineConverter" ===
+
=== Telegraf Inputs ===
−
''PowerShell module to convert PowerShell outputs for Telegraf agent to the InfluxLine-Protocol. The Telegraf agents reads the converted outputs and send this to an InfluxDB.'' <br>
+
Telegraf Inputs are documented in: [[Telegraf: Inputs]]
−
More informations on my [Github Project-Page]https://github.com/R-Studio/PSInfluxLineConverter.
+
  
  
−
=== Examples ===
+
=== Telegraf Processors ===
−
==== PowerShell-Skript Get-VHD (with PowerShell Module) ====
+
Telegraf Processors are documented in: [[Telegraf: Processors]]
−
'''Telegraf Configuration'''
+
−
<pre>
+
−
[[inputs.exec]]
+
−
commands = ['powershell -NoProfile -File "C:\Program Files\Telegraf\scripts\input.vhd.ps1"']
+
−
data_format = "influx"
+
−
timeout = "1m" </pre>
+
−
 
+
−
'''PowerShell-Skript "input.vhd.ps1"'''
+
−
*Install the PowerShell-Module "PSInfluxLineConverter" first, or copy the module to a destination (in this example: "C:\Program Files\Telegraf\scripts\psmodules\PSInfluxLineConverter") <br>
+
−
 
+
−
Import-Module 'C:\Program Files\Telegraf\scripts\psmodules\PSInfluxLineConverter' -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
+
−
 
+
−
 
+
−
 
+
−
 
+
−
 
+
−
== Troubleshooting ==
+
−
=== Error: [telegraf] Error running agent: Error parsing <C:\your_config_file_path>, line x: invalid TOML syntax ===
+
−
Example: Configuration with the error:
+
−
<pre>
+
−
[[processors.regex]]
+
−
  namepass = ["hyperv_processor"]
+
−
 
+
−
  [[processors.regex.tags]]
+
−
    key = "instance"
+
−
    pattern = "^(?P<VMName>.+)\:.+$"
+
−
    replacement = "${VMName}"
+
−
    result_key = "VMName" </pre>
+
−
 
+
−
 
+
−
==== Solution: Write the "pattern" between singleqoutes instead between doublequotes ====
+
−
Example: Configuration without the error:
+
−
<pre>
+
−
[[processors.regex]]
+
−
  namepass = ["hyperv_processor"]
+
−
 
+
−
  [[processors.regex.tags]]
+
−
    key = "instance"
+
−
    pattern = '^(?P<VMName>.+)\:.+$'
+
−
    replacement = "${VMName}"
+
−
    result_key = "VMName" </pre>
+
−
 
+
  
  

Version vom 6. Mai 2020, 09:47 Uhr

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


Useful Telegraf queries

Show Telegraf version

.\telegraf.exe version

Show all Telegraf input plugins

.\telegraf.exe --input-list


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.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: Inputs


Telegraf Processors

Telegraf Processors are documented in: Telegraf: Processors

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