Page tree
Skip to end of metadata
Go to start of metadata
The information on this page refers to License Statistics versions prior to v6.3. This information no longer applies to License Statistics v6.3 and newer.

Obtaining information about usage per user for a feature

You can easily fetch metrics about usage per user by sending one of the following HTTP requests.

Usage per user for a single feature
 GET /api/v1/report/feature/${featureId}/usage-per-user/${returnType}?sd=${YYYY-MM-DD}&ed=${YYYY-MM-DD}&grat=${granularity}$(additional parameters, as needed)


Usage per user for a single license server
 GET /api/v1/report/license-server/${licenseServerId}/usage-per-user/${returnType}?sd=${YYYY-MM-DD}&ed=${YYYY-MM-DD}&grat=${granularity}$(additional parameters, as needed)

where $ indicates a variable value that you can replace with a value that best suits your needs. The possible parameters are described below.

ParameterRequiredTypeDescription
${featureId}Yesinteger

Internal License Statistics identification of the feature for which you want to view usage history.

${licenseServerId}Yesinteger/string

Internal License Statistics identification of the license server for which you want to view usage history, or "all" if information about all license servers is requested.

${returnType}YesstringStandard format option. See Making an API request for details.
sdYesdateStart date for which the report will be generated.
edYesdateEnd date for which the report will be generated.
gratYesenumeration

Period type the result is aggregated for. HOUR granularity is not supported. See granularity descriptions for further details.

agrtNointeger

Type of aggregation of the returned data. Aggregation type can be one of the following:

  • User - 1
  • Host - 2
  • User and host - 3
  • Usergroup - 4
  • Hostgroup - 5

By default, data is aggregated by user and host (3).

standard report optionsNovarious

See Making an API request for details.

Response

On success, this report will contain one row for each feature for each aggregator for each period. Each row consists of the following columns.


ColumnFull nameTypeDescriptionVisible by default in export
fudDatestring

The time period. Format depends on granularity.

(tick) Yes
uidUser IDstring

Internal License Statistics identification of the user for aggregations User(1) and User and Host(3).

Otherwise, a semicolon-separated list of user IDs.

(error) Unavailable
unUserstring

Name of the user for aggregations User(1) and User and host(3).

Otherwise, a semicolon-separated list of usernames.

(tick) Yes
uilUser is from LDAPstring

Information about whether the user is managed by LDAP for aggregations User(1) and User and host(3).

Otherwise, a null value.

(error) Unavailable
ugnUser Groupstring

Name of user group for aggregations Usergroup(4).

Otherwise, an empty string.

(warning) Only for aggregation Usergroup(4)
hnHoststring

Hostname for aggregations Host(2) and User and host(3).

Otherwise, a semicolon-separated list of hostnames.

(tick) Yes
hgnHost GroupstringName of host group for aggregations Hostgroup(5).

Otherwise, an empty string.

(warning) Only for aggregation Hostgroup(4)
lsidLicense Server IDintegerInternal License Statistics identification of the license server hosting the feature.
(error) Unavailable
lsnLicense ServerstringName of the license server hosting the feature.(tick) Yes
fidFeature IDintegerInternal License Statistics identification of the feature.
(error) Unavailable
fnsFeature NamestringFeature name.
(tick) Yes
fvFeature VersionstringFeature version.(tick) Yes
ftypeFeature TypeenumerationSee feature type descriptions for details.(tick) Yes
musageMax UsagefloatMaximum usage of licenses in relation to total number of licenses in the period, expressed in percentages.(tick) Yes
huHours UsedfloatCumulative time used by all licenses of the feature in the period, in hours.(tick) Yes
muMax UsedintegerMaximum number of licenses of the feature used in the period.
(tick) Yes
hbHours BorrowedfloatCumulative time of all license borrows of the feature in the period, in hours.
(tick) Yes
mbMax BorrowedintegerMaximum number of licenses of the feature borrowed in the period.
(tick) Yes

Note that the order in the table is the default order of the columns in the exported file.