Licensing concepts

Licensing concepts

Chronosphere uses the following terms when describing licensing concepts.

To track your telemetry usage against your licensing quotas, use the Chronosphere-provided, managed dashboards. For more information about each of these dashboards, see Licensing information.


Your license usage is determined by your database writes.

Matched writes are the number of writes per second being matched or ingested into the Chronosphere aggregation tier.

The aggregator counts the number of data points matched into each aggregator rule, whether rollup or downsampling. If a data point matches one rule, that's one matched write. If a data point matches two rules, that's two matched writes. The sum of the matched data points per rule equals the total matched writes for the aggregator.

A high level formula for this limit is:

Sum (number of data points matched per-rule).

Writes also depend on your Collector scrape interval. Reducing the scrape interval produces fewer writes, but can reduce visibility.

Persisted writes

The number of persisted writes to the Chronosphere database consists of the following:

(Number of unaggregated, raw data points written to the Chronosphere database) + (Number of aggregated data points written to the database) + (Number of non-Prometheus non-rolled up aggregated data points written to the database)

You can split the total system-persisted writes per second into quota allocations on a per-pool basis. Pools generally align with groups or teams, depending on your internal organization. Read more about configuring quotas. If you set up per-pool quotas, you can review the quotas in a dedicated dashboard.

To improve and enhance performance, stability, and features, Chronosphere adds time series to your database. These data points aren't counted against your license quota.

Persisted cardinality

The cardinality of the persisted writes sent to the Chronosphere database over a rolling, active two-hour window.

A high-level formula for current cardinality is:

(Number of unique time series written to the Chronosphere database from two hours previous to the current time)

To reduce your persisted cardinality, use rollup rules to downsample and aggregate metrics before they're stored.

Capacity limits

Capacity limits indicate your maximum license capacity for metrics data in Chronosphere. Exceeding your capacity limits incurs penalties, which can result in dropped metrics. Dropped metrics can affect dashboards, alerts, and other reports.

The license limit indicates your contractual system license with Chronosphere.

The capacity and license limits display in the Metrics License Consumption dashboard.

Tracing licenses

View tracing license information in the Tracing Licensed Consumption dashboard.

Retention policies

Retention policies define the amount of time Chronosphere retains telemetry data. To view your retention policies, you must have administrative privileges.

To view metric retention policies:

  1. In the navigation menu, click Go to Admin.
  2. Select Control > Ingest Configuration.

Contact Chronosphere Support to configure the intervals used for your system. These policies might be based on your contract or license.

For example, your system's retention policies might look like:

  • Five days for raw data, and resolutions of 15, 30, and 60 seconds.
  • 120 days for one-minute data.
  • 180 days for one-hour data.
  • 1825 days for 24-hour data.

Rules use the existing, configured set of intervals in rule definitions.