UserUsageStatsService.java revision 7856f3c283e6332c22d5cee41d2e673e1dfe09f8
1/**
2 * Copyright (C) 2014 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
5 * use this file except in compliance with the License. You may obtain a copy
6 * of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13 * License for the specific language governing permissions and limitations
14 * under the License.
15 */
16
17package com.android.server.usage;
18
19import android.app.usage.ConfigurationStats;
20import android.app.usage.TimeSparseArray;
21import android.app.usage.UsageEvents;
22import android.app.usage.UsageEvents.Event;
23import android.app.usage.UsageStats;
24import android.app.usage.UsageStatsManager;
25import android.content.pm.PackageInfo;
26import android.content.pm.PackageManager;
27import android.content.res.Configuration;
28import android.os.SystemClock;
29import android.content.Context;
30import android.text.format.DateUtils;
31import android.util.ArrayMap;
32import android.util.ArraySet;
33import android.util.Slog;
34
35import com.android.internal.util.IndentingPrintWriter;
36import com.android.server.usage.UsageStatsDatabase.StatCombiner;
37
38import java.io.File;
39import java.io.IOException;
40import java.text.SimpleDateFormat;
41import java.util.ArrayList;
42import java.util.Arrays;
43import java.util.List;
44
45/**
46 * A per-user UsageStatsService. All methods are meant to be called with the main lock held
47 * in UsageStatsService.
48 */
49class UserUsageStatsService {
50    private static final String TAG = "UsageStatsService";
51    private static final boolean DEBUG = UsageStatsService.DEBUG;
52    private static final SimpleDateFormat sDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
53    private static final int sDateFormatFlags =
54            DateUtils.FORMAT_SHOW_DATE
55            | DateUtils.FORMAT_SHOW_TIME
56            | DateUtils.FORMAT_SHOW_YEAR
57            | DateUtils.FORMAT_NUMERIC_DATE;
58
59    private final Context mContext;
60    private final UsageStatsDatabase mDatabase;
61    private final IntervalStats[] mCurrentStats;
62    private IntervalStats mAppIdleRollingWindow;
63    private boolean mStatsChanged = false;
64    private final UnixCalendar mDailyExpiryDate;
65    private final StatsUpdatedListener mListener;
66    private final String mLogPrefix;
67    private final int mUserId;
68
69    private static final long[] INTERVAL_LENGTH = new long[] {
70            UnixCalendar.DAY_IN_MILLIS, UnixCalendar.WEEK_IN_MILLIS,
71            UnixCalendar.MONTH_IN_MILLIS, UnixCalendar.YEAR_IN_MILLIS
72    };
73
74    interface StatsUpdatedListener {
75        void onStatsUpdated();
76    }
77
78    UserUsageStatsService(Context context, int userId, File usageStatsDir,
79            StatsUpdatedListener listener) {
80        mContext = context;
81        mDailyExpiryDate = new UnixCalendar(0);
82        mDatabase = new UsageStatsDatabase(usageStatsDir);
83        mCurrentStats = new IntervalStats[UsageStatsManager.INTERVAL_COUNT];
84        mListener = listener;
85        mLogPrefix = "User[" + Integer.toString(userId) + "] ";
86        mUserId = userId;
87    }
88
89    void init(final long currentTimeMillis, final long deviceUsageTime) {
90        mDatabase.init(currentTimeMillis);
91
92        int nullCount = 0;
93        for (int i = 0; i < mCurrentStats.length; i++) {
94            mCurrentStats[i] = mDatabase.getLatestUsageStats(i);
95            if (mCurrentStats[i] == null) {
96                // Find out how many intervals we don't have data for.
97                // Ideally it should be all or none.
98                nullCount++;
99            }
100        }
101
102        if (nullCount > 0) {
103            if (nullCount != mCurrentStats.length) {
104                // This is weird, but we shouldn't fail if something like this
105                // happens.
106                Slog.w(TAG, mLogPrefix + "Some stats have no latest available");
107            } else {
108                // This must be first boot.
109            }
110
111            // By calling loadActiveStats, we will
112            // generate new stats for each bucket.
113            loadActiveStats(currentTimeMillis, /*resetBeginIdleTime=*/ false);
114        } else {
115            // Set up the expiry date to be one day from the latest daily stat.
116            // This may actually be today and we will rollover on the first event
117            // that is reported.
118            updateRolloverDeadline();
119        }
120
121        // Now close off any events that were open at the time this was saved.
122        for (IntervalStats stat : mCurrentStats) {
123            final int pkgCount = stat.packageStats.size();
124            for (int i = 0; i < pkgCount; i++) {
125                UsageStats pkgStats = stat.packageStats.valueAt(i);
126                if (pkgStats.mLastEvent == UsageEvents.Event.MOVE_TO_FOREGROUND ||
127                        pkgStats.mLastEvent == UsageEvents.Event.CONTINUE_PREVIOUS_DAY) {
128                    stat.update(pkgStats.mPackageName, stat.lastTimeSaved,
129                            UsageEvents.Event.END_OF_DAY);
130                    notifyStatsChanged();
131                }
132            }
133
134            stat.updateConfigurationStats(null, stat.lastTimeSaved);
135        }
136
137        refreshAppIdleRollingWindow(currentTimeMillis, deviceUsageTime);
138
139        if (mDatabase.isNewUpdate()) {
140            initializeDefaultsForApps(currentTimeMillis, deviceUsageTime,
141                    mDatabase.isFirstUpdate());
142        }
143    }
144
145    /**
146     * If any of the apps don't have a last-used entry, add one now.
147     * @param currentTimeMillis the current time
148     * @param firstUpdate if it is the first update, touch all installed apps, otherwise only
149     *        touch the system apps
150     */
151    private void initializeDefaultsForApps(long currentTimeMillis, long deviceUsageTime,
152            boolean firstUpdate) {
153        PackageManager pm = mContext.getPackageManager();
154        List<PackageInfo> packages = pm.getInstalledPackagesAsUser(0, mUserId);
155        final int packageCount = packages.size();
156        for (int i = 0; i < packageCount; i++) {
157            final PackageInfo pi = packages.get(i);
158            String packageName = pi.packageName;
159            if (pi.applicationInfo != null && (firstUpdate || pi.applicationInfo.isSystemApp())
160                    && getBeginIdleTime(packageName) == -1) {
161                for (IntervalStats stats : mCurrentStats) {
162                    stats.update(packageName, currentTimeMillis, Event.SYSTEM_INTERACTION);
163                    stats.updateBeginIdleTime(packageName, deviceUsageTime);
164                }
165
166                mAppIdleRollingWindow.update(packageName, currentTimeMillis,
167                        Event.SYSTEM_INTERACTION);
168                mAppIdleRollingWindow.updateBeginIdleTime(packageName, deviceUsageTime);
169                mStatsChanged = true;
170            }
171        }
172        // Persist the new OTA-related access stats.
173        persistActiveStats();
174    }
175
176    void onTimeChanged(long oldTime, long newTime, long deviceUsageTime,
177                       boolean resetBeginIdleTime) {
178        persistActiveStats();
179        mDatabase.onTimeChanged(newTime - oldTime);
180        loadActiveStats(newTime, resetBeginIdleTime);
181        refreshAppIdleRollingWindow(newTime, deviceUsageTime);
182    }
183
184    void reportEvent(UsageEvents.Event event, long deviceUsageTime) {
185        if (DEBUG) {
186            Slog.d(TAG, mLogPrefix + "Got usage event for " + event.mPackage
187                    + "[" + event.mTimeStamp + "]: "
188                    + eventToString(event.mEventType));
189        }
190
191        if (event.mTimeStamp >= mDailyExpiryDate.getTimeInMillis()) {
192            // Need to rollover
193            rolloverStats(event.mTimeStamp, deviceUsageTime);
194        }
195
196        final IntervalStats currentDailyStats = mCurrentStats[UsageStatsManager.INTERVAL_DAILY];
197
198        final Configuration newFullConfig = event.mConfiguration;
199        if (event.mEventType == UsageEvents.Event.CONFIGURATION_CHANGE &&
200                currentDailyStats.activeConfiguration != null) {
201            // Make the event configuration a delta.
202            event.mConfiguration = Configuration.generateDelta(
203                    currentDailyStats.activeConfiguration, newFullConfig);
204        }
205
206        // Add the event to the daily list.
207        if (currentDailyStats.events == null) {
208            currentDailyStats.events = new TimeSparseArray<>();
209        }
210        if (event.mEventType != UsageEvents.Event.SYSTEM_INTERACTION) {
211            currentDailyStats.events.put(event.mTimeStamp, event);
212        }
213
214        for (IntervalStats stats : mCurrentStats) {
215            if (event.mEventType == UsageEvents.Event.CONFIGURATION_CHANGE) {
216                stats.updateConfigurationStats(newFullConfig, event.mTimeStamp);
217            } else {
218                stats.update(event.mPackage, event.mTimeStamp, event.mEventType);
219                stats.updateBeginIdleTime(event.mPackage, deviceUsageTime);
220            }
221        }
222
223        if (event.mEventType != Event.CONFIGURATION_CHANGE) {
224            mAppIdleRollingWindow.update(event.mPackage, event.mTimeStamp, event.mEventType);
225            mAppIdleRollingWindow.updateBeginIdleTime(event.mPackage, deviceUsageTime);
226        }
227
228        notifyStatsChanged();
229    }
230
231    /**
232     * Sets the beginIdleTime for each of the intervals.
233     * @param beginIdleTime
234     */
235    void setBeginIdleTime(String packageName, long beginIdleTime) {
236        for (IntervalStats stats : mCurrentStats) {
237            stats.updateBeginIdleTime(packageName, beginIdleTime);
238        }
239        mAppIdleRollingWindow.updateBeginIdleTime(packageName, beginIdleTime);
240        notifyStatsChanged();
241    }
242
243    void setSystemLastUsedTime(String packageName, long lastUsedTime) {
244        for (IntervalStats stats : mCurrentStats) {
245            stats.updateSystemLastUsedTime(packageName, lastUsedTime);
246        }
247        mAppIdleRollingWindow.updateSystemLastUsedTime(packageName, lastUsedTime);
248        notifyStatsChanged();
249    }
250
251    private static final StatCombiner<UsageStats> sUsageStatsCombiner =
252            new StatCombiner<UsageStats>() {
253                @Override
254                public void combine(IntervalStats stats, boolean mutable,
255                                    List<UsageStats> accResult) {
256                    if (!mutable) {
257                        accResult.addAll(stats.packageStats.values());
258                        return;
259                    }
260
261                    final int statCount = stats.packageStats.size();
262                    for (int i = 0; i < statCount; i++) {
263                        accResult.add(new UsageStats(stats.packageStats.valueAt(i)));
264                    }
265                }
266            };
267
268    private static final StatCombiner<ConfigurationStats> sConfigStatsCombiner =
269            new StatCombiner<ConfigurationStats>() {
270                @Override
271                public void combine(IntervalStats stats, boolean mutable,
272                                    List<ConfigurationStats> accResult) {
273                    if (!mutable) {
274                        accResult.addAll(stats.configurations.values());
275                        return;
276                    }
277
278                    final int configCount = stats.configurations.size();
279                    for (int i = 0; i < configCount; i++) {
280                        accResult.add(new ConfigurationStats(stats.configurations.valueAt(i)));
281                    }
282                }
283            };
284
285    /**
286     * Generic query method that selects the appropriate IntervalStats for the specified time range
287     * and bucket, then calls the {@link com.android.server.usage.UsageStatsDatabase.StatCombiner}
288     * provided to select the stats to use from the IntervalStats object.
289     */
290    private <T> List<T> queryStats(int intervalType, final long beginTime, final long endTime,
291            StatCombiner<T> combiner) {
292        if (intervalType == UsageStatsManager.INTERVAL_BEST) {
293            intervalType = mDatabase.findBestFitBucket(beginTime, endTime);
294            if (intervalType < 0) {
295                // Nothing saved to disk yet, so every stat is just as equal (no rollover has
296                // occurred.
297                intervalType = UsageStatsManager.INTERVAL_DAILY;
298            }
299        }
300
301        if (intervalType < 0 || intervalType >= mCurrentStats.length) {
302            if (DEBUG) {
303                Slog.d(TAG, mLogPrefix + "Bad intervalType used " + intervalType);
304            }
305            return null;
306        }
307
308        final IntervalStats currentStats = mCurrentStats[intervalType];
309
310        if (DEBUG) {
311            Slog.d(TAG, mLogPrefix + "SELECT * FROM " + intervalType + " WHERE beginTime >= "
312                    + beginTime + " AND endTime < " + endTime);
313        }
314
315        if (beginTime >= currentStats.endTime) {
316            if (DEBUG) {
317                Slog.d(TAG, mLogPrefix + "Requesting stats after " + beginTime + " but latest is "
318                        + currentStats.endTime);
319            }
320            // Nothing newer available.
321            return null;
322        }
323
324        // Truncate the endTime to just before the in-memory stats. Then, we'll append the
325        // in-memory stats to the results (if necessary) so as to avoid writing to disk too
326        // often.
327        final long truncatedEndTime = Math.min(currentStats.beginTime, endTime);
328
329        // Get the stats from disk.
330        List<T> results = mDatabase.queryUsageStats(intervalType, beginTime,
331                truncatedEndTime, combiner);
332        if (DEBUG) {
333            Slog.d(TAG, "Got " + (results != null ? results.size() : 0) + " results from disk");
334            Slog.d(TAG, "Current stats beginTime=" + currentStats.beginTime +
335                    " endTime=" + currentStats.endTime);
336        }
337
338        // Now check if the in-memory stats match the range and add them if they do.
339        if (beginTime < currentStats.endTime && endTime > currentStats.beginTime) {
340            if (DEBUG) {
341                Slog.d(TAG, mLogPrefix + "Returning in-memory stats");
342            }
343
344            if (results == null) {
345                results = new ArrayList<>();
346            }
347            combiner.combine(currentStats, true, results);
348        }
349
350        if (DEBUG) {
351            Slog.d(TAG, mLogPrefix + "Results: " + (results != null ? results.size() : 0));
352        }
353        return results;
354    }
355
356    List<UsageStats> queryUsageStats(int bucketType, long beginTime, long endTime) {
357        return queryStats(bucketType, beginTime, endTime, sUsageStatsCombiner);
358    }
359
360    List<ConfigurationStats> queryConfigurationStats(int bucketType, long beginTime, long endTime) {
361        return queryStats(bucketType, beginTime, endTime, sConfigStatsCombiner);
362    }
363
364    UsageEvents queryEvents(final long beginTime, final long endTime) {
365        final ArraySet<String> names = new ArraySet<>();
366        List<UsageEvents.Event> results = queryStats(UsageStatsManager.INTERVAL_DAILY,
367                beginTime, endTime, new StatCombiner<UsageEvents.Event>() {
368                    @Override
369                    public void combine(IntervalStats stats, boolean mutable,
370                            List<UsageEvents.Event> accumulatedResult) {
371                        if (stats.events == null) {
372                            return;
373                        }
374
375                        final int startIndex = stats.events.closestIndexOnOrAfter(beginTime);
376                        if (startIndex < 0) {
377                            return;
378                        }
379
380                        final int size = stats.events.size();
381                        for (int i = startIndex; i < size; i++) {
382                            if (stats.events.keyAt(i) >= endTime) {
383                                return;
384                            }
385
386                            final UsageEvents.Event event = stats.events.valueAt(i);
387                            names.add(event.mPackage);
388                            if (event.mClass != null) {
389                                names.add(event.mClass);
390                            }
391                            accumulatedResult.add(event);
392                        }
393                    }
394                });
395
396        if (results == null || results.isEmpty()) {
397            return null;
398        }
399
400        String[] table = names.toArray(new String[names.size()]);
401        Arrays.sort(table);
402        return new UsageEvents(results, table);
403    }
404
405    long getBeginIdleTime(String packageName) {
406        UsageStats packageUsage;
407        if ((packageUsage = mAppIdleRollingWindow.packageStats.get(packageName)) == null) {
408            return -1;
409        } else {
410            return packageUsage.getBeginIdleTime();
411        }
412    }
413
414    long getSystemLastUsedTime(String packageName) {
415        UsageStats packageUsage;
416        if ((packageUsage = mAppIdleRollingWindow.packageStats.get(packageName)) == null) {
417            return -1;
418        } else {
419            return packageUsage.getLastTimeSystemUsed();
420        }
421    }
422
423    void persistActiveStats() {
424        if (mStatsChanged) {
425            Slog.i(TAG, mLogPrefix + "Flushing usage stats to disk");
426            try {
427                for (int i = 0; i < mCurrentStats.length; i++) {
428                    mDatabase.putUsageStats(i, mCurrentStats[i]);
429                }
430                mStatsChanged = false;
431            } catch (IOException e) {
432                Slog.e(TAG, mLogPrefix + "Failed to persist active stats", e);
433            }
434        }
435    }
436
437    private void rolloverStats(final long currentTimeMillis, final long deviceUsageTime) {
438        final long startTime = SystemClock.elapsedRealtime();
439        Slog.i(TAG, mLogPrefix + "Rolling over usage stats");
440
441        // Finish any ongoing events with an END_OF_DAY event. Make a note of which components
442        // need a new CONTINUE_PREVIOUS_DAY entry.
443        final Configuration previousConfig =
444                mCurrentStats[UsageStatsManager.INTERVAL_DAILY].activeConfiguration;
445        ArraySet<String> continuePreviousDay = new ArraySet<>();
446        for (IntervalStats stat : mCurrentStats) {
447            final int pkgCount = stat.packageStats.size();
448            for (int i = 0; i < pkgCount; i++) {
449                UsageStats pkgStats = stat.packageStats.valueAt(i);
450                if (pkgStats.mLastEvent == UsageEvents.Event.MOVE_TO_FOREGROUND ||
451                        pkgStats.mLastEvent == UsageEvents.Event.CONTINUE_PREVIOUS_DAY) {
452                    continuePreviousDay.add(pkgStats.mPackageName);
453                    stat.update(pkgStats.mPackageName, mDailyExpiryDate.getTimeInMillis() - 1,
454                            UsageEvents.Event.END_OF_DAY);
455                    notifyStatsChanged();
456                }
457            }
458
459            stat.updateConfigurationStats(null, mDailyExpiryDate.getTimeInMillis() - 1);
460        }
461
462        persistActiveStats();
463        mDatabase.prune(currentTimeMillis);
464        loadActiveStats(currentTimeMillis, /*resetBeginIdleTime=*/ false);
465
466        final int continueCount = continuePreviousDay.size();
467        for (int i = 0; i < continueCount; i++) {
468            String name = continuePreviousDay.valueAt(i);
469            final long beginTime = mCurrentStats[UsageStatsManager.INTERVAL_DAILY].beginTime;
470            for (IntervalStats stat : mCurrentStats) {
471                stat.update(name, beginTime, UsageEvents.Event.CONTINUE_PREVIOUS_DAY);
472                stat.updateConfigurationStats(previousConfig, beginTime);
473                notifyStatsChanged();
474            }
475        }
476        persistActiveStats();
477
478        refreshAppIdleRollingWindow(currentTimeMillis, deviceUsageTime);
479
480        final long totalTime = SystemClock.elapsedRealtime() - startTime;
481        Slog.i(TAG, mLogPrefix + "Rolling over usage stats complete. Took " + totalTime
482                + " milliseconds");
483    }
484
485    private void notifyStatsChanged() {
486        if (!mStatsChanged) {
487            mStatsChanged = true;
488            mListener.onStatsUpdated();
489        }
490    }
491
492    private void loadActiveStats(final long currentTimeMillis, boolean resetBeginIdleTime) {
493        for (int intervalType = 0; intervalType < mCurrentStats.length; intervalType++) {
494            final IntervalStats stats = mDatabase.getLatestUsageStats(intervalType);
495            if (stats != null && currentTimeMillis - 500 >= stats.endTime &&
496                    currentTimeMillis < stats.beginTime + INTERVAL_LENGTH[intervalType]) {
497                if (DEBUG) {
498                    Slog.d(TAG, mLogPrefix + "Loading existing stats @ " +
499                            sDateFormat.format(stats.beginTime) + "(" + stats.beginTime +
500                            ") for interval " + intervalType);
501                }
502                mCurrentStats[intervalType] = stats;
503            } else {
504                // No good fit remains.
505                if (DEBUG) {
506                    Slog.d(TAG, "Creating new stats @ " +
507                            sDateFormat.format(currentTimeMillis) + "(" +
508                            currentTimeMillis + ") for interval " + intervalType);
509                }
510
511                mCurrentStats[intervalType] = new IntervalStats();
512                mCurrentStats[intervalType].beginTime = currentTimeMillis;
513                mCurrentStats[intervalType].endTime = currentTimeMillis + 1;
514            }
515
516            if (resetBeginIdleTime) {
517                for (UsageStats usageStats : mCurrentStats[intervalType].packageStats.values()) {
518                    usageStats.mBeginIdleTime = 0;
519                }
520            }
521        }
522
523        mStatsChanged = false;
524        updateRolloverDeadline();
525    }
526
527    private void updateRolloverDeadline() {
528        mDailyExpiryDate.setTimeInMillis(
529                mCurrentStats[UsageStatsManager.INTERVAL_DAILY].beginTime);
530        mDailyExpiryDate.addDays(1);
531        Slog.i(TAG, mLogPrefix + "Rollover scheduled @ " +
532                sDateFormat.format(mDailyExpiryDate.getTimeInMillis()) + "(" +
533                mDailyExpiryDate.getTimeInMillis() + ")");
534    }
535
536    private static void mergePackageStats(IntervalStats dst, IntervalStats src,
537                                          final long deviceUsageTime) {
538        dst.endTime = Math.max(dst.endTime, src.endTime);
539
540        final int srcPackageCount = src.packageStats.size();
541        for (int i = 0; i < srcPackageCount; i++) {
542            final String packageName = src.packageStats.keyAt(i);
543            final UsageStats srcStats = src.packageStats.valueAt(i);
544            UsageStats dstStats = dst.packageStats.get(packageName);
545            if (dstStats == null) {
546                dstStats = new UsageStats(srcStats);
547                dst.packageStats.put(packageName, dstStats);
548            } else {
549                dstStats.add(src.packageStats.valueAt(i));
550            }
551
552            // App idle times can not begin in the future. This happens if we had a time change.
553            if (dstStats.mBeginIdleTime > deviceUsageTime) {
554                dstStats.mBeginIdleTime = deviceUsageTime;
555            }
556        }
557    }
558
559    /**
560     * App idle operates on a rolling window of time. When we roll over time, we end up with a
561     * period of time where in-memory stats are empty and we don't hit the disk for older stats
562     * for performance reasons. Suddenly all apps will become idle.
563     *
564     * Instead, at times we do a deep query to find all the apps that have run in the past few
565     * days and keep the cached data up to date.
566     *
567     * @param currentTimeMillis
568     */
569    void refreshAppIdleRollingWindow(final long currentTimeMillis, final long deviceUsageTime) {
570        // Start the rolling window for AppIdle requests.
571        List<IntervalStats> stats = mDatabase.queryUsageStats(UsageStatsManager.INTERVAL_DAILY,
572                currentTimeMillis - (1000 * 60 * 60 * 24 * 2), currentTimeMillis,
573                new StatCombiner<IntervalStats>() {
574                    @Override
575                    public void combine(IntervalStats stats, boolean mutable,
576                                        List<IntervalStats> accumulatedResult) {
577                        IntervalStats accum;
578                        if (accumulatedResult.isEmpty()) {
579                            accum = new IntervalStats();
580                            accum.beginTime = stats.beginTime;
581                            accumulatedResult.add(accum);
582                        } else {
583                            accum = accumulatedResult.get(0);
584                        }
585
586                        mergePackageStats(accum, stats, deviceUsageTime);
587                    }
588                });
589
590        if (stats == null || stats.isEmpty()) {
591            mAppIdleRollingWindow = new IntervalStats();
592            mergePackageStats(mAppIdleRollingWindow,
593                    mCurrentStats[UsageStatsManager.INTERVAL_YEARLY], deviceUsageTime);
594        } else {
595            mAppIdleRollingWindow = stats.get(0);
596        }
597    }
598
599    //
600    // -- DUMP related methods --
601    //
602
603    void checkin(final IndentingPrintWriter pw, final long screenOnTime) {
604        mDatabase.checkinDailyFiles(new UsageStatsDatabase.CheckinAction() {
605            @Override
606            public boolean checkin(IntervalStats stats) {
607                printIntervalStats(pw, stats, screenOnTime, false);
608                return true;
609            }
610        });
611    }
612
613    void dump(IndentingPrintWriter pw, final long screenOnTime) {
614        // This is not a check-in, only dump in-memory stats.
615        for (int interval = 0; interval < mCurrentStats.length; interval++) {
616            pw.print("In-memory ");
617            pw.print(intervalToString(interval));
618            pw.println(" stats");
619            printIntervalStats(pw, mCurrentStats[interval], screenOnTime, true);
620        }
621
622        pw.println("AppIdleRollingWindow cache");
623        printIntervalStats(pw, mAppIdleRollingWindow, screenOnTime, true);
624    }
625
626    private String formatDateTime(long dateTime, boolean pretty) {
627        if (pretty) {
628            return "\"" + DateUtils.formatDateTime(mContext, dateTime, sDateFormatFlags) + "\"";
629        }
630        return Long.toString(dateTime);
631    }
632
633    private String formatElapsedTime(long elapsedTime, boolean pretty) {
634        if (pretty) {
635            return "\"" + DateUtils.formatElapsedTime(elapsedTime / 1000) + "\"";
636        }
637        return Long.toString(elapsedTime);
638    }
639
640    void printIntervalStats(IndentingPrintWriter pw, IntervalStats stats, long screenOnTime,
641            boolean prettyDates) {
642        if (prettyDates) {
643            pw.printPair("timeRange", "\"" + DateUtils.formatDateRange(mContext,
644                    stats.beginTime, stats.endTime, sDateFormatFlags) + "\"");
645        } else {
646            pw.printPair("beginTime", stats.beginTime);
647            pw.printPair("endTime", stats.endTime);
648        }
649        pw.println();
650        pw.increaseIndent();
651        pw.println("packages");
652        pw.increaseIndent();
653        final ArrayMap<String, UsageStats> pkgStats = stats.packageStats;
654        final int pkgCount = pkgStats.size();
655        for (int i = 0; i < pkgCount; i++) {
656            final UsageStats usageStats = pkgStats.valueAt(i);
657            pw.printPair("package", usageStats.mPackageName);
658            pw.printPair("totalTime",
659                    formatElapsedTime(usageStats.mTotalTimeInForeground, prettyDates));
660            pw.printPair("lastTime", formatDateTime(usageStats.mLastTimeUsed, prettyDates));
661            pw.printPair("lastTimeSystem",
662                    formatDateTime(usageStats.mLastTimeSystemUsed, prettyDates));
663            pw.printPair("inactiveTime",
664                    formatElapsedTime(screenOnTime - usageStats.mBeginIdleTime, prettyDates));
665            pw.println();
666        }
667        pw.decreaseIndent();
668
669        pw.println("configurations");
670        pw.increaseIndent();
671        final ArrayMap<Configuration, ConfigurationStats> configStats = stats.configurations;
672        final int configCount = configStats.size();
673        for (int i = 0; i < configCount; i++) {
674            final ConfigurationStats config = configStats.valueAt(i);
675            pw.printPair("config", Configuration.resourceQualifierString(config.mConfiguration));
676            pw.printPair("totalTime", formatElapsedTime(config.mTotalTimeActive, prettyDates));
677            pw.printPair("lastTime", formatDateTime(config.mLastTimeActive, prettyDates));
678            pw.printPair("count", config.mActivationCount);
679            pw.println();
680        }
681        pw.decreaseIndent();
682
683        pw.println("events");
684        pw.increaseIndent();
685        final TimeSparseArray<UsageEvents.Event> events = stats.events;
686        final int eventCount = events != null ? events.size() : 0;
687        for (int i = 0; i < eventCount; i++) {
688            final UsageEvents.Event event = events.valueAt(i);
689            pw.printPair("time", formatDateTime(event.mTimeStamp, prettyDates));
690            pw.printPair("type", eventToString(event.mEventType));
691            pw.printPair("package", event.mPackage);
692            if (event.mClass != null) {
693                pw.printPair("class", event.mClass);
694            }
695            if (event.mConfiguration != null) {
696                pw.printPair("config", Configuration.resourceQualifierString(event.mConfiguration));
697            }
698            pw.println();
699        }
700        pw.decreaseIndent();
701        pw.decreaseIndent();
702    }
703
704    private static String intervalToString(int interval) {
705        switch (interval) {
706            case UsageStatsManager.INTERVAL_DAILY:
707                return "daily";
708            case UsageStatsManager.INTERVAL_WEEKLY:
709                return "weekly";
710            case UsageStatsManager.INTERVAL_MONTHLY:
711                return "monthly";
712            case UsageStatsManager.INTERVAL_YEARLY:
713                return "yearly";
714            default:
715                return "?";
716        }
717    }
718
719    private static String eventToString(int eventType) {
720        switch (eventType) {
721            case UsageEvents.Event.NONE:
722                return "NONE";
723            case UsageEvents.Event.MOVE_TO_BACKGROUND:
724                return "MOVE_TO_BACKGROUND";
725            case UsageEvents.Event.MOVE_TO_FOREGROUND:
726                return "MOVE_TO_FOREGROUND";
727            case UsageEvents.Event.END_OF_DAY:
728                return "END_OF_DAY";
729            case UsageEvents.Event.CONTINUE_PREVIOUS_DAY:
730                return "CONTINUE_PREVIOUS_DAY";
731            case UsageEvents.Event.CONFIGURATION_CHANGE:
732                return "CONFIGURATION_CHANGE";
733            case UsageEvents.Event.SYSTEM_INTERACTION:
734                return "SYSTEM_INTERACTION";
735            case UsageEvents.Event.USER_INTERACTION:
736                return "USER_INTERACTION";
737            default:
738                return "UNKNOWN";
739        }
740    }
741}
742