Know what your homelab is doing (OpenTelemetry on a Mac)
You will set up OpenTelemetry on your Mac to track host and job metrics. The course covers collecting data from CPU, memory, and disk, as well as custom job metrics. You will store this data in Prometheus and view it in Grafana. You will also configure alerts to notify your phone when services fail or jobs get stuck.
You will run the collector in Docker and use a Python script for custom metrics. The setup uses Tailscale to access the dashboard from your phone. You will test alerts to ensure they work correctly. This process helps you keep your homelab healthy and visible while you are away.
What you'll learn
- Install OpenTelemetry Collector in Docker on macOS
- Collect host metrics using node_exporter
- Send custom job metrics via OTLP
- Configure Prometheus and Grafana dashboards
- Set up alerts for stuck jobs and down services
Who this is for
- • Developers moving into DevOps or infrastructure roles
- • System administrators learning modern tooling
- • CS students building practical skills
Prerequisites
- • Docker with Compose version 2
- • Colima, Docker Desktop, or OrbStack
- • node_exporter installed via Homebrew
- • uv Python package manager installed via Homebrew
Course content
2 modules, 7 lessons, 20m of video
Module 1
4 lessons, 11 min
3 min
This lesson introduces metrics as a way to answer if a home server is up, working, or stuck. It explains the tools and concepts needed to monitor a homelab using OpenTelemetry.
3 min
This lesson explains why node_exporter is used to collect host metrics on a Mac, as the OpenTelemetry Collector measures the virtual machine instead of the Mac. The learner learns that node_exporter is a small program from the Prometheus project that serves metrics on localhost.
3 min
This lesson demonstrates starting the OpenTelemetry Collector in Docker and explains its components, which function as a pipeline for data handling. The learner sees how the collector accepts metrics, processes them, and exports them in a format readable by Prometheus.
4 min
The learner uses a Python script to measure system status and sends these metrics to a collector using OTLP every 30 seconds. This process demonstrates how different types of metrics, such as gauges and counters, are implemented and reported.
Module 2
3 lessons, 9 min
4 min
This lesson explains how Prometheus stores metrics for 15 days and how Grafana displays them on a dashboard. It covers how these components run together and what the dashboard shows regarding system status and job processing.
4 min
The learner observes how Grafana checks predefined rules to send notifications when issues occur in a homelab setup. This demonstrates the process from a metric change to receiving an alert and a resolution notification.
3 min
The learner configures services to run automatically after a reboot and views the monitoring data from a phone. This demonstrates the end-to-end functionality of the OpenTelemetry Collector setup.
Get started
Start Free LessonFirst lesson is always free — no signup required
This course includes
Want all courses?
See Pro plan →Your instructor

Founder and CEO, Open Empower. About the author
More in AI Homelab on a Mac mini
All courses in this trackTurn a Mac mini into a reproducible homelab server
You will turn an Apple Silicon Mac mini into an always-on home server. You start by planning hardware choices and initializing a Git repository to track your setup steps. This foundation ensures your configuration is documented and ready for automation. You then configure remote access using SSH and Tailscale for secure connectivity. You also adjust power settings to keep the machine running continuously without interruption. Next, you use Homebrew with a Brewfile to manage software packages consistently. You create a Makefile that journals every command and output for full reproducibility. Finally, you add a read-only health check to verify system status. You learn to rebuild the entire setup on a clean machine from your repository.
Beginner · 4 lessons · 15 min · Updated Nov 2026
Preview free lesson
Virtual machines on Apple Silicon
You will build a Linux virtual machine on your Apple Silicon Mac using Colima and the Virtualization framework. You will point Docker to this VM and manage it with simple commands. You will share files between your Mac and the VM using virtiofs mounts. You will run AMD64 container images efficiently using Rosetta translation instead of slow emulation. You will size your VM correctly for your specific Mac hardware to avoid resource issues. You will create a plain Ubuntu VM with Lima for lab environments. You will configure launchd to start your VM automatically when you log in. You will learn to stop and clean up these virtual machines when you are done.
Beginner · 6 lessons · 20 min · Updated Nov 2026
Preview free lesson
Kubernetes on your Mac
You will build a multi-node Kubernetes cluster on your Apple Silicon Mac using kind. You start by creating a single-node cluster and then expand it to three nodes using a configuration file. You install applications with Helm and reach them from your Mac using ingress or Gateway. You also manage persistent storage and resource limits for your pods. You finish by tearing down and rebuilding the entire environment in minutes. You use a Makefile to automate the setup and cleanup process. This ensures your cluster is reproducible and easy to manage. You gain hands-on experience with a real cluster that runs entirely on your laptop.
Beginner · 6 lessons · 23 min · Updated Nov 2026
Preview free lesson