---
myst:
  html_meta:
    "description": "Understanding-oriented background on cdk8s-monitoring: its architecture, its design philosophy, its platform assumptions, its alerting defaults, pod priority, and how retention and downsampling work."
    "property=og:description": "Understanding-oriented background on cdk8s-monitoring: its architecture, its design philosophy, its platform assumptions, its alerting defaults, pod priority, and how retention and downsampling work."
    "property=og:title": "Explanation"
    "keywords": "cdk8s, Kubernetes, monitoring, architecture, design, retention, downsampling"
---

```{image} ../_static/kup6s-icon-explanation.svg
:align: center
:class: section-icon-large
```

# Explanation

**Understanding-oriented background on how cdk8s-monitoring works and why.**

These pages are for reading away from the keyboard.
They connect the pieces, give context, and explain the choices behind the library.
For step-by-step instructions, see the {doc}`../how-to/index`.

## Topics

```{toctree}
---
maxdepth: 1
titlesonly: true
---
architecture
tracing-architecture
design-philosophy
platform-assumptions
alerting-defaults
pod-priority
retention-and-downsampling
```

---

**Want to do something specific?** See the {doc}`../how-to/index`.

**Need exact values?** See the {doc}`../reference/index`.