# Print output for @column tags ?> StatsLog - Android SDK | Android Developers

Most visited

Recently visited

StatsLog

public final class StatsLog
extends Object

java.lang.Object
   ↳ android.util.StatsLog


StatsLog provides an API for developers to send events to statsd. The events can be used to define custom metrics inside statsd.

Summary

Public methods

static boolean logBinaryPushStateChanged(String trainName, long trainVersionCode, int options, int state, long[] experimentIds)

Logs an event for binary push for module updates.

static boolean logEvent(int label)

Logs an event that does not represent a start or stop boundary.

static boolean logStart(int label)

Logs a start event.

static boolean logStop(int label)

Logs a stop event.

Inherited methods

Public methods

logBinaryPushStateChanged

public static boolean logBinaryPushStateChanged (String trainName, 
                long trainVersionCode, 
                int options, 
                int state, 
                long[] experimentIds)

Logs an event for binary push for module updates.
Requires Manifest.permission.DUMP and Manifest.permission.PACKAGE_USAGE_STATS

Parameters
trainName String: name of install train. This value cannot be null.

trainVersionCode long: version code of the train.

options int: optional flags about this install. The last 3 bits indicate options: 0x01: FLAG_REQUIRE_STAGING 0x02: FLAG_ROLLBACK_ENABLED 0x04: FLAG_REQUIRE_LOW_LATENCY_MONITOR

state int: current install state. Defined as State enums in BinaryPushStateChanged atom in frameworks/base/cmds/statsd/src/atoms.proto

experimentIds long: experiment ids. This value cannot be null.

Returns
boolean True if the log request was sent to statsd.

logEvent

public static boolean logEvent (int label)

Logs an event that does not represent a start or stop boundary.

Parameters
label int: developer-chosen label.

Returns
boolean True if the log request was sent to statsd.

logStart

public static boolean logStart (int label)

Logs a start event.

Parameters
label int: developer-chosen label.

Returns
boolean True if the log request was sent to statsd.

logStop

public static boolean logStop (int label)

Logs a stop event.

Parameters
label int: developer-chosen label.

Returns
boolean True if the log request was sent to statsd.