# Gesundheit und Überwachung

Wie Formstep Integrationen überwacht, Tokens erneuert und Fehler anzeigt.

## Gesundheit und Überwachung

Formstep hält deine Integrationen im Hintergrund am Laufen — erneuert Tokens, bevor sie ablaufen, pausiert bei Problemen und zeigt dir genau, was passiert ist, damit du es schnell beheben kannst.

<h2 id="proactive-token-refresh">Proaktive Token-Erneuerung</h2>

<p>
  Ein täglicher Hintergrundjob prüft die OAuth-Verbindungen in deinem Workspace, einschließlich Cal.com. Wenn ein Token innerhalb der
  nächsten 24 Stunden abläuft, erneuert Formstep ihn automatisch — du musst nichts tun.
</p>

<p>
  Das gilt für Google, Slack, Linear, Airtable und Cal.com. Notion- und GitHub-Tokens laufen nicht ab und werden daher übersprungen.
  Discord-Tokens laufen nach etwa 7 Tagen ab und werden bei Bedarf direkt vor jeder Zustellung erneuert statt durch den täglichen Job.
</p>

<p>
  Schlägt eine Erneuerung fehl — zum Beispiel, weil die Verbindung beim Anbieter widerrufen wurde —, markiert Formstep die Verbindung als
  abgelaufen und versetzt jede Integration, die sie nutzt, in einen Fehlerzustand. Du siehst eine Warnung bei jeder betroffenen Integration
  und erhältst eine Benachrichtigungs-E-Mail.
</p>

<h2 id="health-states">Gesundheitszustände</h2>

<p>
  Jede Integrationskarte trägt ein Statusabzeichen, und das Öffnen der Integration zeigt ein Banner, das erklärt, was zu tun ist. Das
  Abzeichen zeigt <strong>Aktiv</strong>, <strong>Pausiert</strong> oder <strong>Zustellungsfehler</strong>; das Banner ist genauer.
</p>

<p>
  Verbindungsprobleme haben immer Vorrang. Wenn ein Token abgelaufen ist, behebt das erneute Verbinden alle Integrationen, die dieses Konto
  teilen, auf einmal — du musst dich nicht um jede einzeln kümmern.
</p>

<h2 id="error-indicators">Fehleranzeigen</h2>

<p>Wenn etwas schiefgeht, zeigt Formstep es an zwei Stellen:</p>

<ul>
  <li>
    <strong>Integrationskarte</strong> — die Karte zeigt ein Statusabzeichen und einen farbigen Rahmen: orange bei einem Verbindungsproblem,
    rot bei einem Zustellungsfehler. Wenn die Verbindung abgelaufen ist, erscheint direkt auf der Karte eine Schaltfläche{' '}
    <strong>Erneut verbinden</strong>.
  </li>
  <li>
    <strong>Detailbereich</strong> — öffne die Integration, um ein Banner zu sehen, das benennt, was passiert ist und wie du es behebst.
  </li>
</ul>

<h2 id="auto-pause">Automatische Pausierung nach wiederholten Fehlern</h2>

<p>
  Schlägt eine Integration 5 Mal in Folge fehl, pausiert Formstep sie, damit ein defektes Ziel nicht weiter Zustellungen verbrennen kann.
  Ein Authentifizierungs-, Berechtigungs- oder Nicht-gefunden-Fehler überspringt den Zähler und stoppt die Integration sofort, weil ein
  Wiederholungsversuch das Problem nicht beheben kann.
</p>

<p>
  So oder so geht eine E-Mail an die Person, die die Integration eingerichtet hat — oder an die Workspace-Inhaberin oder den
  Workspace-Inhaber, wenn diese Adresse nicht verfügbar ist. Sie wird höchstens einmal pro Integration alle 24 Stunden gesendet, sodass ein
  einzelnes defektes Ziel dein Postfach nicht überfluten kann.
</p>

<p>Behebe das zugrunde liegende Problem und drücke dann Fortsetzen. Die Zustellung setzt bei der nächsten neuen Einreichung fort.</p>

<h2 id="event-log">Ereignisprotokoll</h2>

<p>
  Jede Integration listet ihre letzten 20 Ereignisse unter <strong>Letzte Ereignisse</strong> auf — Zustellungen, Verbindungstests und
  Backfill-Exporte, jeweils als erfolgreich oder fehlgeschlagen markiert. Ein fehlgeschlagener Eintrag zeigt die eigene Fehlermeldung des
  Ziels, sodass ein Notion-Validierungsfehler genau so klingt, wie Notion ihn formuliert hat. Ein fehlgeschlagener Backfill erhält außerdem
  eine Schaltfläche <strong>Erneut versuchen</strong>, die den Export neu startet.
</p>

<h2 id="failed-deliveries">Fehlgeschlagene Zustellungen und Wiederholungsversuche</h2>

<p>
  Jede Zustellung erhält bis zu 5 Versuche, mit mindestens 1, 2, 4 und 8 Minuten Wartezeit dazwischen, oder länger, wenn das Ziel über einen{' '}
  <code>Retry-After</code>-Header mehr Zeit verlangt. Formstep sucht alle 30 Minuten nach fälligen Wiederholungen, sodass jede Wiederholung
  bis zu einer halben Stunde später kommen kann und der letzte Versuch etwa zwei Stunden nach dem ersten erfolgt.
</p>

<p>
  Einreichungen, die alle 5 Versuche aufgebraucht haben, werden in einem Banner oben in der Integration gezählt: „3 Einreichungen konnten
  nicht zugestellt werden". <strong>Alle erneut versuchen</strong> reiht jede von ihnen erneut ein und aktiviert die Integration wieder,
  falls sie pausiert war oder einen Fehler hatte. Das Banner ist ausgeblendet, wenn nichts fehlgeschlagen ist.
</p>

> ℹ️ **Analytics-Ziele sind separat**
> <p>
>     Alles auf dieser Seite betrifft Einreichungs-Integrationen. Die Weiterleitung von Analytics-Ereignissen ist Best-Effort und wird nie
>     wiederholt, und das Streamen von Axiom-Antworten stoppt von selbst nach 20 aufeinanderfolgenden Fehlern. Siehe{' '}
>     <a href="/de/integrations/analytics-streaming">Analytics-Streaming</a>.
>   </p>

<h2 id="reconnecting">Abgelaufene Zugangsdaten neu verbinden</h2>

<p>
  Wenn eine Verbindung abläuft, klicke auf <strong>Erneut verbinden</strong> auf der Integrationskarte oder im Detailbereich. Dadurch wird
  der OAuth-Ablauf mit demselben Anbieter erneut durchgeführt. Nach der Autorisierung werden die Zugangsdaten wiederhergestellt, und alle
  Integrationen, die dieses Konto verwenden, setzen automatisch fort.
</p>

<p>Du kannst im Detailbereich auch zu einem anderen verbundenen Konto wechseln, falls das ursprüngliche Konto nicht mehr verfügbar ist.</p>

<h2 id="faq">FAQ</h2>

  <p>
    Einmal täglich. Tokens, die innerhalb von 24 Stunden ablaufen, werden automatisch erneuert. Wenn du früher ein Problem vermutest, öffne
    den Integrationsdetailbereich — der Gesundheitszustand aktualisiert sich in Echtzeit anhand der Zustellungsergebnisse.
  </p>

  <p>
    Nein. Einreichungen werden unabhängig vom Integrationsstatus immer in Formstep gespeichert. Fehlgeschlagene Zustellungen werden in eine
    Warteschlange gestellt und können im Detailbereich erneut versucht werden, sobald das Problem behoben ist.
  </p>

  <p>
    Formstep erneuert Tokens proaktiv, sodass du es in den meisten Fällen nicht bemerkst. Schlägt die Erneuerung fehl, erhältst du sofort
    eine E-Mail-Benachrichtigung — meist bevor der Token tatsächlich abläuft.
  </p>

  <p>
    Die Integration wechselt zum neuen Konto. Stelle sicher, dass das neue Konto Zugriff auf dasselbe Ziel hat (Tabelle, Datenbank, Kanal).
    Wenn das Ziel im neuen Konto nicht existiert, musst du die Integrationseinstellungen aktualisieren.
  </p>

<h2 id="next-steps">Nächste Schritte</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Google Sheets](/de/integrations/google-sheets) — Einreichungen automatisch in eine Tabelle synchronisieren
  - [Slack](/de/integrations/slack) — Einreichungen an einen Slack-Kanal senden
  - [Webhooks](/de/integrations/webhooks) — Signiertes JSON per POST an eine beliebige URL senden
  - [Notion](/de/integrations/notion) — Einreichungen in eine Notion-Datenbank übertragen
</div>
