Monitor Your Pet's Health with Litter Exporter

A Prometheus exporter for…what?

The Litter Robot 3 Connect is a WiFi enabled self-cleaning litter box.

Why on earth?

The Litter Robot 3 Connect first and foremost is a self-cleaning litter box. It starts a cleaning cycle after a configurable wait period after each use. It empties waste into a drawer below the globe and sends push notifications to cell phones when the drawer needs emptied. The app also offers graphs of litter box usage: there are aggregated usage metrics for each day of the current week and each week of the last month.

Graph showing usage statistics for each day of the last week

Graph showing usage statistics for each week of the last month

Unfortunately, it does not send notifications when your pet uses the litter box more often than usual, which can sometimes indicate something is wrong with your furry friend.

One morning I noticed my cat was in and out of his litter box a lot and each visit was unproductive. With the help of my vet we got him straightened out, but I felt really terrible during the whole ordeal that I didn’t notice sooner, and I found myself really wishing I could get notifications for an increase in use.

This is why I built the Litter Exporter. I can now get near real-time metrics on how often its used and when. I can even alert when my cat uses the litter box more than usual or more frequently than usual.

How I Use It (and you can, too!)

I run the Litter Exporter alongside Prometheus, Grafana and Alertmanager via Docker Compose (see the examples section in the repo for more).

Disclaimer: there is no officially-public API for the Litter Robot 3 Connect, so this exporter is experimental. Breaking changes can occur at any time with no warning, so use at your own risk. I reached out to AutoPets and a public API is on the roadmap, but likely won’t be available in 2021.

Special thanks to the users who reverse engineered the Litter Robot API: joshjcarrier, natekspencer.

Source: DEV Community

November 8, 2021
Category : News
Tags: go | monitoring | prometheus

Leave a Reply

Your email address will not be published. Required fields are marked *

Sitemap | Terms | Privacy | Cookies | Advertising

Senior Software Developer

Creator of @LzoMedia I am a backend software developer based in London who likes beautiful code and has an adherence to standards & love's open-source.