Monitor Windows System Metrics using Sensu

Last Updated:

Follow through this guide to learn how you can easily monitor Windows system metrics using Sensu. Sensu is an opensource infrastructure and application monitoring tool. You will learn to monitor such metrics as CPU usage, memory usage, disk usage etc.

Monitor Windows System Metrics using Sensu

Configure Sensu Agent Entity Subscription

As described in the guide below, you need to add the Windows system agent into a specific subscription;

Configure Sensu Agent Entity Subscription

sensuctl entity update WorkBox
? Entity Class: agent
? Subscriptions: windows
sensuctl entity list

     ID      Class     OS          Subscriptions                  Last Seen            
─────────── ─────── ───────── ──────────────────────── ────────────────────────────────
  WorkBox    agent   windows   windows,entity:WorkBox   2022-05-07 20:02:11 +0000 UTC  
  debian11   agent   linux     linux,entity:debian11    2022-05-07 20:02:03 +0000 UTC  
  rocky8     agent   linux     linux,entity:rocky8      2022-05-07 20:02:13 +0000 UTC

Next, install Sensu Checks Plugins

As described in the guide below, install Sensu checks plugins;

Install Sensu Check Plugins on the Sensu Backend

To confirm installed checks plugins;

sensuctl asset list

         Name                                             URL                                        Hash    
───────────────────── ──────────────────────────────────────────────────────────────────────────── ──────────
  check-cpu-usage      //      900cfdf  
  check-cpu-usage      //       db81ee7  
  check-cpu-usage      //        400aacc  
  check-cpu-usage      //        bef7802  
  check-cpu-usage      //          a2dcb53  
  check-cpu-usage      //        2453973  
  check-disk-usage     //     e28c0da  
  check-disk-usage     //      2b3a8f1  
  check-disk-usage     //       0c2c5ce  
  check-disk-usage     //       f5234e9  
  check-disk-usage     //         102f2ca  
  check-disk-usage     //       0b76e77  
  check-memory-usage   //   90a997a  
  check-memory-usage   //    57ebebe  
  check-memory-usage   //     6f7d0d2  
  check-memory-usage   //     94a41f3  
  check-memory-usage   //       125f9c1  
  check-memory-usage   //     663985d

Define Sensu Monitoring Command Checks

Next, Create Sensu Monitoring Command Checks.

Since we already defined the checks and define Subscription for Linux systems, you need to update these checks to be run against windows as well.

For example, to update the check_cpu check;

sensuctl check update check_cpu

Sample update prompts.

? Command: check-cpu-usage -w 80 -c 90
? Interval: 300
? Cron: 
? Timeout: 0
? TTL: 
? Subscriptions: linux,windows
? Handlers: 
? Runtime Assets: check-cpu-usage
? Publish: true
? Check Proxy Entity Name: 
? Check STDIN: false
? High Flap Threshold: 0
? Low Flap Threshold: 0
? Metric Format: 
? Metric Handlers: 
? Round Robin false

Update the rest or create new checks as you so wish;

This is how my checks look like;

sensuctl check list

     Name                 Command               Interval   Cron   Timeout   TTL   Subscriptions   Handlers         Assets         Hooks   Publish?   Stdin?   Metric Format   Metric Handlers  
───────────── ──────────────────────────────── ────────── ────── ───────── ───── ─────────────── ────────── ──────────────────── ─────── ────────── ──────── ─────────────── ──────────────────
  check_cpu    check-cpu-usage -w 80 -c 90           300                0     0   linux,windows              check-cpu-usage              true       false                                     
  check_disk   check-disk-usage -w 75 -c 85          300                0     0   linux,windows              check-disk-usage             true       false                                     
  check_mem    check-memory-usage -w 75 -c 90        300                0     0   linux,windows              check-memory-usage           true       false                                     
  check_swap   check-swap-usage -w 75 -c 90          300                0     0   linux                      check-memory-usage           true       false 

The three checks have been defined to run against both Linux and Windows system subscription.

As you are done updating the checks, they should have been executed already.

Verify the event data;

sensuctl event list | grep WorkBox

Sample output;

  WorkBox    check_cpu    check-cpu-usage OK: 0.39% CPU usage | cpu_idle=99.61, cpu_system=0.00, cpu_user=0.39, cpu_nice=0.00, cpu_iowait=0.00, cpu_irq=0.00, cpu_softirq=0.00, cpu_steal=0.00, cpu_guest=0.00, cpu_guestnice=0.00        0   false      2022-05-07 20:25:44 +0000 UTC   579f60ab-6713-46f5-8545-94a89b2f0161  
  WorkBox    check_disk   check-disk-usage       OK: C: 62.49% - Total: 41 GB, Used: 26 GB, Free: 16 GB                                                                                                                                   1   false      2022-05-07 20:24:14 +0000 UTC   9da8a763-724e-441c-ba87-d00a8b6aa9d2  
  WorkBox    check_mem    check-memory-usage OK: 44.00% memory usage | mem_total=3220754432, mem_available=1771634688, mem_used=1449119744, mem_free=1771634688                                                                           0   false      2022-05-07 20:24:28 +0000 UTC   534657d3-4c83-4a8d-bf00-8f9a933f16ca  
  WorkBox    keepalive    Keepalive last sent from WorkBox at 2022-05-07 20:26:31 +0000 UTC                                                                                                                                               0   false      2022-05-07 20:26:31 +0000 UTC   19f4a33b-e331-429f-af97-8a1053580286 

On the Web UI dashboard, looks like there is some incident!

Monitor Windows System Metrics using Sensu

To check on the entity details;

Monitor Windows System Metrics using Sensu

And there you go. That is how you can easily use Sensu to monitor Windows system Metrics.

Other Tutorials;

Monitoring Gitlab Metrics with Prometheus and Grafana

Monitor Linux System Metrics with ELK Stack


We're passionate about sharing our knowledge and experiences with you through our blog. If you appreciate our efforts, consider buying us a virtual coffee. Your support keeps us motivated and enables us to continually improve, ensuring that we can provide you with the best content possible. Thank you for being a coffee-fueled champion of our work!

Photo of author
I am the Co-founder of, Linux and the whole FOSS enthusiast, Linux System Admin and a Blue Teamer who loves to share technological tips and hacks with others as a way of sharing knowledge as: "In vain have you acquired knowledge if you have not imparted it to others".

Leave a Comment