summaryrefslogtreecommitdiff
path: root/java/com/google/android/libraries/mobiledatadownload/internal/logging/EventLogger.java
diff options
context:
space:
mode:
Diffstat (limited to 'java/com/google/android/libraries/mobiledatadownload/internal/logging/EventLogger.java')
-rw-r--r--java/com/google/android/libraries/mobiledatadownload/internal/logging/EventLogger.java205
1 files changed, 107 insertions, 98 deletions
diff --git a/java/com/google/android/libraries/mobiledatadownload/internal/logging/EventLogger.java b/java/com/google/android/libraries/mobiledatadownload/internal/logging/EventLogger.java
index 83e8311..03d42d3 100644
--- a/java/com/google/android/libraries/mobiledatadownload/internal/logging/EventLogger.java
+++ b/java/com/google/android/libraries/mobiledatadownload/internal/logging/EventLogger.java
@@ -21,110 +21,119 @@ import com.google.common.util.concurrent.ListenableFuture;
import com.google.mobiledatadownload.LogEnumsProto.MddClientEvent;
import com.google.mobiledatadownload.LogEnumsProto.MddDownloadResult;
import com.google.mobiledatadownload.LogProto.DataDownloadFileGroupStats;
+import com.google.mobiledatadownload.LogProto.MddDownloadLatency;
import com.google.mobiledatadownload.LogProto.MddFileGroupStatus;
+import com.google.mobiledatadownload.LogProto.MddLibApiResultLog;
+import com.google.mobiledatadownload.LogProto.MddNetworkStats;
import com.google.mobiledatadownload.LogProto.MddStorageStats;
+
import java.util.List;
/** Interface for remote logging. */
public interface EventLogger {
- /** Log an mdd event */
- void logEventSampled(MddClientEvent.Code eventCode);
-
- /** Log an mdd event with an associated file group. */
- void logEventSampled(
- MddClientEvent.Code eventCode,
- String fileGroupName,
- int fileGroupVersionNumber,
- long buildId,
- String variantId);
-
- /**
- * Log an mdd event. This not sampled. Caller should make sure this method is called after
- * sampling at the passed in value of sample interval.
- */
- void logEventAfterSample(MddClientEvent.Code eventCode, int sampleInterval);
-
- /**
- * Log mdd file group stats. The buildFileGroupStats callable is only called if the event is going
- * to be logged.
- *
- * @param buildFileGroupStats callable which builds a List of FileGroupStatusWithDetails. Each
- * file group status will be logged individually.
- * @return a future that completes when the logging work is done. The future will complete with a
- * failure if the callable fails or if there is an error when logging.
- */
- ListenableFuture<Void> logMddFileGroupStats(
- AsyncCallable<List<FileGroupStatusWithDetails>> buildFileGroupStats);
-
- /** Simple wrapper class for MDD file group stats and details. */
- @AutoValue
- abstract class FileGroupStatusWithDetails {
- abstract MddFileGroupStatus fileGroupStatus();
-
- abstract DataDownloadFileGroupStats fileGroupDetails();
-
- static FileGroupStatusWithDetails create(
- MddFileGroupStatus fileGroupStatus, DataDownloadFileGroupStats fileGroupDetails) {
- return new AutoValue_EventLogger_FileGroupStatusWithDetails(
- fileGroupStatus, fileGroupDetails);
+ /** Log an mdd event */
+ void logEventSampled(MddClientEvent.Code eventCode);
+
+ /** Log an mdd event with an associated file group. */
+ void logEventSampled(
+ MddClientEvent.Code eventCode,
+ String fileGroupName,
+ int fileGroupVersionNumber,
+ long buildId,
+ String variantId);
+
+ /**
+ * Log an mdd event. This not sampled. Caller should make sure this method is called after
+ * sampling at the passed in value of sample interval.
+ */
+ void logEventAfterSample(MddClientEvent.Code eventCode, int sampleInterval);
+
+ /**
+ * Log mdd file group stats. The buildFileGroupStats callable is only called if the event is
+ * going
+ * to be logged.
+ *
+ * @param buildFileGroupStats callable which builds a List of FileGroupStatusWithDetails. Each
+ * file group status will be logged individually.
+ * @return a future that completes when the logging work is done. The future will complete
+ * with a
+ * failure if the callable fails or if there is an error when logging.
+ */
+ ListenableFuture<Void> logMddFileGroupStats(
+ AsyncCallable<List<FileGroupStatusWithDetails>> buildFileGroupStats);
+
+ /** Simple wrapper class for MDD file group stats and details. */
+ @AutoValue
+ abstract class FileGroupStatusWithDetails {
+ abstract MddFileGroupStatus fileGroupStatus();
+
+ abstract DataDownloadFileGroupStats fileGroupDetails();
+
+ static FileGroupStatusWithDetails create(
+ MddFileGroupStatus fileGroupStatus, DataDownloadFileGroupStats fileGroupDetails) {
+ return new AutoValue_EventLogger_FileGroupStatusWithDetails(
+ fileGroupStatus, fileGroupDetails);
+ }
}
- }
-
- /** Log mdd api call stats. */
- void logMddApiCallStats(DataDownloadFileGroupStats fileGroupDetails, Void apiCallStats);
-
- void logMddLibApiResultLog(Void mddLibApiResultLog);
-
- /**
- * Log mdd storage stats. The buildMddStorageStats callable is only called if the event is going
- * to be logged.
- *
- * @param buildMddStorageStats callable which builds the MddStorageStats to log.
- * @return a future that completes when the logging work is done. The future will complete with a
- * failure if the callable fails or if there is an error when logging.
- */
- ListenableFuture<Void> logMddStorageStats(AsyncCallable<MddStorageStats> buildMddStorageStats);
-
- /**
- * Log mdd network stats. The buildMddNetworkStats callable is only called if the event is going
- * to be logged.
- *
- * @param buildMddNetworkStats callable which builds the Void to log.
- * @return a future that completes when the logging work is done. The future will complete with a
- * failure if the callable fails or if there is an error when logging.
- */
- ListenableFuture<Void> logMddNetworkStats(AsyncCallable<Void> buildMddNetworkStats);
-
- /** Log the number of unaccounted files/metadata deleted during maintenance */
- void logMddDataDownloadFileExpirationEvent(int eventCode, int count);
-
- /** Log the network savings of MDD download features */
- void logMddNetworkSavings(
- DataDownloadFileGroupStats fileGroupDetails,
- int code,
- long fullFileSize,
- long downloadedFileSize,
- String fileId,
- int deltaIndex);
-
- /** Log mdd download result events. */
- void logMddDownloadResult(
- MddDownloadResult.Code code, DataDownloadFileGroupStats fileGroupDetails);
-
- /** Log stats of mdd {@code getFileGroup} and {@code getFileGroupByFilter} calls. */
- void logMddQueryStats(DataDownloadFileGroupStats fileGroupDetails);
-
- /** Log mdd stats on android sharing events. */
- void logMddAndroidSharingLog(Void event);
-
- /** Log mdd download latency. */
- void logMddDownloadLatency(DataDownloadFileGroupStats fileGroupStats, Void downloadLatency);
-
- /** Log mdd usage event. */
- void logMddUsageEvent(DataDownloadFileGroupStats fileGroupDetails, Void usageEventLog);
-
- /** Log new config received event. */
- void logNewConfigReceived(
- DataDownloadFileGroupStats fileGroupDetails, Void newConfigReceivedInfo);
+
+ /** Log mdd api call stats. */
+ void logMddApiCallStats(DataDownloadFileGroupStats fileGroupDetails, Void apiCallStats);
+
+ void logMddLibApiResultLog(MddLibApiResultLog mddLibApiResultLog);
+
+ /**
+ * Log mdd storage stats. The buildMddStorageStats callable is only called if the event is going
+ * to be logged.
+ *
+ * @param buildMddStorageStats callable which builds the MddStorageStats to log.
+ * @return a future that completes when the logging work is done. The future will complete
+ * with a
+ * failure if the callable fails or if there is an error when logging.
+ */
+ ListenableFuture<Void> logMddStorageStats(AsyncCallable<MddStorageStats> buildMddStorageStats);
+
+ /**
+ * Log mdd network stats. The buildMddNetworkStats callable is only called if the event is going
+ * to be logged.
+ *
+ * @param buildMddNetworkStats callable which builds the MddNetworkStats to log.
+ * @return a future that completes when the logging work is done. The future will complete
+ * with a
+ * failure if the callable fails or if there is an error when logging.
+ */
+ ListenableFuture<Void> logMddNetworkStats(AsyncCallable<MddNetworkStats> buildMddNetworkStats);
+
+ /** Log the number of unaccounted files/metadata deleted during maintenance */
+ void logMddDataDownloadFileExpirationEvent(int eventCode, int count);
+
+ /** Log the network savings of MDD download features */
+ void logMddNetworkSavings(
+ DataDownloadFileGroupStats fileGroupDetails,
+ int code,
+ long fullFileSize,
+ long downloadedFileSize,
+ String fileId,
+ int deltaIndex);
+
+ /** Log mdd download result events. */
+ void logMddDownloadResult(
+ MddDownloadResult.Code code, DataDownloadFileGroupStats fileGroupDetails);
+
+ /** Log stats of mdd {@code getFileGroup} and {@code getFileGroupByFilter} calls. */
+ void logMddQueryStats(DataDownloadFileGroupStats fileGroupDetails);
+
+ /** Log mdd stats on android sharing events. */
+ void logMddAndroidSharingLog(Void event);
+
+ /** Log mdd download latency. */
+ void logMddDownloadLatency(
+ DataDownloadFileGroupStats fileGroupStats, MddDownloadLatency downloadLatency);
+
+ /** Log mdd usage event. */
+ void logMddUsageEvent(DataDownloadFileGroupStats fileGroupDetails, Void usageEventLog);
+
+ /** Log new config received event. */
+ void logNewConfigReceived(
+ DataDownloadFileGroupStats fileGroupDetails, Void newConfigReceivedInfo);
}