telegraf/docs/WINDOWS_SERVICE.md

Running Telegraf as a Windows Service

Telegraf natively supports running as a Windows Service. Outlined below is are the general steps to set it up.

1. Obtain the telegraf windows distribution

2. Create the directory C:\Program Files\Telegraf (if you install in a different location simply specify the -config parameter with the desired location)

3. Place the telegraf.exe and the config file into C:\Program Files\Telegraf

4. To install the service into the Windows Service Manager, run (as an administrator):

   > C:\Program Files\Telegraf\telegraf.exe --service install
   

5. Edit the configuration file to meet your needs

6. To check that it works, run:

   > C:\Program Files\Telegraf\telegraf.exe --config C:\Program Files\Telegraf\telegraf.conf --test
   

7. To start collecting data, run:

   > net start telegraf
   

Other supported operations

Telegraf can manage its own service through the --service flag:

Command	Effect
telegraf.exe --service install	Install telegraf as a service
telegraf.exe --service uninstall	Remove the telegraf service
telegraf.exe --service start	Start the telegraf service
telegraf.exe --service stop	Stop the telegraf service