4 # https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface
6 # if this chart is called X.chart.sh, then all functions and global variables
9 # the directory the kernel keeps sensor data
10 sensors_sys_dir="${NETDATA_HOST_PREFIX}/sys/devices"
12 # how deep in the tree to check for sensor data
15 # if set to 1, the script will overwrite internal
16 # script functions with code generated ones
17 # leave to 1, is faster
18 sensors_source_update=1
20 # how frequently to collect sensor data
21 # the default is to collect it at every iteration of charts.d
24 sensors_priority=90000
26 declare -A sensors_excluded=()
28 sensors_find_all_files() {
29 find $1 -maxdepth $sensors_sys_depth -name \*_input -o -name temp 2>/dev/null
32 sensors_find_all_dirs() {
33 sensors_find_all_files $1 | while read
39 # _check is called once, to find out if this chart should be enabled or not
43 # - 0 to enable the chart
44 # - 1 to disable the chart
46 [ -z "$( sensors_find_all_files $sensors_sys_dir )" ] && echo >&2 "$PROGRAM_NAME: sensors: no sensors found in '$sensors_sys_dir'." && return 1
50 sensors_check_files() {
51 # we only need sensors that report a non-zero value
52 # also remove not needed sensors
57 [ ! -f "$f" ] && continue
58 for ex in ${sensors_excluded[@]}; do
59 [[ $f =~ .*$ex$ ]] && excluded='1' && break
62 [ "$excluded" != "1" ] && v="$( cat $f )" || v=0
64 [ $v -ne 0 ] && echo "$f" && continue
67 echo >&2 "$PROGRAM_NAME: sensors: $f gives zero values"
71 sensors_check_temp_type() {
72 # valid temp types are 1 to 6
73 # disabled sensors have the value 0
78 t=$( echo $f | sed "s|_input$|_type|g" )
79 [ "$f" = "$t" ] && echo "$f" && continue
80 [ ! -f "$t" ] && echo "$f" && continue
84 [ $v -ne 0 ] && echo "$f" && continue
86 echo >&2 "$PROGRAM_NAME: sensors: $f is disabled"
90 # _create is called once, to create the charts
92 local path= dir= name= x= file= lfile= labelname= labelid= device= subsystem= id= type= mode= files= multiplier= divisor=
94 # we create a script with the source of the
95 # sensors_update() function
96 # - the highest speed we can achieve -
97 [ $sensors_source_update -eq 1 ] && echo >$TMP_DIR/sensors.sh "sensors_update() {"
99 for path in $( sensors_find_all_dirs $sensors_sys_dir | sort -u )
101 dir=$( basename $path )
108 [ -h $path/device ] && device=$( readlink -f $path/device )
109 [ ! -z "$device" ] && device=$( basename $device )
110 [ -z "$device" ] && device="$dir"
112 [ -h $path/subsystem ] && subsystem=$( readlink -f $path/subsystem )
113 [ ! -z "$subsystem" ] && subsystem=$( basename $subsystem )
114 [ -z "$subsystem" ] && subsystem="$dir"
116 [ -f $path/name ] && name=$( cat $path/name )
117 [ -z "$name" ] && name="$dir"
119 [ -f $path/type ] && type=$( cat $path/type )
120 [ -z "$type" ] && type="$dir"
122 id="$( fixid "$device.$subsystem.$dir" )"
124 echo >&2 "charts.d: sensors: on path='$path', dir='$dir', device='$device', subsystem='$subsystem', id='$id', name='$name'"
126 for mode in temperature voltage fans power current energy humidity
135 files="$( ls $path/temp*_input 2>/dev/null; ls $path/temp 2>/dev/null )"
136 files="$( sensors_check_files $files )"
137 files="$( sensors_check_temp_type $files )"
138 [ -z "$files" ] && continue
139 echo "CHART sensors.temp_$id '' '$name Temperature' 'Celsius' 'temperature' 'sensors.temp' line $((sensors_priority + 1)) $sensors_update_every"
140 echo >>$TMP_DIR/sensors.sh "echo \"BEGIN sensors.temp_$id \$1\""
145 files="$( ls $path/in*_input 2>/dev/null )"
146 files="$( sensors_check_files $files )"
147 [ -z "$files" ] && continue
148 echo "CHART sensors.volt_$id '' '$name Voltage' 'Volts' 'voltage' 'sensors.volt' line $((sensors_priority + 2)) $sensors_update_every"
149 echo >>$TMP_DIR/sensors.sh "echo \"BEGIN sensors.volt_$id \$1\""
154 files="$( ls $path/curr*_input 2>/dev/null )"
155 files="$( sensors_check_files $files )"
156 [ -z "$files" ] && continue
157 echo "CHART sensors.curr_$id '' '$name Current' 'Ampere' 'current' 'sensors.curr' line $((sensors_priority + 3)) $sensors_update_every"
158 echo >>$TMP_DIR/sensors.sh "echo \"BEGIN sensors.curr_$id \$1\""
163 files="$( ls $path/power*_input 2>/dev/null )"
164 files="$( sensors_check_files $files )"
165 [ -z "$files" ] && continue
166 echo "CHART sensors.power_$id '' '$name Power' 'Watt' 'power' 'sensors.power' line $((sensors_priority + 4)) $sensors_update_every"
167 echo >>$TMP_DIR/sensors.sh "echo \"BEGIN sensors.power_$id \$1\""
172 files="$( ls $path/fan*_input 2>/dev/null )"
173 files="$( sensors_check_files $files )"
174 [ -z "$files" ] && continue
175 echo "CHART sensors.fan_$id '' '$name Fans Speed' 'Rotations / Minute' 'fans' 'sensors.fans' line $((sensors_priority + 5)) $sensors_update_every"
176 echo >>$TMP_DIR/sensors.sh "echo \"BEGIN sensors.fan_$id \$1\""
180 files="$( ls $path/energy*_input 2>/dev/null )"
181 files="$( sensors_check_files $files )"
182 [ -z "$files" ] && continue
183 echo "CHART sensors.energy_$id '' '$name Energy' 'Joule' 'energy' 'sensors.energy' areastack $((sensors_priority + 6)) $sensors_update_every"
184 echo >>$TMP_DIR/sensors.sh "echo \"BEGIN sensors.energy_$id \$1\""
185 algorithm="incremental"
190 files="$( ls $path/humidity*_input 2>/dev/null )"
191 files="$( sensors_check_files $files )"
192 [ -z "$files" ] && continue
193 echo "CHART sensors.humidity_$id '' '$name Humidity' 'Percent' 'humidity' 'sensors.humidity' line $((sensors_priority + 7)) $sensors_update_every"
194 echo >>$TMP_DIR/sensors.sh "echo \"BEGIN sensors.humidity_$id \$1\""
206 fid="$( fixid "$file" )"
207 lfile="$( basename $file | sed "s|_input$|_label|g" )"
208 labelname="$( basename $file | sed "s|_input$||g" )"
210 if [ ! "$path/$lfile" = "$file" -a -f "$path/$lfile" ]
212 labelname="$( cat "$path/$lfile" )"
215 echo "DIMENSION $fid '$labelname' $algorithm $multiplier $divisor"
216 echo >>$TMP_DIR/sensors.sh "echo \"SET $fid = \"\$(< $file )"
219 echo >>$TMP_DIR/sensors.sh "echo END"
223 [ $sensors_source_update -eq 1 ] && echo >>$TMP_DIR/sensors.sh "}"
224 # cat >&2 $TMP_DIR/sensors.sh
226 # ok, load the function sensors_update() we created
227 [ $sensors_source_update -eq 1 ] && . $TMP_DIR/sensors.sh
232 # _update is called continiously, to collect the values
234 # the first argument to this function is the microseconds since last update
235 # pass this parameter to the BEGIN statement (see bellow).
237 # do all the work to collect / calculate the values
239 # remember: KEEP IT SIMPLE AND SHORT
241 [ $sensors_source_update -eq 0 ] && . $TMP_DIR/sensors.sh $1