Wiederholungsrichtlinie

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Fehlgeschlagene Anforderungen automatisch wiederholen, wenn bei einem Schritt ein zeitweise auftretendes Problem auftritt, z. B. ein Netzwerkfehler oder eine begrenzte Anforderungsrate. Legen Sie eine Wiederholungsrichtlinie fest, um zu verhindern, dass der Schritt erneut manuell ausgelöst werden muss.

    Features

    Wiederholungsrichtlinien können sein:
    • Wird erstellt, um Verbindungszeitüberschreitungen oder fehlgeschlagene Anforderungen basierend auf Header, Status, Antworttext, Fehler und HTTP-Methode zu unterstützen.
    • Wird auf alle Aktionen angewendet, die einen bestimmten Verbindungsalias verwenden.
    • Direkt auf einen Aktionsschritt angewendet.
    Verwenden Sie Wiederholungsrichtlinien, um Folgendes zu definieren:
    • Die Bedingungen, die erfüllt sein müssen, um einen Schritt zu wiederholen.
    • Das Zeitintervall, das gewartet werden soll, bevor ein Schritt wiederholt wird.
    • Die maximale Anzahl der Wiederholungsversuche, die der Schritt vor dem Stoppen unternimmt.
    Ordnen Sie einem Alias für Verbindungen und Anmeldeinformationen eine Standardwiederholungsrichtlinie zu, und wenden Sie die Wiederholungsrichtlinie auf alle HTTP-Verbindungen an.
    Hinweis:
    Sie können Wiederholungsrichtlinien nur für JDBC-, REST- und SOAP-Schritte erstellen.

    Erstellen Sie eine Wiederholungsrichtlinie

    Fehlgeschlagene Anforderungen automatisch wiederholen, wenn bei einem Schritt ein zeitweise auftretendes Problem auftritt, z. B. ein Netzwerkfehler oder eine begrenzte Anforderungsrate. Legen Sie eine Wiederholungsrichtlinie fest, um zu verhindern, dass der Schritt erneut manuell ausgelöst werden muss.

    Vorbereitungen

    • Erforderliche Rolle: connection_admin oder Credential_admin

    Prozedur

    1. Navigieren zu Alle > IntegrationHub > Wiederholungsrichtlinie > Neu erstellen:.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular „Richtlinienwiederholung“.
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung der Wiederholungsrichtlinie.
      Verbindungstyp HTTP
      Bedingung Bedingungen, die zum Auslösen der Wiederholungsrichtlinie erfüllt sein müssen. Zu den Bedingungen, die eine Wiederholungsrichtlinie auslösen, gehören die Operatoren ist, is nicht, enthältund enthält nicht.
      Wiederholungsstrategie
      • Exponentielles Backoff: Option zum exponentiellen Erhöhen des Zeitintervalls für die nachfolgenden Wiederholungsversuche. Der Multiplikator ist 2.
      • Festes Intervall: Option zum Festlegen eines festen Zeitintervalls, nach dem ein Wiederholungsversuch unternommen werden soll.
      • Header „Retry-After“ berücksichtigen: Option zum Angeben eines Wiederholungsversuchs basierend auf dem Datums- und Uhrzeitwert, der im Headerwert „Wiederholen nach“ der HTTP-Anforderung zurückgegeben wird. Weitere Informationen zum Header finden Sie in RFC 7231, Abschnitt 7.1.3: Retry-After.
        Hinweis:
        Der Header „Retry-After“ unterstützt nur REST- und SOAP-Schritte.
      Intervall (Sekunden) Zeitintervall in Sekunden, nach dem ein Wiederholungsversuch unternommen werden soll. Dieses Feld gilt nur für die Wiederholungsstrategien „Exponentielles Backoff“ und „Festes Intervall“.
      Hinweis:
      Wenn für die WiederholungsstrategieExponentielles Backofffestgelegt ist, erhöht sich das Zeitintervall nach jedem Wiederholungsversuch exponentiell, bis die maximale Anzahl von Versuchen erreicht ist.
      Anzahl Maximale Anzahl der Wiederholungsversuche. Dieses Feld gilt nur für die Wiederholungsstrategien „Exponentielles Backoff“ und „Festes Intervall“. Wenn kein Wert angegeben ist, basiert die maximale Anzahl der Wiederholungsversuche auf dem Wert, der in der Systemeigenschaft glide.fdih.retry.max_count angegeben ist. Der Standardwert der Systemeigenschaft glide.fdih.retry.max_count ist 0. Weitere Informationen zu Systemeigenschaften finden Sie unter Verfügbare Systemeigenschaften.
      Max. verstrichene Zeit (Sekunden) Maximale kumulative Zeit in Sekunden, nach der Wiederholungsversuche beendet werden. Dieses Feld wird nur angezeigt, wenn Header „Retry-After“ berücksichtigen unter Wiederholungsstrategieausgewählt ist.
      Hinweis:
      Wenn die maximale Wiederholungszeit in der Eigenschaft glide.fdih.retry.max_time_in_seconds angegeben ist, hat der Wert der Systemeigenschaft Vorrang vor diesem Feldwert. Stellen Sie außerdem sicher, dass die maximal verstrichene Zeit größer oder gleich dem Wert der Systemeigenschaft ist.
    3. Wahlweise: Erstellen Sie eine globale Systemeigenschaft mit den folgenden Attributen.
      Weitere Informationen zum Erstellen einer Eigenschaft finden Sie unter Systemeigenschaft hinzufügen. Mit dieser Systemeigenschaft können Sie die maximale Zeit in Sekunden für eine Wiederholungsrichtlinie angeben.
      Feld Wert
      Name glide.fdih.retry.max_time_in_seconds
      Typ ganze Zahl
      Wert Standardwert: 86400 (Sekunden) Max. unterstützte Zeit: 604800 (Sekunden)
    4. Klicken Sie auf Absenden.

    Wiederholungsrichtlinie mit Wiederholungsstrategie als exponentielles Backoff

    Abbildung : 1. Beispiel für eine Wiederholungsrichtlinie
    Beispiel für eine Wiederholungsrichtlinie, wenn „Wiederholungsstrategie“ auf „Exponentielles Backoff“festgelegt ist
    In diesem Beispiel ist die Richtlinie so definiert, dass sie versucht, es erneut zu versuchen, wenn eine der folgenden Bedingungen erfüllt ist:
    • „HTTP-Methode“ ist „GET“, und der Fehler ist „Verbindungszeitüberschreitung“.
    • HTTP-Methode ist GET und Statuscode ist 429
    Wenn die Bedingung erfüllt ist, werden maximal dreimal Wiederholungsversuche unternommen. Das Zeitintervall zwischen den Wiederholungsversuchen wird exponentiell erhöht. Die Zeitintervalle in diesem Beispiel betragen 10 Sekunden, 20 Sekunden und 40 Sekunden.

    Nächste Maßnahme

    • Erstellen Sie einen Alias für Verbindungen und Anmeldeinformationen, wenn Sie nicht über den erforderlichen Alias verfügen.
    • Weisen Sie die Wiederholungsrichtlinie als Standard-Wiederholungsrichtlinie dem erforderlichen Alias für Verbindungen und Anmeldeinformationen zu.
      Hinweis:
      Eine standardmäßige Wiederholungsrichtlinie wird bereitgestellt und als Standard-Wiederholungsrichtlinieausgewählt. Wenn Sie Wiederholungsrichtlinien erstellt haben, können Sie die erforderliche Richtlinie als Standard-Wiederholungsrichtlinieauswählen.
    • Erstellen Sie eine HTTP(s)-Verbindung in der zugehörigen Liste „Verbindungen“ für den Alias „Verbindung und Anmeldeinformationen“. Weitere Informationen finden Sie unter Verbindungen und Anmeldeinformationen.
    • Überprüfen Sie die Details der Wiederholungsversuche, und zeigen Sie sie an, indem Sie zu navigieren Systemprotokolle > Ausgehende HTTP-Anforderungen.