How 0dimidrol0/devicemonitor works
DeviceMonitor is an Android telemetry and workload-protection toolkit. An app configures and starts the monitor; it collects device and optional frame telemetry, emits snapshots and warning events, derives adaptive workload recommendations, and tracks workload sessions through report export. Compose dashboard/card and the development overlay present monitor data. The README documents these capabilities; edges beyond the indexed caller references are omitted where implementation detail was not shown.
Main entry points: DeviceMonitorImpl.kt Telemetry collector · DeviceMonitor.kt Monitor API · DeviceMonitorDebugOverlayContent.kt Overlay content · AdaptiveWorkloadGuard.kt Adaptive guard
Components 24
Telemetry core
- Monitor API
device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt - Configuration
device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitorConfig.kt - Telemetry collector
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Device snapshots
device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceSnapshot.kt - Warning events
device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceWarningEvent.kt - Frame metrics
device-monitor-core/src/main/java/io/github/dimidrol/impl/FrameMetricsTracker.kt - Sensor providers
device-monitor-core/src/main/java/io/github/dimidrol/impl/SensorProviders.kt
Risk and sessions
- Recommendation policy
device-monitor-core/src/main/java/io/github/dimidrol/RecommendationPolicy.kt - Adaptive guard
device-monitor-core/src/main/java/io/github/dimidrol/impl/AdaptiveWorkloadGuard.kt - Workload recommendations
device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadRecommendation.kt - Workload sessions
device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSession.kt - Session reports
device-monitor-core/src/main/java/io/github/dimidrol/models/WorkloadSessionReport.kt - Report exporter
device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt
Compose UI
- Dashboard
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboard.kt - Compact card
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorCompactCard.kt - Dashboard content
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt - Metrics cards
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/MetricsCard.kt - Session card
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/SessionCard.kt
Debug overlay
- Overlay controller
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt - Overlay content
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt - Expanded panel
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayExpandedPanel.kt - Overlay bubble
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/OverlayBubbleView.kt - Clipboard export
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DebugOverlayClipboard.kt
Other components
- Android app
Connections 25
- Android app → Monitor API: configures and starts
- Monitor API → Telemetry collector: delegates to
device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt - Telemetry collector → Device snapshots: emits
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Telemetry collector → Warning events: emits
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Telemetry collector → Sensor providers: reads telemetry
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Telemetry collector → Frame metrics: uses metrics
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Monitor API → Configuration: accepts config
device-monitor-core/src/main/java/io/github/dimidrol/DeviceMonitor.kt - Telemetry collector → Adaptive guard: updates guard
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Adaptive guard → Recommendation policy: evaluates risk
device-monitor-core/src/main/java/io/github/dimidrol/RecommendationPolicy.kt - Adaptive guard → Workload recommendations: produces
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Telemetry collector → Workload sessions: updates session
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Telemetry collector → Session reports: completes session
device-monitor-core/src/main/java/io/github/dimidrol/impl/DeviceMonitorImpl.kt - Monitor API → Report exporter: exports report
device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt - Report exporter → Session reports: serializes
device-monitor-core/src/main/java/io/github/dimidrol/models/DeviceMonitorReportExporter.kt - Android app → Dashboard: displays
- Android app → Compact card: displays
- Dashboard → Dashboard content: renders
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboard.kt - Dashboard content → Metrics cards: renders
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt - Dashboard content → Session card: renders
device-monitor-ui-compose/src/main/java/io/github/dimidrol/ui/compose/DeviceMonitorDashboardContent.kt - Android app → Overlay controller: shows overlay
- Overlay controller → Monitor API: reads monitor
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt - Overlay controller → Overlay content: displays
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlay.kt - Overlay content → Expanded panel: renders
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt - Overlay content → Overlay bubble: renders
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt - Overlay content → Clipboard export: exports via
device-monitor-debug-overlay/src/main/java/io/github/dimidrol/debug/overlay/DeviceMonitorDebugOverlayContent.kt