@bluedynamics/cdk8s-monitoring 0.0.1 → 0.1.0

package/README.md

@@ -41,6 +41,13 @@ const config = mergeConfig({
     buckets: { thanos: 'metrics-thanos', loki: 'logs-loki' },
   },
   smtp: { host: 'mail.example.com', port: 587, from: 'monitoring@example.com', requireTls: true },
+  integrations: {
+    s3ProviderConfig: 'my-s3-provider',          // Crossplane ProviderConfig (buckets)
+    s3SecretStore: 'my-s3-secret-store',         // ESO ClusterSecretStore (S3 credentials)
+    s3CredentialsKey: 'my-s3-credentials',       // remote key holding AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY
+    grafanaSecretStore: 'my-app-secret-store',   // ESO ClusterSecretStore (Grafana admin)
+    grafanaCredentialsKey: 'my-grafana-admin',   // remote key holding admin-user / admin-password
+  },
   // Override any default, e.g. storage: { prometheus: '30Gi' }
 });
 
@@ -50,7 +57,7 @@ app.synth();
 
 ### Required vs. defaulted configuration
 
-- **Required (`RequiredClusterConfig`)**: `namespace`, `domains`, `s3`, `smtp`. No universal default exists, so you must provide them.
+- **Required (`RequiredClusterConfig`)**: `namespace`, `domains`, `s3`, `smtp`, `integrations`. No universal default exists, so you must provide them. `integrations` names the external Crossplane ProviderConfig and ESO ClusterSecretStores/keys this stack references (nothing is hardcoded — wire your own).
 - **Defaulted (`DefaultableConfig`)**: `versions`, `retention`, `storage`, `replicas`, `resources`. Shipped in `DEFAULT_CONFIG`; override any subset via `mergeConfig` (deep-merged).
 
 ### Adding application dashboards and alerts

package/documentation/Makefile

@@ -0,0 +1,357 @@
+##############################################################################
+# THIS FILE IS GENERATED BY MXMAKE
+#
+# DOMAINS:
+#: core.base
+#: core.mxenv
+#: docs.sphinx
+#
+# SETTINGS (ALL CHANGES MADE BELOW SETTINGS WILL BE LOST)
+##############################################################################
+
+## core.base
+
+# `deploy` target dependencies.
+# No default value.
+DEPLOY_TARGETS?=
+
+# target to be executed when calling `make run`
+# No default value.
+RUN_TARGET?=
+
+# Additional files and folders to remove when running clean target
+# No default value.
+CLEAN_FS?=
+
+# Optional makefile to include before default targets. This can
+# be used to provide custom targets or hook up to existing targets.
+# Default: include.mk
+INCLUDE_MAKEFILE?=include.mk
+
+# Optional additional directories to be added to PATH in format
+# `/path/to/dir/:/path/to/other/dir`. Gets inserted first, thus gets searched
+# first.
+# No default value.
+EXTRA_PATH?=
+
+# Path to Python project relative to Makefile (repository root).
+# Leave empty if Python project is in the same directory as Makefile.
+# For monorepo setups, set to subdirectory name (e.g., `backend`).
+# Future-proofed for multi-language monorepos (e.g., PROJECT_PATH_NODEJS).
+# No default value.
+PROJECT_PATH_PYTHON?=
+
+## core.mxenv
+
+# Primary Python interpreter to use. It is used to create the
+# virtual environment if `VENV_ENABLED` and `VENV_CREATE` are set to `true`.
+# If global `uv` is used, this value is passed as `--python VALUE` to the venv creation.
+# uv then downloads the Python interpreter if it is not available.
+# for more on this feature read the [uv python documentation](https://docs.astral.sh/uv/concepts/python-versions/)
+# Default: python3
+PRIMARY_PYTHON?=3.13
+
+# Minimum required Python version.
+# Default: 3.10
+PYTHON_MIN_VERSION?=3.13
+
+# Install packages using the given package installer method.
+# Supported are `pip` and `uv`. When `uv` is selected, a global installation
+# is auto-detected and used if available. Otherwise, uv is installed in the
+# virtual environment or using `PRIMARY_PYTHON`, depending on the
+# `VENV_ENABLED` setting.
+# Default: pip
+PYTHON_PACKAGE_INSTALLER?=uv
+
+# Python version for UV to install/use when creating virtual
+# environments with global UV. Passed to `uv venv -p VALUE`. Supports version
+# specs like `3.11`, `3.14`, `cpython@3.14`. Defaults to PRIMARY_PYTHON value
+# for backward compatibility.
+# Default: $(PRIMARY_PYTHON)
+UV_PYTHON?=$(PRIMARY_PYTHON)
+
+# Flag whether to use virtual environment. If `false`, the
+# interpreter according to `PRIMARY_PYTHON` found in `PATH` is used.
+# Default: true
+VENV_ENABLED?=true
+
+# Flag whether to create a virtual environment. If set to `false`
+# and `VENV_ENABLED` is `true`, `VENV_FOLDER` is expected to point to an
+# existing virtual environment.
+# Default: true
+VENV_CREATE?=true
+
+# The folder of the virtual environment.
+# If `VENV_ENABLED` is `true` and `VENV_CREATE` is true it is used as the
+# target folder for the virtual environment. If `VENV_ENABLED` is `true` and
+# `VENV_CREATE` is false it is expected to point to an existing virtual
+# environment. If `VENV_ENABLED` is `false` it is ignored.
+# Default: .venv
+VENV_FOLDER?=.venv
+
+# mxdev to install in virtual environment.
+# Default: mxdev
+MXDEV?=mxdev
+
+# mxmake to install in virtual environment.
+# Default: mxmake
+MXMAKE?=mxmake
+
+## docs.sphinx
+
+# Documentation source folder.
+# Default: docs/source
+DOCS_SOURCE_FOLDER?=sources
+
+# Documentation generation target folder.
+# Default: docs/html
+DOCS_TARGET_FOLDER?=html
+
+# Documentation linkcheck output folder.
+# Default: docs/linkcheck
+DOCS_LINKCHECK_FOLDER?=docs/linkcheck
+
+# Documentation Python requirements to be installed (via pip).
+# No default value.
+DOCS_REQUIREMENTS?=myst_parser sphinxcontrib.mermaid shibuya sphinx-design sphinx-copybutton
+
+##############################################################################
+# END SETTINGS - DO NOT EDIT BELOW THIS LINE
+##############################################################################
+
+INSTALL_TARGETS?=
+DIRTY_TARGETS?=
+CLEAN_TARGETS?=
+PURGE_TARGETS?=
+
+export PATH:=$(if $(EXTRA_PATH),$(EXTRA_PATH):,)$(PATH)
+
+# Helper variable: adds trailing slash to PROJECT_PATH_PYTHON only if non-empty
+PYTHON_PROJECT_PREFIX=$(if $(PROJECT_PATH_PYTHON),$(PROJECT_PATH_PYTHON)/,)
+
+# Defensive settings for make: https://tech.davis-hansson.com/p/make/
+SHELL:=bash
+.ONESHELL:
+# for Makefile debugging purposes add -x to the .SHELLFLAGS
+.SHELLFLAGS:=-eu -o pipefail -O inherit_errexit -c
+.SILENT:
+.DELETE_ON_ERROR:
+MAKEFLAGS+=--warn-undefined-variables
+MAKEFLAGS+=--no-builtin-rules
+
+# mxmake folder
+MXMAKE_FOLDER?=.mxmake
+
+# Sentinel files
+SENTINEL_FOLDER?=$(MXMAKE_FOLDER)/sentinels
+SENTINEL?=$(SENTINEL_FOLDER)/about.txt
+$(SENTINEL): $(firstword $(MAKEFILE_LIST))
+	@mkdir -p $(SENTINEL_FOLDER)
+	@echo "Sentinels for the Makefile process." > $(SENTINEL)
+
+##############################################################################
+# mxenv
+##############################################################################
+
+OS?=
+
+# Determine the executable path
+ifeq ("$(VENV_ENABLED)", "true")
+export VIRTUAL_ENV=$(abspath $(VENV_FOLDER))
+ifeq ("$(OS)", "Windows_NT")
+VENV_EXECUTABLE_FOLDER=$(VIRTUAL_ENV)/Scripts
+else
+VENV_EXECUTABLE_FOLDER=$(VIRTUAL_ENV)/bin
+endif
+export PATH:=$(VENV_EXECUTABLE_FOLDER):$(PATH)
+MXENV_PYTHON=python
+else
+MXENV_PYTHON=$(PRIMARY_PYTHON)
+endif
+
+# Determine the package installer with non-interactive flags
+ifeq ("$(PYTHON_PACKAGE_INSTALLER)","uv")
+PYTHON_PACKAGE_COMMAND=uv pip --no-progress
+else
+PYTHON_PACKAGE_COMMAND=$(MXENV_PYTHON) -m pip
+endif
+
+# Auto-detect global uv availability (simple existence check)
+ifeq ("$(PYTHON_PACKAGE_INSTALLER)","uv")
+UV_AVAILABLE:=$(shell command -v uv >/dev/null 2>&1 && echo "true" || echo "false")
+else
+UV_AVAILABLE:=false
+endif
+
+# Determine installation strategy
+# depending on the PYTHON_PACKAGE_INSTALLER and UV_AVAILABLE
+# - both vars can be false or
+# - one of them can be true,
+# - but never boths.
+USE_GLOBAL_UV:=$(shell [[ "$(PYTHON_PACKAGE_INSTALLER)" == "uv" && "$(UV_AVAILABLE)" == "true" ]] && echo "true" || echo "false")
+USE_LOCAL_UV:=$(shell [[ "$(PYTHON_PACKAGE_INSTALLER)" == "uv" && "$(UV_AVAILABLE)" == "false" ]] && echo "true" || echo "false")
+
+# Check if global UV is outdated (non-blocking warning)
+ifeq ("$(USE_GLOBAL_UV)","true")
+UV_OUTDATED:=$(shell uv self update --dry-run 2>&1 | grep -q "Would update" && echo "true" || echo "false")
+else
+UV_OUTDATED:=false
+endif
+
+MXENV_TARGET:=$(SENTINEL_FOLDER)/mxenv.sentinel
+$(MXENV_TARGET): $(SENTINEL)
+	# Validation: Check Python version if not using global uv
+ifneq ("$(USE_GLOBAL_UV)","true")
+	@$(PRIMARY_PYTHON) -c "import sys; vi = sys.version_info; sys.exit(1 if (int(vi[0]), int(vi[1])) >= tuple(map(int, '$(PYTHON_MIN_VERSION)'.split('.'))) else 0)" \
+		&& echo "Need Python >= $(PYTHON_MIN_VERSION)" && exit 1 || :
+else
+	@echo "Using global uv for Python $(UV_PYTHON)"
+endif
+	# Validation: Check VENV_FOLDER is set if venv enabled
+	@[[ "$(VENV_ENABLED)" == "true" && "$(VENV_FOLDER)" == "" ]] \
+		&& echo "VENV_FOLDER must be configured if VENV_ENABLED is true" && exit 1 || :
+	# Validation: Check uv not used with system Python
+	@[[ "$(VENV_ENABLED)" == "false" && "$(PYTHON_PACKAGE_INSTALLER)" == "uv" ]] \
+		&& echo "Package installer uv does not work with a global Python interpreter." && exit 1 || :
+	# Warning: Notify if global UV is outdated
+ifeq ("$(UV_OUTDATED)","true")
+	@echo "WARNING: A newer version of uv is available. Run 'uv self update' to upgrade."
+endif
+
+	# Create virtual environment
+ifeq ("$(VENV_ENABLED)", "true")
+ifeq ("$(VENV_CREATE)", "true")
+ifeq ("$(USE_GLOBAL_UV)","true")
+	@echo "Setup Python Virtual Environment using global uv at '$(VENV_FOLDER)'"
+	@uv venv --allow-existing --no-progress -p $(UV_PYTHON) --seed $(VENV_FOLDER)
+else
+	@echo "Setup Python Virtual Environment using module 'venv' at '$(VENV_FOLDER)'"
+	@$(PRIMARY_PYTHON) -m venv $(VENV_FOLDER)
+	@$(MXENV_PYTHON) -m ensurepip -U
+endif
+endif
+else
+	@echo "Using system Python interpreter"
+endif
+
+	# Install uv locally if needed
+ifeq ("$(USE_LOCAL_UV)","true")
+	@echo "Install uv in virtual environment"
+	@$(MXENV_PYTHON) -m pip install uv
+endif
+
+	# Install/upgrade core packages
+	@$(PYTHON_PACKAGE_COMMAND) install -U pip setuptools wheel
+	@echo "Install/Update MXStack Python packages"
+	@$(PYTHON_PACKAGE_COMMAND) install -U $(MXDEV) $(MXMAKE)
+	@touch $(MXENV_TARGET)
+
+.PHONY: mxenv
+mxenv: $(MXENV_TARGET)
+
+.PHONY: mxenv-dirty
+mxenv-dirty:
+	@rm -f $(MXENV_TARGET)
+
+.PHONY: mxenv-clean
+mxenv-clean: mxenv-dirty
+ifeq ("$(VENV_ENABLED)", "true")
+ifeq ("$(VENV_CREATE)", "true")
+	@rm -rf $(VENV_FOLDER)
+endif
+else
+	@$(PYTHON_PACKAGE_COMMAND) uninstall -y $(MXDEV)
+	@$(PYTHON_PACKAGE_COMMAND) uninstall -y $(MXMAKE)
+endif
+
+INSTALL_TARGETS+=mxenv
+DIRTY_TARGETS+=mxenv-dirty
+CLEAN_TARGETS+=mxenv-clean
+
+##############################################################################
+# sphinx
+##############################################################################
+
+# additional targets required for building docs.
+DOCS_TARGETS+=
+
+SPHINX_BIN=sphinx-build
+SPHINX_AUTOBUILD_BIN=sphinx-autobuild
+
+DOCS_TARGET:=$(SENTINEL_FOLDER)/sphinx.sentinel
+$(DOCS_TARGET): $(MXENV_TARGET)
+	@echo "Install Sphinx"
+	@$(PYTHON_PACKAGE_COMMAND) install -U sphinx sphinx-autobuild $(DOCS_REQUIREMENTS)
+	@touch $(DOCS_TARGET)
+
+.PHONY: docs
+docs: $(DOCS_TARGET) $(DOCS_TARGETS)
+	@echo "Build sphinx docs"
+	@$(SPHINX_BIN) $(DOCS_SOURCE_FOLDER) $(DOCS_TARGET_FOLDER)
+
+.PHONY: docs-live
+docs-live: $(DOCS_TARGET) $(DOCS_TARGETS)
+	@echo "Rebuild Sphinx documentation on changes, with live-reload in the browser"
+	@$(SPHINX_AUTOBUILD_BIN) $(DOCS_SOURCE_FOLDER) $(DOCS_TARGET_FOLDER)
+
+.PHONY: docs-linkcheck
+docs-linkcheck: $(DOCS_TARGET) $(DOCS_TARGETS)
+	@echo "Run Sphinx linkcheck"
+	@$(SPHINX_BIN) -b linkcheck $(DOCS_SOURCE_FOLDER) $(DOCS_LINKCHECK_FOLDER)
+
+.PHONY: docs-dirty
+docs-dirty:
+	@rm -f $(DOCS_TARGET)
+
+.PHONY: docs-clean
+docs-clean: docs-dirty
+	@test -e $(MXENV_PYTHON) && $(MXENV_PYTHON) -m pip uninstall -y \
+		sphinx sphinx-autobuild $(DOCS_REQUIREMENTS) || :
+	@rm -rf $(DOCS_TARGET_FOLDER)
+
+INSTALL_TARGETS+=$(DOCS_TARGET)
+DIRTY_TARGETS+=docs-dirty
+CLEAN_TARGETS+=docs-clean
+
+##############################################################################
+# Custom includes
+##############################################################################
+
+-include $(INCLUDE_MAKEFILE)
+
+##############################################################################
+# Default targets
+##############################################################################
+
+INSTALL_TARGET:=$(SENTINEL_FOLDER)/install.sentinel
+$(INSTALL_TARGET): $(INSTALL_TARGETS)
+	@touch $(INSTALL_TARGET)
+
+.PHONY: install
+install: $(INSTALL_TARGET)
+	@touch $(INSTALL_TARGET)
+
+.PHONY: run
+run: $(RUN_TARGET)
+
+.PHONY: deploy
+deploy: $(DEPLOY_TARGETS)
+
+.PHONY: dirty
+dirty: $(DIRTY_TARGETS)
+	@rm -f $(INSTALL_TARGET)
+
+.PHONY: clean
+clean: dirty $(CLEAN_TARGETS)
+	@rm -rf $(CLEAN_TARGETS) $(MXMAKE_FOLDER) $(CLEAN_FS)
+
+.PHONY: purge
+purge: clean $(PURGE_TARGETS)
+
+.PHONY: runtime-clean
+runtime-clean:
+	@echo "Remove runtime artifacts, like byte-code and caches."
+	@find . -name '*.py[c|o]' -delete
+	@find . -name '*~' -exec rm -f {} +
+	@find . -name '__pycache__' -exec rm -fr {} +
+

package/documentation/README.md

@@ -0,0 +1,72 @@
+# cdk8s-monitoring documentation
+
+This directory contains the documentation for `@bluedynamics/cdk8s-monitoring`, built with [Sphinx](https://www.sphinx-doc.org/), [MyST Parser](https://myst-parser.readthedocs.io/), and organized with the [Diátaxis framework](https://diataxis.fr/).
+
+## Published documentation
+
+<https://bluedynamics.github.io/cdk8s-monitoring/>
+
+## Build locally
+
+### Prerequisites
+
+- Python 3.13 (or 3.10+ with manual configuration)
+- The `make` command
+- `uv` (optional, but recommended for faster installs)
+
+### Quick start
+
+```shell
+cd documentation
+make docs
+```
+
+Open `html/index.html` in your browser.
+
+The first build creates a virtual environment, installs Sphinx and the required extensions, and generates the HTML.
+Subsequent builds reuse the environment and are much faster.
+
+### Live reload
+
+```shell
+cd documentation
+make docs-live
+```
+
+This starts a development server that rebuilds and refreshes the browser whenever you save a file.
+
+### Clean build
+
+```shell
+make clean
+make docs
+```
+
+## Structure
+
+The documentation follows the four Diátaxis quadrants.
+
+```
+sources/
+├── index.md            # Landing page with grid cards
+├── tutorials/          # Learning-oriented lessons
+├── how-to/             # Goal-oriented recipes
+├── reference/          # Information-oriented specifications
+│   └── api/            # Construct and interface overview
+├── explanation/        # Understanding-oriented background
+└── _static/            # CSS, icons, fonts, scripts
+```
+
+## Style
+
+Documentation is authored in plone-doc-style: American English, one sentence per line, sentence-case headings, dash-separated filenames, and sparse admonitions.
+
+## Theme and extensions
+
+- **Theme:** [Shibuya](https://shibuya.lepture.com/)
+- **Parser:** [MyST](https://myst-parser.readthedocs.io/)
+- **Extensions:** `myst_parser`, `sphinxcontrib.mermaid`, `sphinx_design`, `sphinx_copybutton`
+
+## Deployment
+
+A push to `main` that touches `documentation/` triggers the `documentation.yml` GitHub Actions workflow, which builds the site and deploys it to GitHub Pages.

package/documentation/mx.ini

@@ -0,0 +1,3 @@
+[settings]
+threads = 5
+version-overrides =

package/documentation/sources/_build/html/.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: c6f4b154db9f6c9190f85eed1c9807ae
+tags: 645f666f9bcd5a90fca523b33c5a78b7

package/documentation/sources/_build/html/_images/kup6s-icon-explanation.svg

@@ -0,0 +1,32 @@
+<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
+  <g transform="translate(50, 50)">
+    <path d="M -35,-35 L -30,-35 L -30,-30" stroke="#00d4ff" stroke-width="2.5" fill="none"/>
+    <path d="M -35,35 L -30,35 L -30,30" stroke="#00d4ff" stroke-width="2.5" fill="none"/>
+    <path d="M 35,-35 L 30,-35 L 30,-30" stroke="#ff00ff" stroke-width="2.5" fill="none"/>
+    <path d="M 35,35 L 30,35 L 30,30" stroke="#ff00ff" stroke-width="2.5" fill="none"/>
+    
+    <line x1="-25" y1="-15" x2="25" y2="-15" stroke="#00d4ff" stroke-width="1" opacity="0.4"/>
+    <line x1="-25" y1="15" x2="25" y2="15" stroke="#ff00ff" stroke-width="1" opacity="0.4"/>
+    
+    <!-- Explanation: Document with lightbulb/understanding symbol -->
+    <rect x="-12" y="-16" width="24" height="32" fill="none" stroke="#00d4ff" stroke-width="2.5"/>
+    <path d="M 12,-16 L 12,-10 L 6,-10" fill="none" stroke="#ff00ff" stroke-width="2"/>
+    <path d="M 6,-10 L 12,-10 L 12,-16" fill="#ff00ff" opacity="0.3"/>
+    
+    <!-- Lightbulb for understanding -->
+    <circle cx="0" cy="-2" r="6" fill="none" stroke="#ff00ff" stroke-width="2"/>
+    <path d="M -3,4 L -3,7 L 3,7 L 3,4" fill="none" stroke="#00d4ff" stroke-width="1.5"/>
+    <line x1="-1" y1="8" x2="1" y2="8" stroke="#00d4ff" stroke-width="1.5"/>
+    
+    <!-- Light rays -->
+    <line x1="-8" y1="-2" x2="-10" y2="-2" stroke="#ff00ff" stroke-width="1.5" opacity="0.6"/>
+    <line x1="8" y1="-2" x2="10" y2="-2" stroke="#ff00ff" stroke-width="1.5" opacity="0.6"/>
+    <line x1="-5" y1="-7" x2="-7" y2="-9" stroke="#ff00ff" stroke-width="1.5" opacity="0.6"/>
+    <line x1="5" y1="-7" x2="7" y2="-9" stroke="#ff00ff" stroke-width="1.5" opacity="0.6"/>
+    
+    <line x1="-12" y1="-10" x2="-12" y2="16" stroke="#ff00ff" stroke-width="3" opacity="0.4"/>
+    
+    <circle cx="-28" cy="0" r="2" fill="#00d4ff" opacity="0.8"/>
+    <circle cx="28" cy="0" r="2" fill="#ff00ff" opacity="0.8"/>
+  </g>
+</svg>

package/documentation/sources/_build/html/_images/kup6s-icon-howto.svg

@@ -0,0 +1,34 @@
+<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
+  <g transform="translate(50, 50)">
+    <path d="M -35,-35 L -30,-35 L -30,-30" stroke="#00d4ff" stroke-width="2.5" fill="none"/>
+    <path d="M -35,35 L -30,35 L -30,30" stroke="#00d4ff" stroke-width="2.5" fill="none"/>
+    <path d="M 35,-35 L 30,-35 L 30,-30" stroke="#ff00ff" stroke-width="2.5" fill="none"/>
+    <path d="M 35,35 L 30,35 L 30,30" stroke="#ff00ff" stroke-width="2.5" fill="none"/>
+    
+    <line x1="-25" y1="-15" x2="25" y2="-15" stroke="#00d4ff" stroke-width="1" opacity="0.4"/>
+    <line x1="-25" y1="15" x2="25" y2="15" stroke="#ff00ff" stroke-width="1" opacity="0.4"/>
+    
+    <!-- How-to: Document with numbered steps/checklist -->
+    <rect x="-12" y="-16" width="24" height="32" fill="none" stroke="#00d4ff" stroke-width="2.5"/>
+    <path d="M 12,-16 L 12,-10 L 6,-10" fill="none" stroke="#ff00ff" stroke-width="2"/>
+    <path d="M 6,-10 L 12,-10 L 12,-16" fill="#ff00ff" opacity="0.3"/>
+    
+    <!-- Numbered steps -->
+    <circle cx="-7" cy="-6" r="2" fill="none" stroke="#ff00ff" stroke-width="1.5"/>
+    <text x="-7" y="-4" font-family="Arial" font-size="6" fill="#ff00ff" text-anchor="middle" font-weight="bold">1</text>
+    <line x1="-3" y1="-6" x2="8" y2="-6" stroke="#ff00ff" stroke-width="1.5" opacity="0.8"/>
+    
+    <circle cx="-7" cy="1" r="2" fill="none" stroke="#ff00ff" stroke-width="1.5"/>
+    <text x="-7" y="3" font-family="Arial" font-size="6" fill="#ff00ff" text-anchor="middle" font-weight="bold">2</text>
+    <line x1="-3" y1="1" x2="8" y2="1" stroke="#ff00ff" stroke-width="1.5" opacity="0.6"/>
+    
+    <circle cx="-7" cy="8" r="2" fill="none" stroke="#00d4ff" stroke-width="1.5"/>
+    <text x="-7" y="10" font-family="Arial" font-size="6" fill="#00d4ff" text-anchor="middle" font-weight="bold">3</text>
+    <line x1="-3" y1="8" x2="6" y2="8" stroke="#00d4ff" stroke-width="1.5" opacity="0.4"/>
+    
+    <line x1="-12" y1="-10" x2="-12" y2="16" stroke="#ff00ff" stroke-width="3" opacity="0.4"/>
+    
+    <circle cx="-28" cy="0" r="2" fill="#00d4ff" opacity="0.8"/>
+    <circle cx="28" cy="0" r="2" fill="#ff00ff" opacity="0.8"/>
+  </g>
+</svg>

package/documentation/sources/_build/html/_images/kup6s-icon-monitoring.svg

@@ -0,0 +1,79 @@
+<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
+  <g transform="translate(50, 50)">
+    <!-- Scanlines (CRT effect - reduced) -->
+    <line x1="-35" y1="-28" x2="35" y2="-28" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    <line x1="-35" y1="-20" x2="35" y2="-20" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    <line x1="-35" y1="-12" x2="35" y2="-12" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    <line x1="-35" y1="-4" x2="35" y2="-4" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    <line x1="-35" y1="4" x2="35" y2="4" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    <line x1="-35" y1="12" x2="35" y2="12" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    <line x1="-35" y1="20" x2="35" y2="20" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    <line x1="-35" y1="28" x2="35" y2="28" stroke="#00d4ff" stroke-width="0.3" opacity="0.12"/>
+    
+    <!-- Corner brackets -->
+    <path d="M -35,-35 L -30,-35 L -30,-30" stroke="#00d4ff" stroke-width="2.5" fill="none"/>
+    <path d="M -35,35 L -30,35 L -30,30" stroke="#00d4ff" stroke-width="2.5" fill="none"/>
+    <path d="M 35,-35 L 30,-35 L 30,-30" stroke="#ff00ff" stroke-width="2.5" fill="none"/>
+    <path d="M 35,35 L 30,35 L 30,30" stroke="#ff00ff" stroke-width="2.5" fill="none"/>
+    
+    <!-- Glitch lines (digital corruption effect - subtle) -->
+    <!-- Top left glitches -->
+    <line x1="-33" y1="-36" x2="-30" y2="-36" stroke="#ff00ff" stroke-width="1" opacity="0.3"/>
+    <!-- Top right glitches -->
+    <line x1="30" y1="-36" x2="33" y2="-36" stroke="#00d4ff" stroke-width="1" opacity="0.3"/>
+    <!-- Bottom left glitches -->
+    <line x1="-33" y1="36" x2="-30" y2="36" stroke="#00d4ff" stroke-width="1" opacity="0.3"/>
+    <!-- Bottom right glitches -->
+    <line x1="30" y1="36" x2="33" y2="36" stroke="#ff00ff" stroke-width="1" opacity="0.3"/>
+    
+    <line x1="-25" y1="-15" x2="25" y2="-15" stroke="#00d4ff" stroke-width="1" opacity="0.4"/>
+    <line x1="-25" y1="15" x2="25" y2="15" stroke="#ff00ff" stroke-width="1" opacity="0.4"/>
+    
+    <!-- Plone circular device with 4 dots pattern -->
+    <!-- Outer circle (centered) -->
+    <circle cx="0" cy="0" r="10" fill="none" stroke="#00d4ff" stroke-width="2.5"/>
+    
+    <!-- Glitch circles (offset duplicates for digital corruption - subtle) -->
+    <circle cx="0.5" cy="0" r="10" fill="none" stroke="#ff00ff" stroke-width="0.8" opacity="0.15"/>
+    <circle cx="-0.3" cy="0.2" r="10" fill="none" stroke="#00d4ff" stroke-width="0.6" opacity="0.1"/>
+    
+    <!-- Inner circle (subtle, magenta) -->
+    <circle cx="0" cy="0" r="8.5" fill="none" stroke="#ff00ff" stroke-width="1" opacity="0.3"/>
+    
+    <!-- The distinctive Plone dot pattern -->
+    <!-- 2 dots on the left side (cyan, moved more to center) -->
+    <circle cx="-3" cy="-3" r="2" fill="#00d4ff" opacity="0.9"/>
+    <circle cx="-3" cy="3" r="2" fill="#00d4ff" opacity="0.9"/>
+    
+    <!-- 1 dot on the right side (cyan) -->
+    <circle cx="4" cy="0" r="2" fill="#00d4ff" opacity="0.9"/>
+    
+    <!-- CMS content elements positioned away from corner brackets -->
+    <!-- Document icon (top left, moved in from corner) -->
+    <rect x="-26" y="-26" width="12" height="16" fill="none" stroke="#ff00ff" stroke-width="1.5" rx="1"/>
+    <line x1="-24" y1="-22" x2="-16" y2="-22" stroke="#ff00ff" stroke-width="1" opacity="0.7"/>
+    <line x1="-24" y1="-19" x2="-16" y2="-19" stroke="#ff00ff" stroke-width="1" opacity="0.7"/>
+    <line x1="-24" y1="-16" x2="-16" y2="-16" stroke="#ff00ff" stroke-width="1" opacity="0.7"/>
+    <line x1="-24" y1="-13" x2="-18" y2="-13" stroke="#ff00ff" stroke-width="1" opacity="0.7"/>
+    
+    <!-- Image icon (top right, moved in from corner) -->
+    <rect x="14" y="-26" width="12" height="16" fill="none" stroke="#00d4ff" stroke-width="1.5" rx="1"/>
+    <circle cx="18" cy="-21" r="2.5" fill="none" stroke="#00d4ff" stroke-width="1" opacity="0.7"/>
+    <path d="M 14,-12 L 18,-18 L 22,-15 L 26,-20" fill="none" stroke="#00d4ff" stroke-width="1.2" opacity="0.7"/>
+    
+    <!-- File/Content icon (bottom left, moved in from corner) -->
+    <rect x="-26" y="10" width="12" height="16" fill="none" stroke="#00d4ff" stroke-width="1.5" rx="1"/>
+    <line x1="-24" y1="14" x2="-16" y2="14" stroke="#00d4ff" stroke-width="1" opacity="0.7"/>
+    <line x1="-24" y1="17" x2="-16" y2="17" stroke="#00d4ff" stroke-width="1" opacity="0.7"/>
+    <line x1="-24" y1="20" x2="-16" y2="20" stroke="#00d4ff" stroke-width="1" opacity="0.7"/>
+    <line x1="-24" y1="23" x2="-18" y2="23" stroke="#00d4ff" stroke-width="1" opacity="0.7"/>
+    
+    <!-- Folder icon (bottom right, moved in from corner) -->
+    <path d="M 14,14 L 14,10 L 19,10 L 21,12 L 26,12 L 26,26 L 14,26 Z" fill="none" stroke="#ff00ff" stroke-width="1.5" opacity="0.8"/>
+    <line x1="16" y1="16" x2="24" y2="16" stroke="#ff00ff" stroke-width="1" opacity="0.5"/>
+    <line x1="16" y1="20" x2="24" y2="20" stroke="#ff00ff" stroke-width="1" opacity="0.5"/>
+    
+    <circle cx="-28" cy="0" r="2" fill="#00d4ff" opacity="0.8"/>
+    <circle cx="28" cy="0" r="2" fill="#ff00ff" opacity="0.8"/>
+  </g>
+</svg>