plugin_name: python.d.plugin
modules:
  - meta:
      plugin_name: python.d.plugin
      module_name: sensors
      monitored_instance:
        name: Linux Sensors (lm-sensors)
        link: https://hwmon.wiki.kernel.org/lm_sensors
        categories:
          - data-collection.hardware-devices-and-sensors
        icon_filename: "microchip.svg"
      related_resources:
        integrations:
          list: []
      info_provided_to_referring_integrations:
        description: ""
      keywords:
        - sensors
        - temperature
        - voltage
        - current
        - power
        - fan
        - energy
        - humidity
      most_popular: false
    overview:
      data_collection:
        metrics_description: |
          Examine Linux Sensors metrics with Netdata for insights into hardware health and performance.
          
          Enhance your system's reliability with real-time hardware health insights.
        method_description: >
          Reads system sensors information (temperature, voltage, electric current, power, etc.) via [lm-sensors](https://hwmon.wiki.kernel.org/lm_sensors).
      supported_platforms:
        include: []
        exclude: []
      multi_instance: true
      additional_permissions:
        description: ""
      default_behavior:
        auto_detection:
          description: >
            The following type of sensors are auto-detected:
            
            - temperature
            - fan
            - voltage
            - current
            - power
            - energy
            - humidity
        limits:
          description: ""
        performance_impact:
          description: ""
    setup:
      prerequisites:
        list: []
      configuration:
        file:
          name: python.d/sensors.conf
          description: ""
        options:
          description: |
            There are 2 sections:
            
            * Global variables
            * One or more JOBS that can define multiple different instances to monitor.
            
            The following options can be defined globally: priority, penalty, autodetection_retry, update_every, but can also be defined per JOB to override the global values.
            
            Additionally, the following collapsed table contains all the options that can be configured inside a JOB definition.
            
            Every configuration JOB starts with a `job_name` value which will appear in the dashboard, unless a `name` parameter is specified.
          folding:
            title: Config options
            enabled: true
          list:
            - name: types
              description: The types of sensors to collect.
              default_value: "temperature, fan, voltage, current, power, energy, humidity"
              required: true
            - name: update_every
              description: Sets the default data collection frequency.
              default_value: 1
              required: false
            - name: priority
              description: Controls the order of charts at the netdata dashboard.
              default_value: 60000
              required: false
            - name: autodetection_retry
              description: Sets the job re-check interval in seconds.
              default_value: 0
              required: false
            - name: penalty
              description: Indicates whether to apply penalty to update_every in case of failures.
              default_value: yes
              required: false
        examples:
          folding:
            enabled: true
            title: Config
          list:
            - name: Default
              folding:
                enabled: false
              description: Default configuration.
              config: |
                types:
                  - temperature
                  - fan
                  - voltage
                  - current
                  - power
                  - energy
                  - humidity
    troubleshooting:
      problems:
        list:
          - name: lm-sensors doesn't work on your device
            description: |
              When `lm-sensors` doesn't work on your device (e.g. for RPi temperatures),
              use [the legacy bash collector](https://github.com/netdata/netdata/blob/master/collectors/charts.d.plugin/sensors/README.md)
          - name: ACPI ring buffer errors are printed
            description: |
              There have been reports from users that on certain servers, ACPI ring buffer errors are printed by the kernel (`dmesg`)
              when ACPI sensors are being accessed. We are tracking such cases in issue [#827](https://github.com/netdata/netdata/issues/827).
              Please join this discussion for help.
    alerts: []
    metrics:
      folding:
        title: Metrics
        enabled: false
      description: ""
      availability: []
      scopes:
        - name: chip
          description: >
            Metrics related to chips. Each chip provides a set of the following metrics, each having the chip name in the metric name as reported by `sensors -u`.
          labels: []
          metrics:
            - name: sensors.temperature
              description: Temperature
              unit: "Celsius"
              chart_type: line
              dimensions:
                - name: a dimension per sensor
            - name: sensors.voltage
              description: Voltage
              unit: "Volts"
              chart_type: line
              dimensions:
                - name: a dimension per sensor
            - name: sensors.current
              description: Current
              unit: "Ampere"
              chart_type: line
              dimensions:
                - name: a dimension per sensor
            - name: sensors.power
              description: Power
              unit: "Watt"
              chart_type: line
              dimensions:
                - name: a dimension per sensor
            - name: sensors.fan
              description: Fans speed
              unit: "Rotations/min"
              chart_type: line
              dimensions:
                - name: a dimension per sensor
            - name: sensors.energy
              description: Energy
              unit: "Joule"
              chart_type: line
              dimensions:
                - name: a dimension per sensor
            - name: sensors.humidity
              description: Humidity
              unit: "Percent"
              chart_type: line
              dimensions:
                - name: a dimension per sensor