Diagnose-Report erstellen

Wenn der Support tiefere Einblicke braucht: Diagnose-Report als Textdatei herunterladen und anhängen.

Wichtig zum Umgang mit der Datei: Der Report enthält trotz Schwärzungen noch sensible Informationen - Telefonnummern aus deinen Anruflisten, teilweise IP-Adressen aus deinem Netzwerk und Konfigurations-Details der Anlage. Schick die Datei nur direkt an info@franzfon.de oder hänge sie an dein Ticket im Portal an. Bitte nicht in öffentliche Foren, Chat-Gruppen oder Cloud-Speicher hochladen.

Wann brauchst du einen Diagnose-Report?

Wenn du ein Problem mit FRANZFON hast, das du nicht selbst über die System-Diagnose & Reparatur lösen kannst, brauchen wir oft tiefere Einblicke in die TK-Anlage. Der Diagnose-Report bündelt alles für die Fehleranalyse in einer einzigen Textdatei.

Typische Fälle:

  • Eingehende Anrufe kommen sporadisch nicht durch
  • Mobile-App verbindet sich nicht (trotz scheinbar normaler Konfiguration)
  • Audio-Probleme, die in Kein Audio nicht aufgelöst werden
  • Unerklärliche Verbindungsabbrüche

Statt SSH-Zugriff zu brauchen - den wir bewusst nicht öffnen, auch nicht für Beta-Tester - exportierst du den Report selbst und schickst ihn uns.

So erstellst du den Report

  1. In der Weboberfläche deiner Anlage im Menü Hilfe öffnen
  2. Die Karte Diagnose-Report suchen (nur für Admins sichtbar)
  3. Auf den Button Report erstellen klicken
  4. Die Anlage stellt die Datei zusammen, das kann ein paar Sekunden dauern
  5. Dein Browser lädt die .txt-Datei herunter
  6. Häng die Datei an dein Ticket im Portal

Dateiname-Format: support_report_YYYYMMDD_HHMMSS_xxxxxx.txt (Beispiel: support_report_20260508_111530_a1b2c3.txt)

Es ist eine einzelne Textdatei, kein ZIP-Archiv. Die Inhalte sind durch Sub-Header strukturiert (z.B. === Asterisk-Status ===, === Backend-Logs ===).

Was ist im Report drin?

Eine Textdatei mit folgenden Abschnitten:

AbschnittInhalt
System-InfoFRANZFON-Wizard-Version, OS-Build, Hostname, Uptime
Setup-Standwelche Wizard-Schritte abgeschlossen wurden, ob setup_complete gesetzt ist
FritzBox-StatusTR-064-Verbindung, registrierte FRANZFON-Telefoniegeräte
Asterisk-StatusTrunk-Registrierungen, aktive Channels, PJSIP-Endpoint-Stand
Konfigurationenaktuelle Asterisk-Konfig-Dateien (Trunk, Extensions, Dialplan)
NetzwerkIP-Adressen, Routing, DNS, Ping-Ergebnisse
Logsim Standardmodus die letzten Warning- und Error-Zeilen; mit Vollständigen-Logs-Option die letzten ca. 300 Zeilen des Asterisk-Volllogs plus Backend-Log

Größenordnung:

  • Standard-Report: typisch <500 KB
  • Mit Vollständigen Logs: bis ca. 2 MB, in Extremfällen bis 5 MB

Passt locker in das 10-MB-Upload-Limit für Issue-Anhänge.

Datenschutz - was geschwärzt oder gar nicht enthalten ist

Der Report ist so gebaut, dass keine sensiblen Daten im Klartext durchrutschen:

  • SIP-Passwörter (für Telefon-Trunks und FritzBox-Verbindung) werden überall durch ***REDACTED*** ersetzt
  • FritzBox-Zugangsdaten: das Passwort wird gar nicht erst in den Report geschrieben, der Benutzername nur teilweise (erste 3 Zeichen)
  • API-Tokens, Session-Cookies, Authorization-Header werden geschwärzt
  • TOTP- und 2FA-Codes werden geschwärzt
  • Keine Audio-Aufnahmen, keine Voicemail-Inhalte im Report
  • IP-Adressen in Logs sind teilweise maskiert (nur das letzte Oktett wird gezeigt)
  • Keine personenbezogenen Daten außer Telefonnummern, die für die Diagnose von Anruf-Routing nötig sind

Du kannst den Report bei Bedarf vor dem Versand selbst noch durchsehen - es ist eine reine Textdatei und in jedem Editor lesbar.

Wo soll ich den Report hinschicken?

Bei einem aktiven Issue im Beta-Portal:

  • Bestehendes Issue öffnen
  • Den Report im Antwort-Feld als Anhang dranhängen (“Datei anhängen”-Button)
  • Maximal 10 MB pro Datei

Per E-Mail (für Nicht-Beta-Tester oder dringende Fälle):

  • An info@franzfon.de
  • Betreff: kurze Beschreibung des Problems
  • Im Mail-Body: was du erwartet hast, was tatsächlich passiert ist, wann das Problem auftrat
  • Den Diagnose-Report im Anhang

Tipps für eine schnelle Antwort

Je präziser du das Problem beschreibst, desto schneller können wir helfen:

  • Wann hat das Problem angefangen? (gerade jetzt, seit gestern, seit dem letzten Update?)
  • Tritt es bei jedem Anruf auf oder nur manchmal?
  • Welche Geräte/Apps sind betroffen? (alle Mobile-Apps, nur ein bestimmtes Telefon, nur Anrufe von extern?)
  • Was hast du schon probiert? (z.B. “Telefonanlage neu laden” über die System-Diagnose)
  • Ungefährer Zeitpunkt eines konkreten Beispiel-Anrufs (Datum + Uhrzeit, dann finden wir den Eintrag im Log schneller)

Zuletzt aktualisiert: · Autor: IAP-IT, Viktor Weizel

Artikel hat nicht geholfen? Schreib uns.