| 1 | # Windows.plugin |
| 2 | |
| 3 | This internal plugin is exclusively available for Microsoft Windows operating systems. |
| 4 | |
| 5 | ## Overview |
| 6 | |
| 7 | The Windows plugin primarily collects metrics from Microsoft Windows [Performance Counters](https://learn.microsoft.com/en-us/windows/win32/perfctrs/performance-counters-what-s-new). All detected metrics are automatically displayed in the Netdata dashboard without requiring additional configuration. |
| 8 | |
| 9 | ## Default Configuration |
| 10 | |
| 11 | By default, all collector threads are enabled except for `PerflibThermalZone` and `PerflibServices`. You can enable these disabled collectors or disable any of the currently active ones by modifying the `[plugin:windows]` section in your configuration file. |
| 12 | |
| 13 | To change a setting, remove the comment symbol (`#`) from the beginning of the line and set the value to either `yes` or `no`. |
| 14 | |
| 15 | ```text |
| 16 | [plugin:windows] |
| 17 | # GetSystemUptime = yes |
| 18 | # GetSystemRAM = yes |
| 19 | # PerflibProcesses = yes |
| 20 | # PerflibProcessor = yes |
| 21 | # PerflibMemory = yes |
| 22 | # PerflibStorage = yes |
| 23 | # PerflibNetwork = yes |
| 24 | # PerflibObjects = yes |
| 25 | # PerflibHyperV = yes |
| 26 | # PerflibThermalZone = no |
| 27 | # PerflibWebService = yes |
| 28 | # PerflibServices = no |
| 29 | # PerflibNetFramework = yes |
| 30 | # PerflibAD = yes |
| 31 | # PerflibADCS = yes |
| 32 | # PerflibADFS = yes |
| 33 | # PerflibExchange = yes |
| 34 | # PerflibNUMA = yes |
| 35 | ``` |
| 36 | |
| 37 | ## Update Every per Thread |
| 38 | |
| 39 | When the plugin is running, most threads will collect data using Netdata's default update `every interval`. However, |
| 40 | to avoid overloading the host, Netdata uses different `update every` intervals for specific threads, as shown below: |
| 41 | |
| 42 | | Period (seconds) | Threads | |
| 43 | |------------------|----------------------------------------------------------------------------------| |
| 44 | | 5 | `PerflibHyperV`, `PerflibThermalZone` | |
| 45 | | 10 | `PerflibAD`, `PerflibADCS`, `PerflibADFS`, and `PerflibExchange` | |
| 46 | | 30 | `PerflibServices` | |
| 47 | |
| 48 | To customize the update interval for a specific thread, you can set the update every value within the corresponding |
| 49 | thread configuration in your `netdata.conf` file. For example, to modify the intervals for the `Object` |
| 50 | and `HyperV` threads: |
| 51 | |
| 52 | ```text |
| 53 | [plugin:windows:PerflibObjects] |
| 54 | #update every = 10s |
| 55 | |
| 56 | [plugin:windows:PerflibHyperV] |
| 57 | #update every = 15s |
| 58 | ``` |