Usage Analytics Limits
This article lists the usage analytics limits inside the Coveo Platform that either come from the platform itself or your license. Contact Coveo when you want to extend your license limits.
Resource Limits
Some usage analytics licensing limits you agreed upon when signing the Coveo Customer Agreement are displayed in the Coveo Administration Console Settings panel, under Analytics, in the Limits subtab. The Analytics limits are the following:
| Limit | Default value1 | Definition |
|---|---|---|
| Exports | 25 | Number of usage analytics data exports that members of your Coveo organization can create (see Manage Data Exports). |
| Export schedules | 25 | Number of data export schedules that members of your Coveo organization can create (see Manage Data Exports). |
| Custom dimensions | 25 | Number of user-defined dimensions that members of your Coveo organization can create (see Usage Analytics Dimensions and Add Dimension and Metric Filters in Usage Analytics Cards). |
| Reports | 500 | Number of usage analytics reports that members of your Coveo organization can create (see Usage Analytics Reports and Manage Usage Analytics Reports). |
| Named filters | 400 | Number of named filters that members of your Coveo organization can create (see Manage Named Filters). |
| Permission filters | 100 | Number of permission filters that members of your Coveo organization can create (see Manage Permission Filters). |
| Daily events | 10,000,000 | Number of usage analytics events that can be pushed to your Coveo organization per day. |
| Monthly events | 300,000,000 | Number of usage analytics events that can be pushed to your Coveo organization per month. |
| Queries per hour | 3,000 | Maximum number of queries that can be sent to the usage analytics database from your Coveo organization. Loading reports and cards triggers those queries. |
| Retention period | P3Y (3 years) | Number of months or years of usage analytics data that members of your Coveo organization can visualize. |
Note 1: Limit values for a Coveo Cloud Standard license. This limit can be increased if we believe that it’s for reasonable usage.
Other Limits
The following additional limits also apply:
| Limit | Value |
|---|---|
| Maximum number of custom dimensions |
|
| Maximum number of values per dimension filter (applies also to named and permission filters)1 |
|
| Maximum number of characters for every dimension value | See Dimension Value Limits |
| Maximum size of analytics data exports | None2 |
| Maximum number of analytics data exports |
|
1: Any combination of filters on the same dimension, including named and permission filters, can’t exceed 75 values as well.
2: It’s however strongly recommended to keep exports below 1 million rows for performance reasons. A warning is issued if your export exceeds that size. To avoid that, you can split your annual export into smaller exports (e.g., one per quarter).
Dimensions and the Maximum Length of Their Logged Values
Each dimension (custom and default) has its own column in the database. Each column can only contain values of a certain type and a certain length depending on the dimension. The following table displays the column name and the DB data type as well as the limit of characters the column can contain when applicable (see Data types and SQL General Data Types ).
When you send blocks of text through a custom dimension (text), the database only keeps the first 256 characters.
| Column name | DB data type (Limit of characters) |
|---|---|
account_id |
varchar(128) |
advanced_query_expression |
varchar(2048) |
batch_id |
char(36) |
cause |
varchar(64) |
cause2 |
varchar(64) |
custom_datas |
varchar(32500) |
[Custom dimension (Boolean) name] |
boolean |
[Custom dimension (datetime) name] |
timestamp |
[Custom dimension (number) name] |
float8 |
[Custom dimension (text) name] |
varchar(256) |
datetime |
timestamp |
device_category |
varchar(128) |
document_author |
varchar(128) |
document_category |
varchar(128) |
document_title |
varchar(128) |
event_outcome |
integer |
is_anonymous |
boolean |
is_contextual |
boolean |
is_internal |
boolean |
number_of_results |
integer |
operating_system |
varchar(128) |
operating_system_with_version |
varchar(128) |
origin_device |
varchar(256) |
origin_city |
varchar(256) |
origin_context |
varchar(128) |
origin_country |
varchar(256) |
origin_is_mobile |
boolean |
origin_language |
varchar(256) |
origin_level_1 |
varchar(128) |
origin_level_2 |
varchar(128) |
origin_levelv3 |
varchar(128) |
origin_region |
varchar(256) |
query_expression |
varchar(500) |
query_pipeline |
varchar(128) |
response_time_ms |
integer |
search_id |
char(36) |
split_test_run_name |
varchar(128) |
split_test_run_version |
varchar(128) |
unique_user_id |
varchar(128) |
user_agent |
varchar(1024) |
user_id |
varchar(128) |
user_ip |
varchar(50) |
user_name |
varchar(128) |
visit_id |
char(36) |
visitor_id |
varchar(128) |
web_browser |
varchar(128) |
web_browser_with_version |
varchar(128) |
with_clicks |
boolean |
with_results |
boolean |