Skip to content

Changelog

0.28.2 (2026-03-26)

Bug Fixes

  • deps: update dependency meraki to v2.2.0 (#173) (342aa2e)
  • devices: use availability_status field for device status detection (4e40908), closes #186

Code Refactoring

  • devices: remove common metrics collection from device-specific collectors (8ec6095)

0.28.1 (2026-03-13)

Dependencies

  • switch meraki from git to PyPI source & update (8bc84a4)

0.28.0 (2026-03-13)

Features

  • add API metrics instrumentation (a688581)
  • add collector management helper methods (caa563a)
  • add collector status display and trigger UI (6e08cfb)
  • add collector trigger endpoint (b7b169e)
  • add manual collector trigger API endpoint (507f0d8)
  • add MX appliance uplink status metrics (ad153ef)
  • add MX appliance uplink status metrics (09d3554)
  • add MX uplink info metric (99c33c1)
  • add new observability metrics (abc0dec)
  • add thread-safe metrics initialization (abed04b)
  • api: add rate limiting and collection smoothing (d1e56ef)
  • core: add timeout-based smoothing cap (4834801)
  • enhance startup logging and discovery (fb98bdc)
  • inventory: add device availability caching (1ea56e9)
  • logging: add smoothing cap to startup (56fc174)
  • otel: add metrics export routing config (e199645)
  • otel: add metrics filtering system (a67287e)
  • otel: integrate filtering into app (84633f0)
  • ui: expose smoothing cap diagnostics (da6bc9b)

Bug Fixes

  • ci: skip registry cache on PRs to prevent 403 errors (e971085)
  • clear stale device status label series (d0de7e4)
  • clear stale MX uplink status labels (57420b9)
  • device: improve status result validation (97364ad)
  • ensure metrics available in inventory service (d856ed0)
  • improve retry logic with jitter and Retry-After (98be37e)
  • ms: add SDK method availability check (2b2a99c)
  • ms: correct API endpoint for switch ports status (c9f551d)
  • prevent race conditions in device lookup (ecdbfce)
  • resolve test failures in device collector and error handling tests (4707340)
  • secure sensitive data masking in logs (89120a4)

Performance Improvements

  • mr: optimize to network-level collection (3d4a0a4)

Code Refactoring

  • add collector tracking infrastructure (c33bdef)
  • add concurrency control to collector execution (a5c59c7)
  • alerts: use inventory cache for data (16f29b8)
  • api: use inventory cache in APIHelper (4d7feb0)
  • ci: simplify docs workflow and remove deps (800196b)
  • collectors: add inventory access pattern (36b6941)
  • config: use inventory cache for orgs (3a217ca)
  • device: use inventory for availability (a5cff09)
  • enhance batch processing in collectors (001bd0c)
  • improve startup sequence with sequential init (4dcace4)
  • metrics: rename to meraki_exporter_ prefix (6a983cf)
  • otel: remove span metrics processor (cef99d5)
  • remove unused imports and metrics code (ca8721e)
  • reuse AsyncMerakiClient metrics counter (a4ebab9)
  • simplify config defaults and add docs tooling (6cd4a6f)
  • use instrumented API calls (f46afc4)

Documentation

  • add missing parameter documentation (621b81f)
  • clean up formatting and descriptions (9fa79c6)
  • config: update configuration reference (c9ff636)
  • improve OpenTelemetry configuration (a8e1a48)
  • metrics: update metrics documentation (9ff5b3a)
  • otel: update observability guides (fdd0c64)
  • remove ADR and patterns sections (8dc3710)
  • streamline collector documentation (ca79d1c)
  • update (8c05f71)
  • update API configuration reference (05c56e3)
  • update endpoint reference (4f56bb1)
  • update getting started and guides (c148640)
  • update metrics overview and index (381330f)

0.27.1 (2025-12-01)

Bug Fixes

  • add automated docker build on release creation (c6e3328)

0.27.0 (2025-12-01)

Features

  • add retry mechanism for rate-limited API responses (7177659)

Bug Fixes

  • error-handling: add api error response validation (d4708df)

Documentation

  • add comprehensive changelog for version 0.26.1 (bc70586)

0.26.1 (2025-12-01)

Bug Fixes

  • remove error suppression from docker help test (3a4af40)

Code Refactoring

  • replace asyncio with inspect for coroutine detection (d9976c1)

Documentation

  • rewrite collector reference with practical usage guide (489d631)

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.26.1] - 2025-12-01

Highlights

  • Bounded parallel collection with shared inventory caching and configurable batch sizes to speed up multi-org runs and cut API calls.
  • Docker-first packaging with a dedicated entrypoint plus a refreshed dependency stack targeting Python 3.14.
  • Wireless SSID collection fixes that align with the latest Meraki APIs for more accurate MR metrics.
  • Documentation overhaul (new collector guide, config updates, SEO/social cards) and release automation via release-please.

Features & Improvements

  • Added an inventory caching service (organizations, networks, devices) with TTLs, new collector concurrency/cache metrics, and the metric expiration framework controlled by MERAKI_EXPORTER_MONITORING__METRIC_TTL_MULTIPLIER.
  • Collectors now use ManagedTaskGroup bounded concurrency and larger configurable batch sizes (devices 20, networks 30, clients 20 by default) for faster collection.
  • Docker image rebuilt around docker-entrypoint.py and docs now recommend Docker as the primary deployment path.
  • Expanded .env.example with grouped settings, OTEL/monitoring options, and added uv.lock for reproducible installs; exposed the package main for easier embedding.
  • Improved OpenTelemetry tracing coverage and API client hooks; added Claude PR/code-review workflows and release-please automation.

Fixes

  • MR wireless collector now paginates SSID status, parses radio details correctly, and uses the organization summary SSID usage endpoint.
  • Device type detection falls back to productType when the model prefix is unknown (thanks @dmitchsplunk for the first external contribution in #83).
  • Docker CLI help test no longer suppresses errors, ensuring failures surface during CI.

Documentation

  • Collector reference rewritten into a practical usage guide; configuration docs updated with new settings and metric TTL guidance.
  • Documentation site moved to https://m7kni.io with new SEO/social assets and Docker-first getting started flow.

CI/CD

  • Baseline runtime and CI bumped to Python 3.14 with refreshed dependency pins and pre-commit hooks.
  • CI simplified to Ubuntu-only testing, optimized PR Docker builds, and removed legacy workflows (PyPI publish, Dependabot, CodeQL, etc.).

Contributors

  • @dmitchsplunk for improving device type detection (first external community contribution).