chore: fix docs templates, fix stability markers, document missing PromQL fallbacks

Author: mmanciop

model/alerting/metrics.yaml

@@ -7,12 +7,26 @@ groups:
   - id: metric.dash0.check.status
     type: metric
     metric_name: dash0.check.status
-    stability: development
+    stability: stable
     brief: >
       Encodes the current state of a check as an enum.
     note: |
       Emitted by the check evaluation pipeline (scope `dash0-issue-metrics`).
       The value represents the check's overall status (e.g., ok, degraded, critical).
+
+      Deprecated PromQL alias: `dash0_check_status`.
+    instrument: gauge
+    unit: "{enum}"
+
+  - id: metric.dash0_check_status
+    type: metric
+    metric_name: dash0_check_status
+    stability: stable
+    deprecated:
+      reason: renamed
+      renamed_to: dash0.check.status
+    brief: >
+      Deprecated Prometheus alias for `dash0.check.status`.
     instrument: gauge
     unit: "{enum}"
 
@@ -22,11 +36,25 @@ groups:
   - id: metric.dash0.check.evaluation.outcome
     type: metric
     metric_name: dash0.check.evaluation.outcome
-    stability: development
+    stability: stable
     brief: >
       Encodes the outcome of check evaluations as an enum.
     note: |
       Emitted by the check evaluation pipeline (scope `dash0-issue-metrics`).
+
+      Deprecated PromQL alias: `dash0_check_evaluation_outcome`.
+    instrument: gauge
+    unit: "{enum}"
+
+  - id: metric.dash0_check_evaluation_outcome
+    type: metric
+    metric_name: dash0_check_evaluation_outcome
+    stability: stable
+    deprecated:
+      reason: renamed
+      renamed_to: dash0.check.evaluation.outcome
+    brief: >
+      Deprecated Prometheus alias for `dash0.check.evaluation.outcome`.
     instrument: gauge
     unit: "{enum}"
 
@@ -36,67 +64,52 @@ groups:
   - id: metric.dash0.check.evaluation.value
     type: metric
     metric_name: dash0.check.evaluation.value
-    stability: development
+    stability: stable
     brief: >
       The value returned by a check evaluation.
     note: |
       Emitted by the check evaluation pipeline (scope `dash0-issue-metrics`).
-    instrument: gauge
-    unit: "1"
 
-  # ──────────────────────────────────────────────
-  # dash0.check.threshold.critical
-  # ──────────────────────────────────────────────
-  - id: metric.dash0.check.threshold.critical
-    type: metric
-    metric_name: dash0.check.threshold.critical
-    stability: development
-    brief: >
-      Threshold above or below which a check evaluation counts as critical.
-    note: |
-      Emitted by the check evaluation pipeline (scope `dash0-issue-metrics`).
+      Deprecated PromQL alias: `dash0_check_evaluation_value`.
     instrument: gauge
     unit: "1"
 
-  # ──────────────────────────────────────────────
-  # dash0.check.threshold.degraded
-  # ──────────────────────────────────────────────
-  - id: metric.dash0.check.threshold.degraded
+  - id: metric.dash0_check_evaluation_value
     type: metric
-    metric_name: dash0.check.threshold.degraded
-    stability: development
+    metric_name: dash0_check_evaluation_value
+    stability: stable
+    deprecated:
+      reason: renamed
+      renamed_to: dash0.check.evaluation.value
     brief: >
-      Threshold above or below which a check evaluation counts as degraded.
-    note: |
-      Emitted by the check evaluation pipeline (scope `dash0-issue-metrics`).
+      Deprecated Prometheus alias for `dash0.check.evaluation.value`.
     instrument: gauge
     unit: "1"
 
-  # ──────────────────────────────────────────────
-  # dash0.check.enablement_conditions.value
-  # ──────────────────────────────────────────────
-  - id: metric.dash0.check.enablement_conditions.value
-    type: metric
-    metric_name: dash0.check.enablement_conditions.value
-    stability: development
-    brief: >
-      Whether the check enablement conditions were met.
-    note: |
-      Emitted by the check evaluation pipeline (scope `dash0-issue-metrics`).
-      The value is a boolean encoded as 0 or 1.
-    instrument: gauge
-    unit: "{bool}"
-
   # ──────────────────────────────────────────────
   # dash0.issue.status
   # ──────────────────────────────────────────────
   - id: metric.dash0.issue.status
     type: metric
     metric_name: dash0.issue.status
-    stability: development
+    stability: stable
     brief: >
       Encodes the current issue status as an enum.
     note: |
       Emitted by the check evaluation pipeline (scope `dash0-issue-metrics`).
+
+      Deprecated PromQL alias: `dash0_issue_status`.
+    instrument: gauge
+    unit: "{enum}"
+
+  - id: metric.dash0_issue_status
+    type: metric
+    metric_name: dash0_issue_status
+    stability: stable
+    deprecated:
+      reason: renamed
+      renamed_to: dash0.issue.status
+    brief: >
+      Deprecated Prometheus alias for `dash0.issue.status`.
     instrument: gauge
     unit: "{enum}"

model/deployment/entities.yaml

@@ -9,7 +9,7 @@ groups:
     stability: development
     name: deployment
     brief: >
-      Compat deployment entity, allowing additional optional attributes to pass validation
+      Mock entity for compatibility with Weaver, allowing additional optional attributes to pass validation
     attributes:
       - ref: deployment.name
         requirement_level: recommended

model/logging/metrics.yaml

@@ -7,7 +7,7 @@ groups:
   - id: metric.dash0.logs
     type: metric
     metric_name: dash0.logs
-    stability: development
+    stability: stable
     brief: >
       Counts the number of log records ingested by Dash0.
     note: |
@@ -25,7 +25,7 @@ groups:
   - id: metric.dash0_logs_total
     type: metric
     metric_name: dash0_logs_total
-    stability: development
+    stability: stable
     deprecated:
       reason: renamed
       renamed_to: dash0.logs

model/metrics/metrics.yaml

@@ -7,15 +7,29 @@ groups:
   - id: metric.dash0.metrics.datapoints
     type: metric
     metric_name: dash0.metrics.datapoints
-    stability: development
+    stability: stable
     brief: >
       Counts the number of metric data points ingested by Dash0.
     note: |
       `dash0.metrics.datapoints` is a synthetic metric: it is not stored as a metric
       time series, but computed on-the-fly from the ingested metrics data. It can be
       filtered and grouped by any metric or resource attribute.
 
+      Deprecated PromQL alias: `dash0_metrics_datapoints_total`.
+
       Synthetic metrics do not expose attributes by default. Attributes are
       materialised through PromQL aggregations.
     instrument: counter
     unit: "{metric_datapoint}"
+
+  - id: metric.dash0_metrics_datapoints_total
+    type: metric
+    metric_name: dash0_metrics_datapoints_total
+    stability: stable
+    deprecated:
+      reason: renamed
+      renamed_to: dash0.metrics.datapoints
+    brief: >
+      Deprecated Prometheus alias for `dash0.metrics.datapoints`.
+    instrument: counter
+    unit: "{metric_datapoint}"

model/registry/log-attributes.yaml

@@ -8,7 +8,7 @@ groups:
     attributes:
       - id: dash0.log.message
         type: string
-        stability: development
+        stability: stable
         brief: >
           Extracted or normalised log message text.
         note: |
@@ -20,7 +20,7 @@ groups:
 
       - id: dash0.log.pattern
         type: string
-        stability: development
+        stability: stable
         brief: >
           Identifier of the log pattern template matched by this log record.
         note: |
@@ -32,7 +32,7 @@ groups:
 
       - id: dash0.log.ai.attributes_inferred
         type: boolean
-        stability: development
+        stability: stable
         brief: >
           Indicates that log attributes were inferred by the AI log parser.
         note: |
@@ -43,7 +43,7 @@ groups:
 
       - id: dash0.log.ai.message_inferred
         type: boolean
-        stability: development
+        stability: stable
         brief: >
           Indicates that the log message was inferred by the AI log parser.
         note: |
@@ -54,7 +54,7 @@ groups:
 
       - id: dash0.log.ai.severity_inferred
         type: boolean
-        stability: development
+        stability: stable
         brief: >
           Indicates that the log severity was inferred by the AI log parser.
         note: |

model/registry/operation-attributes.yaml

@@ -8,7 +8,7 @@ groups:
     attributes:
       - id: dash0.operation.name
         type: string
-        stability: development
+        stability: stable
         brief: >
           Human-readable name for the logical operation a span belongs to.
         note: |
@@ -22,7 +22,7 @@ groups:
 
       - id: dash0.operation.type
         type: string
-        stability: development
+        stability: stable
         brief: >
           The type of the logical operation a span belongs to.
         note: |