From 0871e985cdc34aad94c1ac312722deac5643255d Mon Sep 17 00:00:00 2001
From: mmihaylovam <85890011+mmihaylovam@users.noreply.github.com>
Date: Wed, 3 Apr 2024 23:03:21 +0300
Subject: [PATCH] Not all internal metrics are ephemeral
---
pages/doc/metric_types.md | 2 +-
pages/doc/metrics_managing.md | 4 ++--
pages/doc/wavefront_internal_metrics.md | 5 ++++-
pages/doc/wavefront_release_notes.md | 5 ++++-
4 files changed, 11 insertions(+), 5 deletions(-)
diff --git a/pages/doc/metric_types.md b/pages/doc/metric_types.md
index 3b6e9a880..90f04867e 100644
--- a/pages/doc/metric_types.md
+++ b/pages/doc/metric_types.md
@@ -76,7 +76,7 @@ With the 2024-05 release, we introduce **ephemeral** metrics, which have a short
Ephemeral |
28 days of data retention. Suitable for metrics that are relevant for a short time and that have high cardinality, such as the Kubernetes metrics (kubernetes. ).
-By default, only the internal metrics are ephemeral and they are not convertible to persistent.
+By default, most of the internal metrics are ephemeral and they are not convertible to persistent.
Converting metrics from persistent to ephemeral improves the query performance and reduces the cardinality.
|
diff --git a/pages/doc/metrics_managing.md b/pages/doc/metrics_managing.md
index 38927ad6f..761c7d634 100644
--- a/pages/doc/metrics_managing.md
+++ b/pages/doc/metrics_managing.md
@@ -106,7 +106,7 @@ On the Metrics Browser, you can:
* Filter by name or source.
* Hide and redisplay individual metrics or metrics namespaces to unclutter your page.
* View the metric type in terms of retention period - persistent or ephemeral.
-* Convert persistent metrics to ephemeral and the reverse. Internal metrics are ephemeral and not convertible.
+* Convert persistent metrics to ephemeral and the reverse. Most of the internal metrics are ephemeral and not convertible.
* Create a chart or dashboard for an individual metric or for the current set of metrics.
* View the sources and point tags for an individual metric.
@@ -164,7 +164,7 @@ With the 2024-05 release, we introduce **ephemeral** metrics, which have short [
Converting persistent metrics to ephemeral can significantly improve the [query performance](query_language_performance.html) and reduce the [cardinality](cardinality.html).
-{% include note.html content="To change the retention period of a metric or metrics namespace, you must be a Super Admin user with [enabled Super Admin mode](users_account_managing.html#enable-or-disable-super-admin-mode). Internal metrics are ephemeral and not convertible to persistent." %}
+{% include note.html content="To change the retention period of a metric or metrics namespace, you must be a Super Admin user with [enabled Super Admin mode](users_account_managing.html#enable-or-disable-super-admin-mode). Most of the internal metrics are ephemeral and not convertible to persistent." %}
{% include important.html content="Converting a persistent metric to ephemeral **permanently deletes** the data points of this metric that are older than 28 days." %}
diff --git a/pages/doc/wavefront_internal_metrics.md b/pages/doc/wavefront_internal_metrics.md
index a1c8ea36c..de43a50ab 100644
--- a/pages/doc/wavefront_internal_metrics.md
+++ b/pages/doc/wavefront_internal_metrics.md
@@ -12,7 +12,10 @@ You can:
* Clone and modify one of the Operations for Applications Usage integration dashboards.
* Create your own dashboard, query these metrics in charts, and create alerts for some of these metrics.
-{% include note.html content="The internal metrics are [**ephemeral**](metric_types.html#metric-types-per-retention-period) and not convertible to persistent." %}
+Most of the internal metrics are [**ephemeral**](metric_types.html#metric-types-per-retention-period) and not convertible to persistent. Exceptions are the following internal metrics, which are persistent:
+```
+~collector.*points.reported, ~externalservices.*.points, ~derived-metrics.points.reported, ~collector.*histograms.reported, ~derived-histograms.histograms.reported, ~collector.*spans.reported, ~query.metrics_scanned, ~proxy.points.*.received, ~proxy.histograms.*.received, ~proxy.spans.*.received, ~proxy.spanLogs.*.received, ~proxy.build.version, ~metric.global.namespace.*, ~histogram.global.namespace.*, ~counter.global.namespace.*
+```
## Internal Metrics Overview
diff --git a/pages/doc/wavefront_release_notes.md b/pages/doc/wavefront_release_notes.md
index 4da5fa17c..8b2abd148 100644
--- a/pages/doc/wavefront_release_notes.md
+++ b/pages/doc/wavefront_release_notes.md
@@ -38,7 +38,10 @@ In October, 2023, we start to incrementally [**onboard**](csp_migration.html) al
## 2024-07.x Release Notes
-* **Ephemeral Internal Metrics**: All [internal metrics](wavefront-internal-metrics.html) are now [ephemeral](metric_types.html#metric-types-per-retention-period), so that they are retained for 28 days. Internal metrics are not convertible to persistent.
+**Ephemeral Internal Metrics**: Most of the [internal metrics](wavefront-internal-metrics.html) are now [ephemeral](metric_types.html#metric-types-per-retention-period) and not convertible to persistent. Exceptions are the following internal metrics, which remain persistent:
+```
+~collector.*points.reported, ~externalservices.*.points, ~derived-metrics.points.reported, ~collector.*histograms.reported, ~derived-histograms.histograms.reported, ~collector.*spans.reported, ~query.metrics_scanned, ~proxy.points.*.received, ~proxy.histograms.*.received, ~proxy.spans.*.received, ~proxy.spanLogs.*.received, ~proxy.build.version, ~metric.global.namespace.*, ~histogram.global.namespace.*, ~counter.global.namespace.*
+```
## 2024-05.x Release Notes