Data Storage Policies¶

As business applications increase, the scope of data monitoring requirements expands, and the need for storage duration of different data types will also adjust accordingly.

Guance provides various data storage policies. You can customize your data storage duration according to your needs, thereby effectively controlling data storage costs and saving money.

Data Storage Duration¶

Metrics¶

Storage Type	Optional Duration
Standard Storage Duration	3 / 7 / 14 / 30 / 60 / 90 days (original precision storage)
Long-term Storage Duration	Off / 90 / 120 / 180 / 360 days

Note

Metrics within the standard storage period maintain original precision, supporting high-performance chart interaction;
After enabling long-term storage, the system will automatically apply downsampling rules based on data storage time, significantly saving storage space. The downsampling algorithm retains the maximum value within each time period, ensuring critical data is not lost;
The long-term storage duration must be greater than the standard storage duration.

Downsampling rules are as follows:

Data Storage Time	Precision
Within standard storage duration	Original precision
Exceeding standard storage duration	1 minute
Exceeding 60 days	5 minutes
Exceeding 90 days	10 minutes
Exceeding 120 days	30 minutes
Exceeding 180 days	60 minutes

The above rules are executed in a tiered progression. When data storage time satisfies multiple conditions simultaneously, the higher-tier precision takes precedence.

Attention

The long-term storage feature is only supported for workspaces billed by data points. Workspaces billed by time series are not currently supported. If you need to adjust the billing method, please contact your account manager.

Logs¶

Storage Type	Optional Duration
Standard Storage Duration	3 / 7 / 14 / 30 / 60 / 90 days
Long-term Storage Duration	Off / 90 / 120 / 180 / 360 days

Note

Logs within the standard storage period support queries for any time range, suitable for high-frequency query scenarios like Explorer and Dashboards;
Logs within the long-term storage period are suitable for low-frequency queries, with a maximum single query time range of 24 hours;
The billing volume for log long-term storage is calculated based on the original storage volume of log data within the current total long-term storage cycle, minus the original storage volume of logs within the standard storage cycle (per GB/day). That is, only log data exceeding the standard storage duration is billed.

Other Data Types¶

Data Type	Optional Duration
Data Forwarding - Guance	180 / 360 / 720 days
Events	14 / 30 / 60 days
APM & LLM - Traces	3 / 7 / 14 / 30 / 60 / 90 days
APM - Profile	3 / 7 / 14 / 30 / 60 / 90 days
RUM	3 / 7 / 14 / 30 / 60 / 90 days
Synthetic Tests	3 / 7 / 14 /我们发现 30 / 60 / 90 days

Change Storage Policy¶

Steps¶

Go to Management > Workspace Settings > Change Data Storage Policy;
Click Change;
Select the data type for which you want to modify the storage policy, click Edit;
Select the storage duration;
If you need to enable long-term storage, turn on the "Enable Long-term Storage" switch and select the long-term storage duration. After configuration, a preview diagram of the storage policy will be displayed in the pop-up, visually presenting the precision changes at different stages;
After modification, click Confirm to change the data storage duration in the current workspace.

Effective Rules¶

First modification of the day: Takes effect immediately;
Multiple modifications on the same day: The last modification takes precedence and takes effect the next day;
After policy change, the system determines the data expiration range based on the latest configuration and performs cleanup processing at 0:00 the next day.

Change Notes¶

Permission restriction: Only the owner of a Commercial Plan workspace can perform this operation;
After changing the metric storage policy, data under the old policy will be deleted immediately. Please operate with caution;
After changing the log storage policy:
- New data: Stored and billed immediately according to the new policy;
- Old data: Continues to exist until rolled deletion and is billed according to the original policy;
For other data types (events, Trace, Profile, etc.) besides logs and metrics, after changing the policy:
- New data: Stored and billed immediately according to the new policy;
- Old data: Continues to exist until rolled deletion and is billed according to the original policy.

Scenario Examples¶

Metrics: Shorten standard storage time (14 days → 7 days), data generated before the adjustment point will be deleted immediately;
Logs: Shorten retention time (14 days → 7 days): Data generated before the adjustment point will still be billed according to the 14-day policy until cleared; subsequent data will be billed according to the 7-day policy;
Extend retention time (7 days → 14 days): Data generated before the adjustment point will still be billed according to the 7-day policy; subsequent data will be billed according to the 14-day policy.

Log Query Mode Explanation¶

After enabling log long-term storage, the Log Explorer supports two query modes:

Standard Query: Query logs within the standard storage range, supporting any time range, fast switching, and real-time response;
Long-term Query: Query logs within the long-term storage range, does not display status distribution charts. You need to select a date first, the time range is automatically filled as 00:00:00 - 23:59:59 by default. Supports free adjustment before clicking query to trigger, or quick date switching via the "Previous" and "Next" buttons.

When the query range exceeds the standard storage duration:

In Standard Query mode, if the selected time range exceeds the standard storage duration, the system will only return log data within the standard storage range. The system will prompt you that the current query range has exceeded the log standard storage duration (X days). To view logs older than X days, you need to switch to Long-term Query.
In Dashboards, Metric Analysis, or Query Tools, if a chart includes log queries and the time range exceeds the standard storage limit:
- If data exists within the standard storage range: The chart displays data from that range, while showing "Query results are incomplete". That is, the chart only displays log data within the standard storage range, excluding long-term storage logs. To query long-term storage logs, please reduce the single query time range to within 24 hours and query separately;
- If no data exists within the standard storage range: The system will automatically query the long-term storage data for the end date of the selected time range, while showing "Query results are incomplete". That is, since long-term storage logs only support a single query range of 24 hours, the system has automatically queried data for the end date of the selected time range. To view more long-term storage logs, please reduce the single query time range to within 24 hours and query separately.