Daily Aggregate

A daily aggregate contains Web API log totals for a product on a specific date.

A daily aggregate contains Web API log totals for a product on a specific date.

Usage analytics are updated asynchronously, so very recent activity may not appear immediately. Daily aggregates exclude license keys that are configured to be excluded from usage analytics totals, active-key counts, active-device counts, and active-customer counts. See the KPI dashboard guide for details about excluding test licenses.

ActiveKeys and ActiveDevices are snapshot-style counts for keys and machine codes whose first and last aggregate timestamps overlap the day. ActiveCustomers counts distinct customers attached to those active keys.

Counters with names such as ActivationSuccess are based on Web API log state codes. The first two digits identify the method group, and the third digit identifies success (1) or failure (2). For example, ActivationSuccess counts activation states 2010-2019, while ActivationFailed counts activation states 2020-2029. Exact outcome counters map to the specific state codes listed below. See Web API Log state codes for the general format.

Structure

Parameter	Description	Remarks
Id	A unique identifier of this aggregate.	An integer
ProductId	The id of the product.	An integer
Date	The date that this aggregate describes.	yyyy-MM-dd
TotalRequestsLogged	The total number of requests logged for this product and day.	An integer
Successful	The number of successful requests.	An integer
Failed	The number of failed requests.	An integer
ActiveDevices	The number of active devices observed for the day.	An integer
ActiveKeys	The number of active license keys observed for the day.	An integer
ActiveCustomers	The number of active customers observed for the day.	An integer
ActivationSuccess, ActivationFailed	Activation request counts grouped by success and failure.	Integers
KeyGenSuccess, KeyGenFailed	Key generation request counts grouped by success and failure.	Integers
DeactivationSuccess, DeactivationFailed	Deactivation request counts grouped by success and failure.	Integers
LicenseOpsSuccess, LicenseOpsFailed	Other license operation counts grouped by success and failure.	Integers
DataObjectSuccess, DataObjectFailed	Data object operation counts grouped by success and failure.	Integers
TrialKeyGenerated, TrialKeyReused, TrialKeyCreateError	Specific trial key generation counts.	Integers
ActivationAlreadyActivated, ActivationNewMachine, ActivationTrial, ActivationFloating, ActivationOverdraftFloating	Specific activation outcome counts.	Integers
ActivationDeviceLimitNode, ActivationDeviceLimitFloat	Activation failures caused by device limits.	Integers
DeactivationNormal, DeactivationFloatingRelease	Specific deactivation outcome counts.	Integers
AddFeature, RemoveFeature, BlockKey, UnblockKey, ExtendLicense, SetMachineLockLimit, ChangeNotes, TrialActivationSuccess, ChangeCustomer	Specific license operation counts.	Integers
DataObjectAdd, DataObjectRemove, DataObjectList, DataObjectIncrementInt, DataObjectDecrementInt, DataObjectSetInt, DataObjectSetString	Specific data object operation counts.	Integers

State code mapping

Counter	State codes counted
Successful, Failed	Any state with third digit 1; any state with third digit 2.
ActivationSuccess, ActivationFailed	2010-2019; 2020-2029.
KeyGenSuccess, KeyGenFailed	3010-3019; 3020-3029.
DeactivationSuccess, DeactivationFailed	6010-6019; 6020-6029.
LicenseOpsSuccess, LicenseOpsFailed	7010-7019; 7020-7029.
DataObjectSuccess, DataObjectFailed	8010-8019; 8020-8029.
TrialKeyGenerated, TrialKeyReused, TrialKeyCreateError	3011; 3012; 3021.
ActivationAlreadyActivated, ActivationNewMachine, ActivationTrial, ActivationFloating, ActivationOverdraftFloating	2011; 2012; 2013; 2014; 2015.
ActivationDeviceLimitNode, ActivationDeviceLimitFloat	2022; 2024.
DeactivationNormal, DeactivationFloatingRelease	6010; 6011.
AddFeature, RemoveFeature, BlockKey, UnblockKey, ExtendLicense, SetMachineLockLimit, ChangeNotes, TrialActivationSuccess, ChangeCustomer	7011; 7012; 7013; 7014; 7015; 7016; 7017; 7018; 7019.
DataObjectAdd, DataObjectRemove, DataObjectList, DataObjectIncrementInt, DataObjectDecrementInt, DataObjectSetInt, DataObjectSetString	8011; 8012; 8013; 8014; 8015; 8016; 8017.

View the original Web API reference