akpw/mktxp v1.2.16

on GitHub

🚀 New Features

• Interface Name Formatting, #176 #54
  • A breaking change 🔥, see Migration Notes below
  • Unified interface name formatting across all collectors
  • New interface_name_format option, replacing legacy use_comments_over_names. The new option values:

      `name`: Use interface name only (e.g. 'ether1')
      `comment`: Use comment if available, fallback to name if not
      `combined`: Use both (e.g. 'ether1 (Office Switch)')

• Dockerfile Improvements, #278

  • A breaking change 🔥, see Migration Notes below
  • Stable UID: Switch to UID 1000 for the mktxp user so it aligns with standard host users
  • Removed ENTRYPOINT for easier debugging / shell access
  • Support /etc/mktxp or XDG standard paths to avoid the bind-mount permission issues at the root level, while preserving backward compatibility
  • For examples of usage, see Readme

• User Collector Cardinality, #288

  • A breaking change 🔥, see Migration Notes below
  • Optimized active_users metrics to prevent high cardinality issues
  • The login timestamp (when) has been moved from a metric label to the metric value, preventing creation extraneous time series
  • New metric: mktxp_active_users_info, login timestamp (Unix epoch) as the value

• 5G Modem Metrics, #269

  • Extends existing LTE collector with 5G-specific measurements
  • New metrics: nr-rsrp (Reference Signal Received Power), nr-rsrq (Reference Signal Received Quality), nr-sinr (Signal-to-Interference-plus-Noise Ratio)

🐛 Bug Fixes

• Fixed DHCP name value handling, #279
• Editor detection and handling, #282

🔄 Migration Notes

• Interface Name Formatting, #176 #54
  Migration Impact by Collector:
  ✅ Auto-Migrated

  • Interface Collector: Existing use_comments_over_names setting automatically converts to equivalent interface_name_format
  • POE Collector: Existing use_comments_over_names setting automatically converts to equivalent interface_name_format
  • DHCP Name Resolution (used by Wireless, CAPsMAN, WiFi, Kid Control, and Connection Stats collectors)
    • Existing use_comments_over_names setting automatically converts to equivalent interface_name_format

  ⚠️ Partial Migration:

  • Netwatch Collector: Auto-migrates use_comments_over_names, but the default behavior changed based on RouterOS version
  • Action Required:
    • check the migrated interface_name_format option, and if needed set it up accordingly

  🔥 Breaking Changes

  • IPsec Active Peers Collector: Previously ALWAYS used comment as name (ignored use_comments_over_names)
  • Container Collector: Previously ALWAYS used comment as name (ignored use_comments_over_names)
  • Action Required: Set interface_name_format = comment to preserve old behavior

• Dockerfile Improvements, #278
  🔥 Breaking Changes

  • Volume Permissions: Since the container now runs as UID 1000, mapped configuration volumes must be readable/writable by this user
  • If using bind mounts (e.g., -v $(pwd)/mktxp:/etc/mktxp), ensure the host directory permissions allow access to UID 1000.
  • Example fix: chown -R 1000:1000 ./mktxp-config
  • For examples of usage, see Readme

• User Collector Cardinality, #288
  🔥 Breaking Changes

  • Changed active users from info metric to gauge metric with timestamp
  • Converts 'when' field from datetime string to Unix timestamp to resolve metric cardinality in Prometheus
  • Action Required: Update Prometheus queries and Grafana dashboards from active_users info metric to active_users_info gauge metric