GSam Battery Monitor - Users Guide
Users Guide (Version 3.35)
GSam Battery Monitor provides more complete monitoring capabilities than the built in Battery Usage app in Android. It relies on the same battery statistic data, however it lets the user drill down and find out much more detail.
Standard vs Enhanced Statistics Mode:
GSam operates in two modes - Standard, and Enhanced Statistics. In Standard mode, GSam attempts to collect all statistics itself. Since KitKat, Android has made this harder and harder each release as they clamp down on security settings. This is a GOOD thing, but it makes the standard collection mode less useful over time.
Enhanced Stats: By enabling enhanced statistics (Menu -> More -> Enable More Stats), GSam is able to access all raw battery stats that are maintained by the underlying platform. This does not require root, but it does require some manual steps by the user. The app will walk you through the steps to enable this. It's a pain, but is strongly recommended for for Nougat and beyond.
In Android Pie and later, even with enhanced stats enabled, we will use Standard Mode to track system wide stats, and Enhanced mode to track application specific stats. This is due to a change Android made restricting what APIs (programming interfaces) any app targeting Pie or later can call. In general you won't notice the difference, but if you do, you can re-enable the fully enhanced mode by turning allowing apps to access hidden APIs.
Some of the statistics shown in this guide may not be available without the Enhanced Stats enabled.
|Tablet View (Pro Version)|
The Professional and Kindle Fire versions of GSam Battery Monitor look somewhat different when run on Tablets, but the basic function is the same.
Phone: How long have you actually spent on the phone - talk time. This is only visible on devices with a phone.
Screen: How long has the screen been on. Dig into this field to see details of how the screen affects power usage:
Phone Radio: How long has the phone had a signal. Click on this row to get more details, including how long the phone has been at various signal strengths. You can also see the amount of data transferred over your mobile network.
Averages Per Complete Charge: Over time, GSam Battery Monitor averages the amount of time your phone lasts and amount of screen on time on a given charge cycle. Initially, this number will fluctuate considerably, but over time it should start to level out. This is an estimated value since it's rare that a complete (100%) discharge cycle occurs. The max value represents the maximum measured value.
- View % Power Used: Sort by the percent of overall power used by the application
- View CPU Minutes Used: Sort by the amount of CPU used by the application.
App Details Screen:
When clicking on an app in the App Sucker task, you will see a screen showing
View Statistics Since:
By default, GSam Battery Monitor shows you statistics based on when you last unplugged your phone. However GSam offers you other ways to view yours stats as well:
The charts task let's you see your battery % over time with various overlay supports. The overlays let
you see what events were happening at a given point in time. Do you see a precipitous drop in battery? Try and see what event caused that - perhaps you were in an active phone call? Perhaps you had GPS on?
Others: This is one of the more interesting ones. It plots:
- GPS - shows when GPS was active
- In Call - shows time spent in a phone call
- Wifi - shows time spent with wifi actively connected
- Screen - shows time spent with the screen on
- Doze - shows the time spent in Doze mode. The darker color indicates Deep Doze.
Temperature: This plots the battery temperature. Typically when the temperature of your batter increases, it's because your battery is getting heavy use, so expect to see the battery drop when the temperature rises
Phone Signal: A poor phone signal is often a cause of battery drain. You can plot your phone signal quality alongside your battery drain.
Rate Of Change: Shows the rate of change (battery discharge). This can be useful to quickly zoom in on problem areas.
CPU: This plots the CPU Utilization and CPU Average Frequency. This is sampled data over time, and so should not be taken too literally. That is, look at the overall trend, not a specific datapoint.
Notification / Status Icon:
In the notification menu, you can see the latest time remaining estimates. For more on the Estimates, see the Main Screen section below. Clicking on the notification message will launch the app, allowing you to get to the Main Screen.
You can chose not to show the notification icon at all if you already have an alternative way to see the battery percent. Even better, on Jelly bean you can show the notification status without showing an icon.
An Overlay icon is also supported (requires the Icon-Pack add-on). This allows you to overlay the stock battery icon in the top right of the screen. It's size and location is fully configurable, and it should automatically hide when an app is in full-screen mode. For more information, see the Overlay blog post.
Widgets: There are 2 widgets supported and are pictured on the right. You need to have the app installed on internal storage in order to use widgets. You can add them to any screen just like any other widget.
Most preferences are self explanatory. The ones below require more explanation:
Alarms: You can set alarms to notify you when your battery is fully charged, or when it reaches a certain low-threshold. These alarms will audibly and visually notify you. The 'Hot Battery' alarm will notify you when your battery gets too hot. The alarm will stay in your notification tray until your battery gets back to a normal temperature.
Allow Anonymous Usage Reporting: This will report usage information using the Flurry service. If you desire, you can turn this off - but we're using this to help improve the app - no personal information is sent. Using Flurry allows us to do the following:
- See how users are using the app. This lets us make improvements to the application over time.
Note: Adjust the Device Power Profile with care. There are very few devices that need adjustment.
Power Per Percent: You shouldn't touch this setting except if you change your power profile. If you do, then zero out the value in here. This value gets used to calculate estimated times remaining, so if your time remaining seems completely wrong, you can adjust these numbers. They are automatically generated based on your usage, and so if you manually change things, you may want to set the TOTAL_PERCENT_MEASURED value to be very high as the higher it is, the less current usage will affect the POWER_USED_PER_PERCENT_DROP.
GSam Battery Monitor uses the following Android permissions.
- Used to display ads (only on the Free version if user has chosen to view Ads)
- Used to display a chart in the Charts view using the google chart API.
- For Lollipop and beyond, you need to manually enable this via ADB (See Enhanced Stats)