resonanzband_test/readme_md
2026-03-15 12:31:25 +00:00

85 lines
No EOL
3.1 KiB
Text

# Resonanzband Test
## Überblick
Experiment **resonanzband_test** untersucht den Einfluss eines isolierten Toggles auf die Performance-Metriken des Resonanzbands in einem Cluster-Setup.
[Link zum Artikel](https://donau2space.de/tag-178-run-24-ein-toggle-verstimmt-sich-das-resonanzband-oder-bleibt-der-max-stur/)
Git Repository: [https://git.donau2space.de/Mika/resonanzband_test](https://git.donau2space.de/Mika/resonanzband_test)
### Hinweis
Alle Inhalte wurden per KI generiert.
Nutzung, Anpassung und Weiterentwicklung erfolgen eigenverantwortlich auf eigenes Risiko.
Es wird keine Korrektheit, Sicherheit, Funktionsfähigkeit oder rechtliche Eignung zugesichert.
## Inhalt des Repositories
Das Repository enthält Skripte, Datensätze und begleitende Dokumentation zum Experiment **resonanzband_test**.
### Artefakte
#### 1. Python-Skript
- **Art:** python_script
- **Ziel:** Linux Userspace
- **Sprache:** Python
- **Beschreibung:** Automatische Analyse und Visualisierung der Performance-Metriken.
- **API-Funktionen:**
- `analyze_metrics(data)` → gibt `analysis_results` zurück, führt eine Auswertung der übergebenen Messdaten durch.
- **Datenstrukturen:**
- `performance_data` (JSON) mit Feldern: `max_only_alerts`, `outlier_frequency`, `expires_at_dist_hours`, `retry_total_overhead`.
#### 2. CSV-Datensatz
- **Art:** csv_dataset
- **Ziel:** gemischt
- **Sprache:** CSV
- **Beschreibung:** Enthält Metriken der Runs #22, #23 und #24 zur Nachanalyse.
- **Datenstruktur:**
- `run_data` (Tabelle) mit Spalten: `run_id`, `max_only_alert_count`, `max_ms`, `outlier_frequency`, `expires_at_dist`, `retry_overhead`.
#### 3. Dokumentation
- **Art:** doc_only
- **Ziel:** gemischt
- **Beschreibung:** Dokumentation der Methodik, Entscheidungstabellen und Ergebnisinterpretationen.
## Installation & Nutzung
Voraussetzungen:
- Python 3.9 oder höher
- Empfohlen: virtuelles Environment
### Installation
1. Repository klonen:
```bash
git clone https://git.donau2space.de/Mika/resonanzband_test.git
cd resonanzband_test
```
2. Abhängigkeiten installieren:
```bash
pip install -r requirements.txt
```
### Nutzung
Das Skript übergibt Datensätze im CSV-Format an die Analyselogik.
Beispiel:
```bash
python analyze.py data/run_metrics.csv
```
## Typische Use-Cases
- Vergleich der Resonanzband-Performance zwischen verschiedenen Cluster-Runs.
- Identifikation von Ausreißern und Performance-Degradation durch Toggles.
- Visualisierung und Dokumentation von Analyseergebnissen.
- Basis für weiterführende Optimierungsstudien.
## Struktur & Erweiterbarkeit
Das Projekt ist modular aufgebaut:
- **/scripts**: enthält Analyseskripte
- **/data**: Datensätze der einzelnen Runs
- **/docs**: begleitende Dokumentation
Erweiterungen können durch Hinzufügen neuer Analysefunktionen oder weitere Datensatzformate erfolgen. Die API `analyze_metrics` kann zur Integration in externe Überwachungs- oder Benchmark-Tools verwendet werden.
## Lizenz
Dieses Projekt steht unter der **MIT-Lizenz**.
Alle Inhalte wurden automatisch generiert. Nutzung auf eigene Gefahr.