Ein Problem untersuchen
=======================

Dieser Einstieg hilft, ein Problem zunächst der richtigen Ebene zuzuordnen
und anschließend reproduzierbar einzugrenzen.

1. Sicherheit herstellen
------------------------

Bei unerwartetem HF-Pegel, fehlender Verstärkerbegrenzung oder nicht
erreichbarem RF-Off wird die Messung kontrolliert beendet. Untersuchen Sie
die Ursache erst bei abgeschalteter HF und deaktivieren Sie dafür keine
Schutzfunktion.

2. Symptom zuordnen
-------------------

Die :doc:`Fehlersuche <../help/troubleshooting>` behandelt direkt:

* fehlende DOT-, INI- und DAT-Dateien;
* ungültige Conditions und mehrdeutige Signalpfade;
* VISA-, GPIB- und Prologix-Probleme;
* scheinbar blockierende Messungen;
* Autosave und Resume;
* Qt- und Sphinx-Fehler in CI.

3. Konfiguration oder Code prüfen
---------------------------------

Nutzen Sie :doc:`Konfigurationsvalidierung
<../configuration/validation>`, wenn der Fehler vor dem eigentlichen
Messwert entsteht. Der :doc:`Testleitfaden <../framework/testing>` hilft bei
Fehlern in Algorithmen, Geräteschnittstellen, virtuellen Abläufen, Safety,
Resume oder UI-Threads.

4. Fehler reproduzierbar beschreiben
------------------------------------

Halten Sie Versionen, Betriebssystem, VISA-Backend, Skript, ``conf.py``,
letzte Logzeilen und den betroffenen Messbereich fest. Geben Sie außerdem an,
ob der entsprechende virtuelle Lauf funktioniert. Zugangsdaten und
vertrauliche Geräteadressen werden dabei nicht weitergegeben.

Ausnahmen und öffentliche Methoden können in der
:doc:`API-Referenz <../../api/index>` nachgeschlagen werden.