# google/battery-historian

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/google-battery-historian).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

5,401 stars · 968 forks · Go · NOASSERTION · archived

## Links

- GitHub: https://github.com/google/battery-historian
- awesome-repositories: https://awesome-repositories.com/repository/google-battery-historian.md

## Description

Battery Historian is a visualization and profiling tool for analyzing power consumption and battery drain on Android devices. It functions as a bugreport viewer and power consumption profiler that parses system logs to extract battery statistics and kernel data into a web-based interface.

The tool specializes in correlating disparate data sources on a synchronized chronological timeline. It identifies power-draining activities by tracking userspace and kernel wakelock transitions, mapping kernel wakeup sources to real-time timestamps, and overlaying external hardware power monitor logs onto system events.

The system provides capabilities for comparative analysis, allowing for the calculation of deltas between multiple bugreports to measure changes in power behavior. It further aggregates application-level metrics and system events to pinpoint specific software triggers that prevent a device from entering sleep mode.

## Tags

### Operating Systems & Systems Programming

- [Battery Analysis Tools](https://awesome-repositories.com/f/operating-systems-systems-programming/power-management/battery-power-optimization/battery-analysis-tools.md) — Provides a comprehensive visualization tool for analyzing power consumption and battery drain using Android bugreport files.
- [Android Kernel Power Debugging](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-component-debugging/android-kernel-power-debugging.md) — Correlates kernel wakeup sources and system events on a timeline to troubleshoot low-level power drainage issues.
- [Wakeup Trigger Analysis](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-task-inspection/kernel-event-stream-inspection/wakeup-trigger-analysis.md) — Logs kernel wakeup sources and activities to identify low-level system triggers for power consumption. ([source](https://github.com/google/battery-historian/blob/master/README.md))
- [Wakelock Analysis Tools](https://awesome-repositories.com/f/operating-systems-systems-programming/wakelock-analysis-tools.md) — Tracks individual userspace wakelock transitions on a timeline to pinpoint applications preventing the device from sleeping. ([source](https://github.com/google/battery-historian/blob/master/README.md))
- [Mobile App Energy Optimization](https://awesome-repositories.com/f/operating-systems-systems-programming/power-management/battery-power-optimization/app-freezing-optimizations/mobile-app-energy-optimization.md) — Reduces energy consumption in Android apps by tracking wakelocks and identifying software triggers that prevent device sleep.
- [Battery Power Benchmarking](https://awesome-repositories.com/f/operating-systems-systems-programming/power-management/battery-power-optimization/battery-power-benchmarking.md) — Compares multiple Android battery reports to measure the impact of code changes on overall power consumption.

### System Administration & Monitoring

- [Battery Consumption Visualizations](https://awesome-repositories.com/f/system-administration-monitoring/battery-consumption-visualizations.md) — Plots system and application level events on a zoomable timeline to identify power-draining activities. ([source](https://github.com/google/battery-historian#readme))
- [Power Consumption Metrics](https://awesome-repositories.com/f/system-administration-monitoring/application-metric-tracking/power-consumption-metrics.md) — Aggregates battery statistics to identify specific metrics that impact power consumption for selected applications. ([source](https://github.com/google/battery-historian#readme))
- [Wakeup Source Correlation](https://awesome-repositories.com/f/system-administration-monitoring/diagnostic-tools/diagnostics/execution-tracers/kernel-tracing-frameworks/system-call-tracing/trace-recording/kernel-trace-event-recorders/wakeup-source-correlation.md) — Maps kernel wakeup sources and activities from logs to real-time timestamps for synchronization with system events. ([source](https://github.com/google/battery-historian#readme))
- [Log File Parsing](https://awesome-repositories.com/f/system-administration-monitoring/log-file-tailing/log-file-parsing.md) — Parses Android system bugreport text files to extract battery statistics and kernel logs into structured formats.
- [Bugreport Viewers](https://awesome-repositories.com/f/system-administration-monitoring/log-management-systems/android-system-log-captures/bugreport-viewers.md) — Ships a web interface for parsing and visualizing system logs and power metrics from Android device reports.
- [Power Consumption Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/power-consumption-monitoring.md) — Integrates external power monitor logs with system events to track energy usage and identify battery-draining code paths. ([source](https://github.com/google/battery-historian#readme))
- [Hardware Log Overlays](https://awesome-repositories.com/f/system-administration-monitoring/system-logging/external-log-sources/hardware-log-overlays.md) — Integrates third-party hardware power monitor logs with internal system events using shared timestamps.
- [Scheduling Timeline Visualizers](https://awesome-repositories.com/f/system-administration-monitoring/execution-path-visualization/thread-execution-state-visualizers/execution-timeline-visualizers/scheduling-timeline-visualizers.md) — Maps discrete system events and power metrics onto a synchronized chronological axis for visual correlation.
- [Log Aggregation](https://awesome-repositories.com/f/system-administration-monitoring/log-aggregation.md) — Combines multiple disparate log sources into a unified timeline to identify patterns in battery drain.
- [Metric Value Comparisons](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/metric-performance-monitors/periodical-comparisons/metric-value-comparisons.md) — Calculates delta values between separate data sets to highlight changes in power consumption.

### Mobile Development

- [Android Battery Analysis](https://awesome-repositories.com/f/mobile-development/android-battery-analysis.md) — Analyzes Android bugreport files to identify which applications or system processes are consuming the most power.
- [Wakelock Analyzers](https://awesome-repositories.com/f/mobile-development/wakelock-analyzers.md) — Battery Historian displays detailed timestamps and individual events on a timeline to pinpoint exactly when applications prevent a device from sleeping. ([source](https://github.com/google/battery-historian#readme))

### Data & Databases

- [Client-Side Data Processing](https://awesome-repositories.com/f/data-databases/client-side-data-processing.md) — Processes and displays large volumes of event data within a web browser to allow interactive zooming and filtering.

### Software Engineering & Architecture

- [Dataset Comparison Reports](https://awesome-repositories.com/f/software-engineering-architecture/file-comparison-tools/comparison-reporting/dataset-comparison-reports.md) — Performs A/B comparisons between battery reports to highlight differences in key energy metrics. ([source](https://github.com/google/battery-historian#readme))

### Part of an Awesome List

- [Development Tooling](https://awesome-repositories.com/f/awesome-lists/devtools/development-tooling.md) — Tool for analyzing battery consumption reports.