EntitySetQueryMetricsAggregated (v1.0.0)

Emitted after query metrics for an entity set have been aggregated.

EntitySetQueryMetricsAggregated

Emitted after query metrics for an entity set have been aggregated.

Base Schema

All analytics events are based on the TrackEvent schema which provides common properties like messageId, userId, context, timestamps, and more.

Base Schema Reference: analytics-track.yaml

Event-Specific Properties

This schema shows only the event-specific properties that extend the base TrackEvent schema:

11 properties

Properties specific to this event type (extends BaseEvent)

aggregationWindowStartstring<date-time>

Start timestamp (inclusive) of the aggregation window.

schemaNamespacestring

Logical namespace of the schema in which the queried entity set is defined. Indicates whether the schema is system-provided (e.g. `core`) or tenant-specific (`custom`).

dataSourcestring

Identifier of the logical context or model against which the entity set query was executed. A data source groups multiple related entity types and entity sets and represents the functional context of that query.

functionCountsarray[integer]

Counter array representing how often specific query functions were used. The array index corresponds to the internal FunctionFeatures flag position. Index 0 represents queries without functions. The array contains 41 entries, one for each defined function feature bit, including the `None` and `Unknown` flags.

entitiesReturnedinteger

Total number of entities returned across all executed queries for this entity set within the measured scope.

Minimum: 0
aggregationWindowEndstring<date-time>

End timestamp (exclusive) of the aggregation window.

aggregationIntervalstring

Duration of the aggregation window used for this event. Typically equals `aggregationWindowEnd` minus `aggregationWindowStart`. Must be an ISO 8601 duration (e.g. PT30S, PT5M, PT1H).

entitySetstring

Name of the entity set that was queried.

queryOptionCountsarray[integer]

Counter array representing how often specific query options were used. The array index corresponds to the internal QueryOptionFeatures flag position. Index 0 represents queries without any query options. The array contains 17 entries, one for each defined query option feature bit, including the `None` and `Unknown` flags.

operatorCountsarray[integer]

Counter array representing how often specific filter operators were used. The array index corresponds to the internal OperatorFeatures flag position. Index 0 represents queries without operators. The array contains 19 entries, one for each defined operator feature bit, including the `None` and `Unknown` flags.

queryCountinteger

Total number of queries executed for this entity set within the measured scope.

Minimum: 0