Daily Aggregate

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.
;