# Time Series Billing

Sysdig Monitor utilizes a scalable billing method based on your consumption of custom time series. To enhance the billing experience, Sysdig allows you to view your time series consumption at a glance, analyze trends, and take action. As an administrator, you can easily identify trends, and scale time series usage as you grow due to either an increased container density or custom metrics consumption.

Time Series works only in SaaS environments.

The Sysdig Subscription page provides you the options to control your usage and spending. Based on your current subscription tier, time series usage, and the number of active agents, you can estimate the bill. With time series billing, it is easy to validate what you are being charged on, understand and control metric usage, and drop the data that is not required, either by metric or by the scope of the metric. For more information, see the following:

## Time Series Visualization

To help you so, Sysdig provides an at-a-glance visualization of the following:

• Time Series Usage

• Reserved

• Overage

• Time Series Usage Dashboard

• Reserved and On-Demand Agents

• Agent Usage Dashboard

• Usage history in CSV format

## Definitions

### Time Series

Time series is a stream of timestamped values belonging to the same metric and the same set of labels. Time series is identified by the name and a set of key-value pairs. Any changes to the label values lead to generating a totally different time series.

### Reserved Agents

Reserved agents are dedicated agents that are provisioned for a user regardless of usage. You can purchase reserved agents on a monthly or annual basis. As a Sysdig SaaS account administrator, you can increase your reserved agents at any time from within the Sysdig application.

### On-Demand Agents

On-demand agents are for short-term use and you pay only for what you use at an hourly rate. You have the ability to add and control on-demand agents. In the Sysdig application, use the Customize Your Plan > Enable On-demand Agents option on the Subscription page to add or remove agents. There is a hard limit of 500 agents for any account. If the total of reserved and on-demand exceeds this limit, you will not be able to purchase additional agents. On-demand agents are available only in Sysdig SaaS applications.

### Ingested Time Series

The time series that are collected, analyzed, processed for storage.

### Reserved Time Series

The number of time series data included with the subscription. Each user has 2000 time series data included per included with their subscription. The value is calculated as (the number of reserved agents + the number of on-demand agents) * the number of time series per agent. Time series consumed beyond your subscription limit will be charged and is aggregated across all agents running in your environment. What it means is that you use 3000 metrics on one agent and 1000 on another without incurring additional charges.

Contact Sales to purchase beyond your subscription limit.

### Overage Time Series

Time series ingested beyond Reserved time series is Overage.

### Churn Rate

When a time series stops receiving new data points, it becomes inactive. This event is called time series churn. It occurs more often during an upgrade in a Kubernetes cluster or when containers are replaced by new ones. In such cases, the container_id label in a container metric changes, and subsequently, all the existing time series are replaced by new time series (with the new container_id value).

The churn rate is the number of time series that churn over time.

The Time Series Usage DASHBOARD provides a ratio of time series detected at 1-hour period and 10-seconds period. This ratio is known as the churn percentage and it is expressed as this PromQL query:

(sum(sysdig_ts_usage{metric_category!='PROMETHEUS_REMOTE_WRITE'}) - sum(sysdig_ts_usage_10s)) / sum(sysdig_ts_usage{metric_category!='PROMETHEUS_REMOTE_WRITE'}) * 100

The time series collected by Prometheus Remote Write are excluded from this ratio because they are not collected by the Sysdig agent.

## Time Series Metrics

To help you identify the usage trends that are important to you, Sysdig provides the following metrics:

• sysdig_ts_usage: The metric reports the number of time series ingested for a user in a 20-minutes interval. The dashboard reports the 1-hour usage, which is the sum of the maximum of three 20-minute sysdig_ts_usage measurements taken in an hour. This metric can be segmented on metric category as well.

• sysdig_ts_usage_10s: The metric reports the number of time series ingested for a user in every 10-seconds window, per host (agent), and per metric category.

## Metering and Billing Time Series

Sysdig meters and bills only custom metrics.

• Prometheus

• JMX

• StatsD

• App checks

Billing is calculated using the sysdig_ts_usage metric. The metric reports the number of time series ingested for a user in an hour. For each hour, the number of time series ingested is calculated, and then the value is deducted from the number of reserved time series. This value is stored as the usage record. An hour period is considered to take the churn into account. The billing is per month.

A basic subscription will provide you 2000 time series per agent. This limit is applicable only to custom metrics, while you can continue consuming Sysdig and KSM metrics without incurring additional costs. Time series consumed beyond your subscription limit will be charged and is aggregated across all agents running in your environment.

Sysdig uses the 95th percentile to calculate the exceeding cost of usage. At the end of the month, the 95th percentile of the total number of active series sent per hour is calculated. Calculating the 95th percentile reduces the chances of billing you for unexpected spikes.

For example, if you have three agents running with the following consumption:

• Agent 1 collecting 2000 time series per hour

• Agent 2 collecting 1000 time series per hour

• Agent 3 collecting 4000 time series per hour

Time series billing is calculated as follows:

Total consumption = 7000

Allowed number of time series per hour: 3 * 2000 = 6000

Effectively, you are paying only for (7000 - 6000) = 1000 because the cost is calculated on the aggregated time series consumed across all the agents running in your environment.

## Time Series Usage Dashboard

Sysdig provides a Time Series Usage Dashboard with insight into the usage data. You can view time series ingestion at a glance and discover and analyze trends. The dashboard shows the average number of active time series per host; current ingestion rate; churn percentage; and so on.

## Access the Time Series Dashboard

On the Subscription page, under Usage, click Time Series Dashboard. You can view the following:

• Current 1 Hour Ingestion

• Current Ingestion from Agents

• Churn Percentage

• The average number of time series per host

• The number of time series ingested per category

• Host-level ingestion

• User ID

• Time

• Number of Reserved Agents

• Number of Connected On-Demand Agents

• Time Series included per agent

• Total used time series

• The ratio of used and reserved time series

## Edit Subscription

1. On the Subscription page, under Subscription Details , click the three dots.

2. Click Edit Subscription.

The Subscription Plan page gives you the directions to change the subscription plan.