62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
|
# Temperature Input Plugin
|
||
|
|
|
||
|
|
The temp input plugin gather metrics on system temperature. This plugin is
|
||
|
|
meant to be multi platform and uses platform specific collection methods.
|
||
|
|
|
||
|
|
Currently supports Linux and Windows.
|
||
|
|
|
||
|
|
## Global configuration options <!-- @/docs/includes/plugin_config.md -->
|
||
|
|
|
||
|
|
In addition to the plugin-specific configuration settings, plugins support
|
||
|
|
additional global and plugin configuration settings. These settings are used to
|
||
|
|
modify metrics, tags, and field or create aliases and configure ordering, etc.
|
||
|
|
See the [CONFIGURATION.md][CONFIGURATION.md] for more details.
|
||
|
|
|
||
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
```toml @sample.conf
|
||
|
|
# Read metrics about temperature
|
||
|
|
[[inputs.temp]]
|
||
|
|
## Desired output format (Linux only)
|
||
|
|
## Available values are
|
||
|
|
## v1 -- use pre-v1.22.4 sensor naming, e.g. coretemp_core0_input
|
||
|
|
## v2 -- use v1.22.4+ sensor naming, e.g. coretemp_core_0_input
|
||
|
|
# metric_format = "v2"
|
||
|
|
|
||
|
|
## Add device tag to distinguish devices with the same name (Linux only)
|
||
|
|
# add_device_tag = false
|
||
|
|
```
|
||
|
|
|
||
|
|
## Metrics
|
||
|
|
|
||
|
|
- temp
|
||
|
|
- tags:
|
||
|
|
- sensor
|
||
|
|
- fields:
|
||
|
|
- temp (float, celcius)
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
|
||
|
|
On **Windows**, the plugin uses a WMI call that is can be replicated with the
|
||
|
|
following command:
|
||
|
|
|
||
|
|
```shell
|
||
|
|
wmic /namespace:\\root\wmi PATH MSAcpi_ThermalZoneTemperature
|
||
|
|
```
|
||
|
|
|
||
|
|
If the result is "Not Supported" you may be running in a virtualized environment
|
||
|
|
and not a physical machine. Additionally, if you still get this result your
|
||
|
|
motherboard or system may not support querying these values. Finally, you may
|
||
|
|
be required to run as admin to get the values.
|
||
|
|
|
||
|
|
## Example Output
|
||
|
|
|
||
|
|
```text
|
||
|
|
temp,sensor=coretemp_physicalid0_crit temp=100 1531298763000000000
|
||
|
|
temp,sensor=coretemp_physicalid0_critalarm temp=0 1531298763000000000
|
||
|
|
temp,sensor=coretemp_physicalid0_input temp=100 1531298763000000000
|
||
|
|
temp,sensor=coretemp_physicalid0_max temp=100 1531298763000000000
|
||
|
|
```
|