Wiederholungsrichtlinie

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

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

    Features

    Wiederholungsrichtlinien können sein:
    • 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 von Wiederholungsversuchen, die der Schritt vor dem Stoppen durchführt.
    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

    Wiederholen Sie fehlgeschlagene Anforderungen automatisch, wenn bei einem Schritt ein zeitweise auftretendes Problem auftritt, z. B. ein Netzwerkfehler oder eine Anforderungsratenbegrenzung. 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 „Wiederholungsrichtlinie“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung der Wiederholungsrichtlinie.
      Verbindungstyp HTTP
      Bedingung Bedingungen, die erfüllt sein müssen, um die Wiederholungsrichtlinie auszulösen. Zu den Bedingungen, die eine Wiederholungsrichtlinie auslösen, gehören die Operatoren „ ist“, „ ist nicht“, „ enthält“ und „ 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 zur Angabe eines festen Zeitintervalls, nach dem ein Wiederholungsversuch unternommen werden soll.
      • Header „Retry-After“ berücksichtigen: Option zur Angabe eines Wiederholungsversuchs basierend auf dem Datums- und Uhrzeitwert, der im Headerwert „Retry After“ der HTTP-Anforderung zurückgegeben wird. Weitere Informationen zum Header finden Sie unter RFC 7231, Abschnitt 7.1.3: Retry-After.
        Hinweis:
        „Retry-After“-Header berücksichtigen 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 die Wiederholungsstrategie auf Exponentielles Backofffestgelegt ist, nimmt das Zeitintervall nach jedem Wiederholungsversuch exponentiell zu, bis die maximale Anzahl von Versuchen erreicht ist.
      Anzahl Maximale Anzahl von Wiederholungsversuchen. Dieses Feld gilt nur für die Wiederholungsstrategien „Exponentielles Backoff“ und „ Festes Intervall “. Wenn kein Wert angegeben ist, basiert die maximale Anzahl von Wiederholungsversuchen auf dem in der Systemeigenschaft glide.fdih.retry.max_count angegebenen Wert. 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 die Wiederholungsversuche gestoppt werden. Dieses Feld wird nur angezeigt, wenn Header „Retry-After“ berücksichtigenunter Wiederholungsstrategieausgewählt wird.
      Hinweis:
      Wenn die maximale Wiederholungszeit in der Eigenschaft glide.fdih.retry.max_time_in_seconds angegeben ist, hat der Systemeigenschaftswert Vorrang vor diesem Feldwert. Stellen Sie außerdem sicher, dass die maximale verstrichene Zeit gleich oder größer als der Wert der Systemeigenschaft ist.
    3. Wahlweise: Erstellen Sie eine globale Systemeigenschaft mit den folgenden Attributen.
      Weitere Informationen zum Erstellen einer Eigenschaft finden Sie unter Systemeigenschaften hinzufügen. Sie können diese Systemeigenschaft verwenden, um die maximale Zeit in Sekunden für eine Wiederholungsrichtlinie anzugeben.
      Feld Wert
      Name glide.fdih.retry.max_time_in_seconds
      Typ ganze Zahl
      Wert Standardwert: 86.400 (Sekunden) Maximal unterstützte Zeit: 604.800( 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 es erneut versucht wird, wenn eine der folgenden Bedingungen erfüllt ist:
    • HTTP-Methode ist GET und 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 Standardwiederholungsrichtlinie wird bereitgestellt und als Standardwiederholungsrichtlinieausgewählt. Wenn Sie Wiederholungsrichtlinien erstellt haben, können Sie die erforderliche Richtlinie als Standard-Wiederholungsrichtlinieauswählen.
    • Erstellen Sie in der zugehörigen Liste „Verbindungen“ eine HTTP(s)-Verbindung für den Alias für Verbindungen und Anmeldeinformationen. Weitere Informationen finden Sie unter Verbindungen und Anmeldeinformationen.
    • Überprüfen und zeigen Sie die Details der Wiederholungsversuche an, indem Sie zu navigieren Systemprotokolle > Ausgehende HTTP-Anforderungen.