Skip to content

Sensors

tjaworski edited this page Apr 5, 2025 · 1 revision

calendar | date info

config:

     no config settings

tokens:

     {0} M/D/YY
     {1} YYYY-M-D
     {2} Day of Month
     {3} 1st, 2nd, 3rd, 4th
     {4} Day of Week (Sunday, Monday, ...)
     {5} Day of Week Short (Sun, Mon, ...)
     {6} Month of year (January, February, ...)
     {7} Month of year Short (Jan, Feb, ...)
     {8} 4 digit year, 2025
     {9} Month Number (1, 2, ... 12)
    {10} 2 digit year 25
    {11} YYYY.MM.D (2025.12.5)

clock | time info

config:

     no config settings

tokens:

    {0} HH:MM (24 hour)
    {1} HH:MM (12 hour)
    {2} seconds
    {3} am/pm

cpu_power | cpu watt usage

config:

     max_points : for history

tokens:

    {0} watts
    {1} watts history (comma delimited)

cpu_temp | cpu temperature

config:

     max_points : for history 
     fahrenheit : use F or C

tokens:

    {0} temp
    {1} temp history (comma delimited)
    {2} unit F/C

cpu_usage | cpu usage

config:

     max_points : for history 

tokens:

    {0} cpu busy
    {1} cpu history (comma delimited)

memory | memory usage

config:

     max_points : for history 

tokens:

     {0} total memory (bytes)
     {1} swap total (bytes)
     {2} memory usage percentage 
     {3} memory usage history
     {4} swap usage percentage
     {5} swap usage history
     {6} free memory 
     {7} free memory history
     {8} cache
     {9} cache history
    {10} active memory
    {11} active history
    {12} swap used
    {13} swap used history
    {14} active memory formatted KB/MB/GB
    {14} swap used formatted KB/MB/GB

network | network usage

config:

     max_points : for history 
     interface  : network interface to monitor (eth1, enp2s0, ...)
     scaling    : scale factor (1.5)

tokens:

     {0} interface name
     {1} rx bytes
     {2} rx bytes history
     {3} rx rate (byte/s)
     {4} tx bytes
     {5} tx bytes history
     {6} tx rate (byte/s)
     {7} rx packets
     {8} rx packets formatted (rx/pps)
     {9} rx packets history
    {10} tx packets
    {11} tx packets formatted (rx/pps)
    {12} tx packets history
    {13} link speed
    {14} link mtu
    {15} rx rate (bits/s)
    {16} tx rate (bits/s)
    {17} ipv4
    {18} ipv6

space | disk space usage

config:

     max_points  : for history 
     name        : name of disk (root, home, etc...)
     mount_point : mount point to monitor (/, /home, /mnt/disk1)

tokens:

     {0} mount point
     {1} free percent history
     {2} used percent history
     {3} free percent
     {4} used percent
     {5} free mb
     {6} used mb
     {7} total size mb
     {8} unit MiB

weather | weather outlook

config:

     name     : name of location (nyc, london, zip code, etc...)
     country  : country of location (US, AU, UK, etc...)
     forecast : 0 = current conditions, 1 = today, 2 = tomorrow, 3 = day after tomorrow, ... 7
     imperial : use imperial units (inches, °F, mph)

tokens:

     {0} location name (city)
     {1} state
     {2} country
     {3} town
     {4} Weather code (WMO)
     {5} Weather code text (sunny, cloudy, ...)
     {6} 0 = night, 1 = day time
     {7} temperature
     {8} temperature unit (F/C)
     {9} temperature low
    {10} temperature low unit (F/C)
    {11} temperature high
    {12} temperature high unit (F/C)
    {13} wind speed
    {14} wind speed unit (kph/s or mph/s)
    {15} wind direction (in degrees)
    {16} wind direction unit
    {17} wind direction text abbreviation (N, NE, E, W ... S)
    {18} precipitation
    {19} precipitation unit