Skip to content

Add macOS version tracking to telemetry

Overview

Currently, GDK telemetry only tracks the platform (e.g., "linux" or "macos") via GDK::Machine.platform. This limits our ability to correlate stability problems with specific macOS versions, especially when users upgrade their operating systems.

Impacted categories

The following categories relate to this issue:

  • gdk-usability - Improvements around how the GDK functions and provides better debugging information.

Proposal

Add a new field for platform version to capture more granular OS information:

  • For macOS: Track the specific version (e.g., "14.1", "13.6", "12.7")
  • This will help identify patterns in issues related to macOS upgrades
  • Enable better support and debugging for version-specific problems

Implementation considerations

  • Extend the existing GDK::Machine class to include version detection
  • Ensure the implementation works across different macOS versions
  • Consider privacy implications and ensure version data is anonymized appropriately
  • Update telemetry collection to include the new field

Acceptance criteria

  • Add platform version detection to GDK::Machine
  • Include macOS version in telemetry data
  • Verify version detection works on different macOS releases
  • Update any relevant documentation