plugin_name: charts.d.plugin
modules:
  - meta:
      plugin_name: charts.d.plugin
      module_name: sensors
      monitored_instance:
        name: Linux Sensors (sysfs)
        link: "https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface"
        categories:
          - data-collection.hardware-devices-and-sensors
        icon_filename: "microchip.svg"
      related_resources:
        integrations:
          list: []
      info_provided_to_referring_integrations:
        description: ""
      keywords:
        - sensors
        - sysfs
        - hwmon
        - rpi
        - raspberry pi
      most_popular: false
    overview:
      data_collection:
        metrics_description: |
          Use this collector when `lm-sensors` doesn't work on your device (e.g. for RPi temperatures).
          For all other cases use the [Python collector](https://github.com/netdata/netdata/blob/master/collectors/python.d.plugin/sensors), which supports multiple jobs, is more efficient and performs calculations on top of the kernel provided values."
        method_description: |
          It will provide charts for all configured system sensors, by reading sensors directly from the kernel.
          The values graphed are the raw hardware values of the sensors.
      supported_platforms:
        include: [Linux]
        exclude: []
      multi_instance: true
      additional_permissions:
        description: ""
      default_behavior:
        auto_detection:
          description: "By default, the collector will try to read entries under `/sys/devices`"
        limits:
          description: ""
        performance_impact:
          description: ""
    setup:
      prerequisites:
        list:
          - title: "Install charts.d plugin"
            description: |
              If [using our official native DEB/RPM packages](https://github.com/netdata/netdata/blob/master/packaging/installer/UPDATE.md#determine-which-installation-method-you-used), make sure `netdata-plugin-chartsd` is installed.
          - title: "Enable the sensors collector"
            description: |
              The `sensors` collector is disabled by default. To enable it, use `edit-config` from the Netdata [config directory](https://github.com/netdata/netdata/blob/master/docs/configure/nodes.md), which is typically at `/etc/netdata`, to edit the `charts.d.conf` file.

              ```bash
              cd /etc/netdata   # Replace this path with your Netdata config directory, if different
              sudo ./edit-config charts.d.conf
              ```

              Change the value of the `sensors` setting to `force` and uncomment the line. Save the file and restart the Netdata Agent with `sudo systemctl restart netdata`, or the [appropriate method](https://github.com/netdata/netdata/blob/master/docs/configure/start-stop-restart.md) for your system.
      configuration:
        file:
          name: charts.d/sensors.conf
        options:
          description: |
            The config file is sourced by the charts.d plugin. It's a standard bash file.
            
            The following collapsed table contains all the options that can be configured for the sensors collector.
          folding:
            title: "Config options"
            enabled: true
          list:
            - name: sensors_sys_dir
              description: The directory the kernel exposes sensor data.
              default_value: "/sys/devices"
              required: false
            - name: sensors_sys_depth
              description: How deep in the tree to check for sensor data.
              default_value: 10
              required: false
            - name: sensors_source_update
              description: If set to 1, the script will overwrite internal script functions with code generated ones.
              default_value: 1
              required: false
            - name: sensors_update_every
              description: The data collection frequency. If unset, will inherit the netdata update frequency.
              default_value: 1
              required: false
            - name: sensors_priority
              description: The charts priority on the dashboard.
              default_value: 90000
              required: false
            - name: sensors_retries
              description: The number of retries to do in case of failure before disabling the collector.
              default_value: 10
              required: false
        examples:
          folding:
            enabled: false
            title: "Config"
          list:
            - name: Set sensors path depth
              description: Set a different sensors path depth
              config: |
                # the directory the kernel keeps sensor data
                #sensors_sys_dir="/sys/devices"
                
                # how deep in the tree to check for sensor data
                sensors_sys_depth=5
                
                # if set to 1, the script will overwrite internal
                # script functions with code generated ones
                # leave to 1, is faster
                #sensors_source_update=1
                
                # the data collection frequency
                # if unset, will inherit the netdata update frequency
                #sensors_update_every=
                
                # the charts priority on the dashboard
                #sensors_priority=90000
                
                # the number of retries to do in case of failure
                # before disabling the module
                #sensors_retries=10
    troubleshooting:
      problems:
        list: []
    alerts: []
    metrics:
      folding:
        title: Metrics
        enabled: false
      description: ""
      availability: []
      scopes:
        - name: sensor chip
          description: "Metrics related to sensor chips. Each chip provides its own set of the following metrics."
          labels: []
          metrics:
            - name: sensors.temp
              description: Temperature
              unit: "Celsius"
              chart_type: line
              dimensions:
                - name: "{filename}"
            - name: sensors.volt
              description: Voltage
              unit: "Volts"
              chart_type: line
              dimensions:
                - name: "{filename}"
            - name: sensors.curr
              description: Current
              unit: "Ampere"
              chart_type: line
              dimensions:
                - name: "{filename}"
            - name: sensors.power
              description: Power
              unit: "Watt"
              chart_type: line
              dimensions:
                - name: "{filename}"
            - name: sensors.fans
              description: Fans Speed
              unit: "Rotations / Minute"
              chart_type: line
              dimensions:
                - name: "{filename}"
            - name: sensors.energy
              description: Energy
              unit: "Joule"
              chart_type: area
              dimensions:
                - name: "{filename}"
            - name: sensors.humidity
              description: Humidity
              unit: "Percent"
              chart_type: line
              dimensions:
                - name: "{filename}"