metrics.h revision 39910dcd1d68987ccee7c3031dc269233a8490bb
133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Copyright (C) 2014 The Android Open Source Project 333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Licensed under the Apache License, Version 2.0 (the "License"); 533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// you may not use this file except in compliance with the License. 633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// You may obtain a copy of the License at 733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// http://www.apache.org/licenses/LICENSE-2.0 933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 1033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Unless required by applicable law or agreed to in writing, software 1133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// distributed under the License is distributed on an "AS IS" BASIS, 1233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// See the License for the specific language governing permissions and 1433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// limitations under the License. 1533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 1633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 1733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen#ifndef UPDATE_ENGINE_METRICS_H_ 1833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen#define UPDATE_ENGINE_METRICS_H_ 1933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 2033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen#include <base/time/time.h> 2133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 2233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen#include "update_engine/common/constants.h" 2333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen#include "update_engine/common/error_code.h" 2433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 2533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthennamespace chromeos_update_engine { 2633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 2733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenclass SystemState; 2833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 2933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthennamespace metrics { 3033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 3133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// UpdateEngine.Daily.* metrics. 3233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricDailyOSAgeDays[]; 3333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 3433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// UpdateEngine.Check.* metrics. 3533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricCheckDownloadErrorCode[]; 3633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricCheckReaction[]; 3733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricCheckResult[]; 3833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricCheckTimeSinceLastCheckMinutes[]; 3933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricCheckTimeSinceLastCheckUptimeMinutes[]; 4033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 4133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// UpdateEngine.Attempt.* metrics. 4233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptNumber[]; 4333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptPayloadType[]; 4433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptPayloadSizeMiB[]; 4533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptConnectionType[]; 4633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptDurationMinutes[]; 4733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptDurationUptimeMinutes[]; 4833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptTimeSinceLastAttemptSeconds[]; 4933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptTimeSinceLastAttemptUptimeSeconds[]; 5033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptPayloadBytesDownloaded[]; 5133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptPayloadDownloadSpeedKBps[]; 5233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptDownloadSource[]; 5333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptResult[]; 5433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptInternalErrorCode[]; 5533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricAttemptDownloadErrorCode[]; 5633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 5733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// UpdateEngine.SuccessfulUpdate.* metrics. 5833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateAttemptCount[]; 5933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateBytesDownloadedMiB[]; 6033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateDownloadOverheadPercentage[]; 6133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateDownloadSourcesUsed[]; 6233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdatePayloadType[]; 6333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdatePayloadSizeMiB[]; 6433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateTotalDurationMinutes[]; 6533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateRebootCount[]; 6633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateUpdatesAbandonedCount[]; 6733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricSuccessfulUpdateUrlSwitchCount[]; 6833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 6933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// UpdateEngine.Rollback.* metric. 7033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricRollbackResult[]; 7133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 7233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// UpdateEngine.* metrics. 7333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricFailedUpdateCount[]; 7433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricInstallDateProvisioningSource[]; 7533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenextern const char kMetricTimeToRebootMinutes[]; 7633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 7733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The possible outcomes when checking for updates. 7833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 7933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// This is used in the UpdateEngine.Check.Result histogram. 8033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenenum class CheckResult { 8133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUpdateAvailable, // Response indicates an update is available. 8233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kNoUpdateAvailable, // Response indicates no updates are available. 8333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kDownloadError, // Error downloading response from Omaha. 8433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kParsingError, // Error parsing response. 8533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kRebootPending, // No update check was performed a reboot is pending. 8633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 8733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kNumConstants, 8833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUnset = -1 8933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen}; 9033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 9133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Possible ways a device can react to a new update being available. 9233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 9333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// This is used in the UpdateEngine.Check.Reaction histogram. 9433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenenum class CheckReaction { 9533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUpdating, // Device proceeds to download and apply update. 9633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kIgnored , // Device-policy dictates ignoring the update. 9733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kDeferring, // Device-policy dictates waiting. 9833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kBackingOff, // Previous errors dictates waiting. 9933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 10033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kNumConstants, 10133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUnset = -1 10233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen}; 10333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 10433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The possible ways that downloading from a HTTP or HTTPS server can fail. 10533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 10633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// This is used in the UpdateEngine.Check.DownloadErrorCode and 10733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// UpdateEngine.Attempt.DownloadErrorCode histograms. 10833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenenum class DownloadErrorCode { 10933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // Errors that can happen in the field. See http://crbug.com/355745 11033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // for how we plan to add more detail in the future. 11133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kDownloadError = 0, // Error downloading data from server. 11233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 11333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // IMPORTANT: When adding a new error code, add at the bottom of the 11433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // above block and before the kInputMalformed field. This 11533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // is to ensure that error codes are not reordered. 11633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 11733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // This error code is used to convey that malformed input was given 11833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // to the utils::GetDownloadErrorCode() function. This should never 11933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // happen but if it does it's because of an internal update_engine 12033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // error and we're interested in knowing this. 12133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kInputMalformed = 100, 12233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 12333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // Bucket for capturing HTTP status codes not in the 200-599 12433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // range. This should never happen in practice but if it does we 12533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // want to know. 12633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kHttpStatusOther = 101, 12733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 12833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen // Above 200 and below 600, the value is the HTTP status code. 12933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kHttpStatus200 = 200, 13033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 13133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kNumConstants = 600, 13233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 13333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUnset = -1 13433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen}; 13533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 13633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Possible ways an update attempt can end. 13733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 13833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// This is used in the UpdateEngine.Attempt.Result histogram. 13933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenenum class AttemptResult { 14033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUpdateSucceeded, // The update succeeded. 14133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kInternalError, // An internal error occurred. 14233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kPayloadDownloadError, // Failure while downloading payload. 14333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kMetadataMalformed, // Metadata was malformed. 14433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kOperationMalformed, // An operation was malformed. 14533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kOperationExecutionError, // An operation failed to execute. 14633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kMetadataVerificationFailed, // Metadata verification failed. 14733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kPayloadVerificationFailed, // Payload verification failed. 14833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kVerificationFailed, // Root or Kernel partition verification failed. 14933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kPostInstallFailed, // The postinstall step failed. 15033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kAbnormalTermination, // The attempt ended abnormally. 15133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 15233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kNumConstants, 15333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 15433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUnset = -1 15533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen}; 15633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 15733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Possible ways the device is connected to the Internet. 15833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 15933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// This is used in the UpdateEngine.Attempt.ConnectionType histogram. 16033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenenum class ConnectionType { 16133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUnknown, // Unknown. 16233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kEthernet, // Ethernet. 16333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kWifi, // Wireless. 16433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kWimax, // WiMax. 16533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kBluetooth, // Bluetooth. 16633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kCellular, // Cellular. 16733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kTetheredEthernet, // Tethered (Ethernet). 16833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kTetheredWifi, // Tethered (Wifi). 16933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 17033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kNumConstants, 17133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kUnset = -1 17233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen}; 17333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 17433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Possible ways a rollback can end. 17533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 17633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// This is used in the UpdateEngine.Rollback histogram. 17733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenenum class RollbackResult { 17833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kFailed, 17933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kSuccess, 18033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 18133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen kNumConstants 18233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen}; 18333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 18433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Helper function to report metrics related to rollback. The 18533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// following metrics are reported: 18633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 18733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricRollbackResult| 18833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenvoid ReportRollbackMetrics(SystemState *system_state, 18933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen RollbackResult result); 19033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 19133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Helper function to report metrics reported once a day. The 19233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// following metrics are reported: 19333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 19433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricDailyOSAgeDays| 19533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenvoid ReportDailyMetrics(SystemState *system_state, 19633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen base::TimeDelta os_age); 19733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 19833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Helper function to report metrics after completing an update check 19933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// with the ChromeOS update server ("Omaha"). The following metrics 20033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// are reported: 20133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 20233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricCheckResult| 20333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricCheckReaction| 20433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricCheckDownloadErrorCode| 20533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricCheckTimeSinceLastCheckMinutes| 20633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricCheckTimeSinceLastCheckUptimeMinutes| 20733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 20833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The |kMetricCheckResult| metric will only be reported if |result| 20933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// is not |kUnset|. 21033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 21133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The |kMetricCheckReaction| metric will only be reported if 21233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |reaction| is not |kUnset|. 21333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 21433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The |kMetricCheckDownloadErrorCode| will only be reported if 21533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |download_error_code| is not |kUnset|. 21633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 21733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The values for the |kMetricCheckTimeSinceLastCheckMinutes| and 21833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricCheckTimeSinceLastCheckUptimeMinutes| metrics are 21933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// automatically reported and calculated by maintaining persistent 22033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// and process-local state variables. 22133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenvoid ReportUpdateCheckMetrics(SystemState *system_state, 22233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen CheckResult result, 22333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen CheckReaction reaction, 22433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen DownloadErrorCode download_error_code); 22533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 22633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen 22733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// Helper function to report metrics after the completion of each 22833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// update attempt. The following metrics are reported: 22933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 23033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptNumber| 23133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptPayloadType| 23233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptPayloadSizeMiB| 23333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptDurationSeconds| 23433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptDurationUptimeSeconds| 23533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptTimeSinceLastAttemptMinutes| 23633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptTimeSinceLastAttemptUptimeMinutes| 23733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptPayloadBytesDownloadedMiB| 23833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptPayloadDownloadSpeedKBps| 23933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptDownloadSource| 24033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptResult| 24133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptInternalErrorCode| 24233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptDownloadErrorCode| 24333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 24433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The |kMetricAttemptInternalErrorCode| metric will only be reported 24533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// if |internal_error_code| is not |kErrorSuccess|. 24633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 24733bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The |kMetricAttemptDownloadErrorCode| metric will only be 24833bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// reported if |payload_download_error_code| is not |kUnset|. 24933bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// 25033bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// The values for the |kMetricAttemptTimeSinceLastAttemptMinutes| and 25133bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// |kMetricAttemptTimeSinceLastAttemptUptimeMinutes| metrics are 25233bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// automatically calculated and reported by maintaining persistent and 25333bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen// process-local state variables. 25433bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthenvoid ReportUpdateAttemptMetrics( 25533bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen SystemState *system_state, 25633bae491eded4ef4f1eb4f4ef0f01ef0e5463f3aDavid Zeuthen int attempt_number, 257 PayloadType payload_type, 258 base::TimeDelta duration, 259 base::TimeDelta duration_uptime, 260 int64_t payload_size, 261 int64_t payload_bytes_downloaded, 262 int64_t payload_download_speed_bps, 263 DownloadSource download_source, 264 AttemptResult attempt_result, 265 ErrorCode internal_error_code, 266 DownloadErrorCode payload_download_error_code, 267 ConnectionType connection_type); 268 269// Reports the |kAbnormalTermination| for the |kMetricAttemptResult| 270// metric. No other metrics in the UpdateEngine.Attempt.* namespace 271// will be reported. 272void ReportAbnormallyTerminatedUpdateAttemptMetrics(SystemState *system_state); 273 274// Helper function to report the after the completion of a successful 275// update attempt. The following metrics are reported: 276// 277// |kMetricSuccessfulUpdateAttemptCount| 278// |kMetricSuccessfulUpdateUpdatesAbandonedCount| 279// |kMetricSuccessfulUpdatePayloadType| 280// |kMetricSuccessfulUpdatePayloadSizeMiB| 281// |kMetricSuccessfulUpdateBytesDownloadedMiBHttpsServer| 282// |kMetricSuccessfulUpdateBytesDownloadedMiBHttpServer| 283// |kMetricSuccessfulUpdateBytesDownloadedMiBHttpPeer| 284// |kMetricSuccessfulUpdateBytesDownloadedMiB| 285// |kMetricSuccessfulUpdateDownloadSourcesUsed| 286// |kMetricSuccessfulUpdateDownloadOverheadPercentage| 287// |kMetricSuccessfulUpdateTotalDurationMinutes| 288// |kMetricSuccessfulUpdateRebootCount| 289// |kMetricSuccessfulUpdateUrlSwitchCount| 290// 291// The values for the |kMetricSuccessfulUpdateDownloadSourcesUsed| are 292// |kMetricSuccessfulUpdateBytesDownloadedMiB| metrics automatically 293// calculated from examining the |num_bytes_downloaded| array. 294void ReportSuccessfulUpdateMetrics( 295 SystemState *system_state, 296 int attempt_count, 297 int updates_abandoned_count, 298 PayloadType payload_type, 299 int64_t payload_size, 300 int64_t num_bytes_downloaded[kNumDownloadSources], 301 int download_overhead_percentage, 302 base::TimeDelta total_duration, 303 int reboot_count, 304 int url_switch_count); 305 306} // namespace metrics 307 308} // namespace chromeos_update_engine 309 310#endif // UPDATE_ENGINE_METRICS_H_ 311