Existing Instrumentation

We expect our PhoneLab platform to include an increasing amount of instrumentation added both by PhoneLab developers and by external research teams. If our build already contains instrumentation recording what you’re interested in, you can proceed directly to requesting data.

Logging Branches

Instrumentations are stagged in their respective branches by category, such as network, location, or power. Here is a list of current logging branches:

  1. logging/android-5.1.1_r3/1/network
  2. logging/android-5.1.1_r3/2/power
  3. logging/android-5.1.1_r3/3/location
  4. logging/android-5.1.1_r3/4/packagemanager

Add Your Instrumentation

To add instrumentations to these branch, for example, logging/android-5.1.1_r3/1/network, please follow these steps:

First, if you have not cloned the repository yet:

$ cd <WORKING_DIRECTORY>
$ repo init -u ssh://<USERNAME>@platform.phone-lab.org:8080/platform/manifest -b logging/android-5.1.1_r3/1/network
$ repo sync

The <USERNAME> is your user name on our Gerrit server.

Next, figure out the repository which you want to add instrumentation, say frameworks/base, create a working branch:

$ cd frameworks/base
$ git checkout -b my_instrumentation

Then you add the instrumentation, commit and upload your changes for review:

$ git commit -a -S
$ git push aosp refs/for/logging/android-5.1.1_r3/1/network

Note

Note the remote branch name when you push: it is a special Gerrit pseudo branch for changes to be reviewed.

Here is a list of existing instrumentations on our platform.

Summary

PhoneLab’s instrumented Android platform currently contains:

  • 11 tags, 20 actions,
  • ... in 9 categories,
  • ... added by 2 institutions.

Catetory: Activity

Tag: Activity-LifeCycle-QoE

  1. Action: onStart, onPause, onResume
    Project: frameworks/base
    File: core/java/android/app/Activity.java:1146
    Description: Activity lifecycle events

Catetory: Location

Tag: Location-Misc-PhoneLab

  1. Action: android.location.LOCATION_CHANGED
    Project: frameworks/base
    File: services/core/java/com/android/server/LocationManagerService.java:2252
    Description: Location update.

Catetory: Network

Tag: Network-Telephony-PhoneLab

  1. Action: android.intent.action.ANY_DATA_STATE
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1592
    Description: Cellular data connectivity changed.
  2. Action: android.intent.action.DATA_CONNECTION_FAILED
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1649
    Description: Cellular data connection failed.
  3. Action: android.intent.action.PHONE_STATE
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1547
    Description: Phone calling state changed (incoming call).
  4. Action: android.intent.action.SERVICE_STATE
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1466
    Description: Cellular service state changed.
  5. Action: android.intent.action.SIG_STR
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1501
    Description: Cellular signal strength changed.
  6. Action: android.telephony.CALL_FORWARDING_CHANGED
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1027
    Description: Call forwarding status changed.
  7. Action: android.telephony.CELL_LOCATION_CHANGED
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1257
    Description: Cell tower location changed.
  8. Action: android.telephony.DATA_ACTIVITY_CHANGED
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:1070
    Description: Cellular data activity.
  9. Action: android.telephony.MESSAGE_WAITING_CHANGED
    Project: frameworks/base
    File: services/core/java/com/android/server/TelephonyRegistry.java:979
    Description: Message waiting status changed.

Catetory: PackageManager

Tag: PackageManager-Misc-PhoneLab

  1. Action: android.intent.action.PACKAGE_{ADDED, CHANGED, REMOVED}
    Project: frameworks/base
    File: services/core/java/com/android/server/pm/PackageManagerService.java:10154
    Description: Package installed/uninstalled/updated.

Catetory: Power

Tag: Power-Battery-PhoneLab

  1. Action: android.intent.action.BATTERY_CHANGED
    Project: frameworks/base
    File: services/core/java/com/android/server/BatteryService.java:661
    Description: Battery status changed.

Tag: Power-Screen-PhoneLab

  1. Action: android.intent.action.SCREEN_OFF
    Project: frameworks/base
    File: services/core/java/com/android/server/power/Notifier.java:634
    Description: Screen turned off.
  2. Action: android.intent.action.SCREEN_ON
    Project: frameworks/base
    File: services/core/java/com/android/server/power/Notifier.java:596
    Description: Screen turned on.

Catetory: Spinner

Tag: Spinner-State-QoE

  1. Action: ProgressBarEvent
    Project: frameworks/base
    File: core/java/android/widget/ProgressBar.java:1505
    Description: Start and end of indeterminate progressbars

Catetory: Usage

Tag: KeyEvent-UserAction-QoE

  1. Action: HardwareTouchEvent
    Project: frameworks/base
    File: core/java/android/view/KeyEvent.java:1594
    Description: User pressed a key

Catetory: View

Tag: View-UserAction-QoE

  1. Action: TouchEvent
    Project: frameworks/base
    File: core/java/android/view/View.java:10294
    Description: User touched item

Catetory: WebView

Tag: WebView-Update-QoE

  1. Action: WebViewUpdateEvent
    Project: frameworks/base
    File: core/java/android/webkit/WebViewClient.java:38
    Description: Webview loading progress
  2. Action: WebViewUpdateEvent
    Project: frameworks/base
    File: core/java/android/webkit/WebChromeClient.java:39
    Description: Webview loading progress

Tag: WebView-UserActino-QoE

  1. Action: WebViewTouchEvent
    Project: frameworks/base
    File: core/java/android/webkit/WebView.java:304
    Description: User touched item in webview

Last updated 2016-12-02