41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# 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 |
|
|
|