Carbonator was a project that started before modern tools like telegraf were available. This repository is now archived and code will remain here for a little while longer before being deleted.
A simple Windows Service that collects Performance Counters and reports metrics to a Graphite server.
See releases for change log/version history.
Via command-line (CMD or PowerShell)[Skip 1-3 if you already have nuget installed]
nuget restore Carbonator.sln
to restore packagesbuild.cmd
to compile CarbonatorCarbonator\bin\Release
directoryCarbonator\bin\Release
directoryCopy binaries to a directory you want application to run from. (e.g. C:\Program Files\Carbonator
)
Note: if you intend to run Carbonator as a service, do not install it within a user profile directory (e.g. C:\Users\<username>\...
)
This mode is useful if you want to try out configuration first and see metrics reported.
Run Crypton.Carbonator.exe --console --verbose
from Windows command line (or PowerShell).
install-service.cmd
to install Carbonator Windows Service. (Run as administrator from the directory that contains Carbonator binaries).net start carbonator
to start Carbonator service, or use Services console (services.msc)Carbonator uses NETWORK SERVICE Windows NT account.
Carbonator configuration is contained within the Crypton.Carbonator.exe.config
XML file.
You will need to adjust /configuration/carbonator/graphite
XML element settings to wherever your Graphite server is and port (if different).
The /configuration/carbonator/counters
list can be used to select which performance counters are monitored and reported. You can use Windows Performance Monitor perfmon.msc
to determine which counters you may be interested (and which are available).
The configuration for each performance counter element is self explanatory:
path
= the Graphite/Carbon metric path that will be reported. You can use %HOST%
special string in the path
setting which will be replaced with the name of the current computer when metric is reported. Use %host%
to force the hostname in lowercase.category
= Performance Counter categorycounter
= Performance Counter nameinstance
= Performance Counter instance, needed by certain counters such as Processor (_Total to represent overall CPU usage or by specific CPU instead). For counters that do not have an instance, leave this attribute empty or remove it entirely.Some sample performance counters are provided in default configuration file.
You may need to adjust defaultCulture
attribute if your Windows installation is localized differently since performance counter names will be translated.
It may be necessary to add NETWORK SERVICE
(or another user account Carbonator is running as) to Performance Log Users group or certain counters may not load or report zero for all values.
Carbonator will report errors in Windows Event Log (Application) under carbonator
event source.
Default counter sampling is every 1000ms, with reports going out every 5000ms. Pickle protocol is not used, metrics are reported individually as-is.
Carbonator is licensed under MIT License.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4