summaryrefslogtreecommitdiffstats
path: root/mobile/android/geckoview/src/main/java/org/mozilla/gecko/TelemetryUtils.java
blob: 3c9c1f90a0ed447fd3a4f2761aaca5b6bd863b8b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
/* -*- Mode: Java; c-basic-offset: 4; tab-width: 20; indent-tabs-mode: nil; -*-
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/. */

package org.mozilla.gecko;

import android.os.SystemClock;
import android.util.Log;
import org.mozilla.gecko.annotation.WrapForJNI;

/**
 * All telemetry times are relative to one of two clocks:
 *
 * <p>* Real time since the device was booted, including deep sleep. Use this as a substitute for
 * wall clock. * Uptime since the device was booted, excluding deep sleep. Use this to avoid timing
 * a user activity when their phone is in their pocket!
 *
 * <p>The majority of methods in this class are defined in terms of real time.
 */
public class TelemetryUtils {
  private static final String LOGTAG = "TelemetryUtils";

  @WrapForJNI(stubName = "AddHistogram", dispatchTo = "gecko")
  private static native void nativeAddHistogram(String name, int value);

  public static long uptime() {
    return SystemClock.uptimeMillis();
  }

  public static long realtime() {
    return SystemClock.elapsedRealtime();
  }

  // Define new histograms in:
  // toolkit/components/telemetry/Histograms.json
  public static void addToHistogram(final String name, final int value) {
    if (GeckoThread.isRunning()) {
      nativeAddHistogram(name, value);
    } else {
      GeckoThread.queueNativeCall(
          TelemetryUtils.class, "nativeAddHistogram", String.class, name, value);
    }
  }

  public abstract static class Timer {
    private final long mStartTime;
    private final String mName;

    private volatile boolean mHasFinished;
    private volatile long mElapsed = -1;

    protected abstract long now();

    public Timer(final String name) {
      mName = name;
      mStartTime = now();
    }

    public void cancel() {
      mHasFinished = true;
    }

    public long getElapsed() {
      return mElapsed;
    }

    public void stop() {
      // Only the first stop counts.
      if (mHasFinished) {
        return;
      }

      mHasFinished = true;

      final long elapsed = now() - mStartTime;
      if (elapsed < 0) {
        Log.e(LOGTAG, "Current time less than start time -- clock shenanigans?");
        return;
      }

      mElapsed = elapsed;
      if (elapsed > Integer.MAX_VALUE) {
        Log.e(LOGTAG, "Duration of " + elapsed + "ms is too great to add to histogram.");
        return;
      }

      addToHistogram(mName, (int) (elapsed));
    }
  }

  public static class UptimeTimer extends Timer {
    public UptimeTimer(final String name) {
      super(name);
    }

    @Override
    protected long now() {
      return TelemetryUtils.uptime();
    }
  }
}