Wie funktionieren Auftragskonfigurationen

Sie können angeben, wie schnell die Ziele über eine ausstehende Auftragsausführung benachrichtigt werden. Sie können auch ein gestaffeltes Rollout erstellen, um Updates, Neustarts und andere Vorgänge zu verwalten. Um festzulegen, wie Ihre Ziele benachrichtigt werden, verwenden Sie die Auftrags-Rollout-Raten.

Auftragsrolloutraten

Sie können eine Rollout-Konfiguration erstellen, indem Sie entweder eine konstante Rollout-Rate oder eine exponentielle Rollout-Rate verwenden. Verwenden Sie eine konstante Rollout-Rate, um die maximale Anzahl von Auftragszielen festzulegen, die pro Minute informiert werden sollen.

AWS IoT Jobs können mit exponentiellen Rollout-Raten bereitgestellt werden, wenn verschiedene Kriterien und Schwellenwerte erfüllt werden. Wenn die Anzahl der fehlgeschlagenen Aufträge einer Reihe von Kriterien entspricht, die Sie angeben, können Sie den Auftrags-Rollout abbrechen. Sie legen die Kriterien für die Auftrags-Rollout-Rate fest, wenn Sie mithilfe des JobExecutionsRolloutConfig-Objekts einen Auftrag erstellen. Sie legen auch die Kriterien für den Auftragsabbruch bei der Auftragserstellung fest, indem Sie das AbortConfig-Objekt verwenden.

Das folgende Beispiel zeigt, wie die Rollout-Raten funktionieren. Beispielsweise würde ein Auftrags-Rollout mit einer Basisrate von 50 pro Minute, einem Inkrementfaktor von 2 und einer Anzahl von jeweils 1.000 Geräten, die benachrichtigt und erfolgreich waren, wie folgt funktionieren: Der Auftrag beginnt mit einer Geschwindigkeit von 50 Auftragsausführungen pro Minute und wird mit dieser Geschwindigkeit fortgesetzt, bis entweder 1.000 Objekte Benachrichtigungen zur Auftragsausführung erhalten haben oder 1.000 erfolgreiche Auftragsausführungen stattgefunden haben.

Die folgende Tabelle zeigt, wie der Rollout über die ersten vier Inkremente verläuft.

Auftrags-Rollout-Raten für kontinuierliche Aufträge mit dynamischen Objektgruppen

Wenn Sie einen kontinuierlichen Job verwenden, um Fernoperationen in Ihrer Flotte einzuführen, führt AWS IoT Jobs die Ausführung von Jobs für Geräte in Ihrer Zielgruppe durch. Bei neuen Geräten, die der dynamischen Objektgruppe hinzugefügt werden, werden diese Auftragsausführungen auch nach der Erstellung des Auftrags weiterhin auf diesen Geräten ausgeführt.

Mit der Rollout-Konfiguration können die Rollout-Raten nur für Geräte gesteuert werden, die der Gruppe hinzugefügt werden, bis der Auftrag erstellt wird. Nachdem ein Auftrag erstellt wurde, werden die Auftragsausführungen für alle neuen Geräte nahezu in Echtzeit erstellt, sobald die Geräte der Zielgruppe beitreten.

Sie können einen kontinuierlichen Auftrag oder einen Snapshot-Auftrag bis zu einem Jahr im Voraus planen und dabei eine vorher festgelegte Startzeit, Endzeit und ein Endverhalten angeben, was mit jeder Auftragsausführung nach Erreichen der Endzeit geschehen soll. Darüber hinaus können Sie ein optionales wiederkehrendes Wartungsfenster mit flexibler Häufigkeit, Startzeit und Dauer für fortlaufende Aufträge einrichten, um ein Auftragsdokument auf allen Geräten innerhalb der Zielgruppe bereitzustellen.

Konfigurationen für die Auftragsplanung

Startzeit

Die Startzeit eines geplanten Auftrags ist das zukünftige Datum und die Uhrzeit, zu der der Auftrag mit der Bereitstellung des Auftragsdokuments auf allen Geräten in der Zielgruppe beginnt. Die Startzeit für einen geplanten Auftrag gilt für fortlaufende Aufträge und Snapshot-Aufträge. Wenn ein geplanter Auftrag zum ersten Mal erstellt wird, behält er den Status SCHEDULED. Sobald das von Ihnen gewählte startTime erreicht ist, wird es aktualisiert auf IN_PROGRESS und der Rollout des Auftragsdokuments wird gestartet. Der Zeitraum zwischen dem ursprünglichen Datum und der Uhrzeit, zu der Sie den geplanten Auftrag erstellt haben, startTime darf nicht länger als ein Jahr sein.

Weitere Informationen zur Syntax startTime bei der Verwendung eines API-Befehls oder des AWS CLI finden Sie unter Timestamp.

Bei einem Auftrag mit der optionalen Planungskonfiguration, der während eines wiederkehrenden Wartungsfensters an einem Ort mit Sommerzeit ausgeführt wird, ändert sich die Uhrzeit um eine Stunde, wenn von Sommerzeit auf Normalzeit und von Normalzeit auf Sommerzeit umgestellt wird.

Endzeit

Die Endzeit eines geplanten Auftrags ist das zukünftige Datum und die Uhrzeit, zu der der Auftrag das Rollout des Auftragsdokuments an alle verbleibenden Geräte in der Zielgruppe beendet. Die Endzeit für einen geplanten Auftrag gilt für fortlaufende Aufträge und Snapshot-Aufträge. Wenn ein geplanter Auftrag beim ausgewählten endTime eintrifft und alle Auftragsausführungen einen Terminal-Zustand erreicht haben, wird sein Status von IN_PROGRESS auf COMPLETED aktualisiert. Der Zeitraum zwischen dem ursprünglichen Datum und der Uhrzeit, zu der Sie den geplanten Auftrag erstellt haben, endTime darf nicht länger als ein Jahr sein. Die Mindestdauer zwischen startTime und endTime beträgt 30 Minuten. Wiederholungsversuche bei der Auftragsausführung werden durchgeführt, bis der Auftrag den endTime erreicht, dann bestimmt der endBehavior, wie weiter vorzugehen ist.

Weitere Informationen zur Syntax endTime bei der Verwendung eines API-Befehls oder des AWS CLI finden Sie unter Timestamp.

Bei einem Auftrag mit der optionalen Planungskonfiguration, der während eines wiederkehrenden Wartungsfensters an einem Ort mit Sommerzeit ausgeführt wird, ändert sich die Uhrzeit um eine Stunde, wenn von Sommerzeit auf Normalzeit und von Normalzeit auf Sommerzeit umgestellt wird.

Verhalten beenden

Das Endverhalten eines geplanten Auftrags bestimmt, was mit dem Auftrag und allen noch nicht abgeschlossenen Auftragsausführungen passiert, wenn der Auftrag den ausgewählten endTime erreicht.

Im Folgenden sind die Endverhaltensweisen aufgeführt, aus denen Sie bei der Erstellung des Auftrags oder der Auftragsvorlage wählen können:

Max. Dauer

Die Höchstdauer eines geplanten Auftrags muss unabhängig von startTime und endTime unter zwei Jahren liegen.

In der folgenden Tabelle sind die häufigsten Dauerszenarien für einen geplanten Auftrag aufgeführt:

Wiederkehrendes Wartungsfenster

Das Wartungsfenster ist eine optionale Konfiguration innerhalb der Planungskonfiguration der APIs AWS Management Console und SchedulingConfig innerhalb der CreateJobTemplate APIs CreateJob und. Sie können ein wiederkehrendes Wartungsfenster mit einer festgelegten Startzeit, Dauer und Häufigkeit (täglich, wöchentlich oder monatlich) einrichten. Wartungsfenster gelten nur für fortlaufende Aufträge. Die maximale Dauer eines wiederkehrenden Wartungsfensters beträgt 23 Stunden und 50 Minuten.

Das folgende Diagramm zeigt den Status der Aufträge für verschiedene geplante Auftragsszenarien mit einem optionalen Wartungsfenster:

Weitere Informationen zu Auftragsstatus finden Sie unter Aufträge und Status der Auftragsausführung.

Cron-Ausdrücke

Bei geplanten Aufträgen, bei denen das Auftragsdokument während eines Wartungsfensters mit einer benutzerdefinierten Häufigkeit ausgeführt wird, wird die benutzerdefinierte Häufigkeit mithilfe eines Cron-Ausdrucks eingegeben. Ein Cron-Ausdruck verfügt über sechs Pflichtfelder, die durch Leerzeichen voneinander getrennt sind.

Syntax

cron(fields)

Beispiele

Wenn Sie einen Cron-Ausdruck für ein wiederkehrendes Wartungsfenster verwenden, können Sie sich auf die folgenden Beispiele für startTime beziehen.

Logik für die Dauer des wiederkehrenden Wartungsfensters

Wenn ein Auftrags-Rollout während eines Wartungsfensters das Ende des aktuellen Wartungsfensters erreicht, werden die folgenden Aktionen ausgeführt:

Verwenden Sie diese Konfiguration, um Kriterien für das Abbrechen eines Auftrags zu erstellen, wenn ein bestimmter Prozentsatz von Geräten diese Kriterien erfüllt. Mit dieser Konfiguration können Sie beispielsweise einen Auftrag in den folgenden Fällen stornieren:

Sie können mithilfe der AWS IoT Konsole oder der Jobs-API eine Abbruchbedingung für einen AWS IoT Job einrichten.

Verwenden Sie die Konfiguration für die Zeitüberschreitung bei der Auftragsausführung, um Sie zu benachrichtigen, wenn ein Auftrag für einen unerwartet langen Zeitraum im Status IN_PROGRESS stecken bleibt. Wenn der Auftrag IN_PROGRESS ist, können Sie den Fortschritt Ihrer Auftragsausführung überwachen.

Timer für Auftrags-Timeouts

Es gibt zwei Arten von Timern: Timer für „In Bearbeitung“ und Timer für „Schritt“.

Fortschrittstimer

Wenn Sie einen Auftrag oder eine Auftragsvorlage erstellen, können Sie einen Wert für den Timer in Bearbeitung angeben, der zwischen 1 Minute und 7 Tagen liegt. Sie können den Wert dieses Timers bis zum Start der Auftragsausführung aktualisieren. Nachdem Ihr Timer gestartet wurde, kann er nicht mehr aktualisiert werden, und der Timerwert gilt für alle Auftragsausführungen für den Auftrag. Immer wenn eine Auftragsausführung länger als dieses Intervall im IN_PROGRESS Status verbleibt, schlägt die Auftragsausführung fehl und wechselt in den TIMED_OUT Terminalstatus. AWS IoT veröffentlicht auch eine MQTT-Benachrichtigung.

Schritt-Timer

Sie können auch einen Schritt-Timer festlegen, der nur für die Auftragsausführung gilt, die Sie aktualisieren möchten. Dieser Timer hat keine Auswirklungen auf den Timer, der gerade bearbeitet wird. Jedes Mal, wenn Sie eine Auftragsausführung aktualisieren, können Sie einen neuen Wert für den Schritt-Timer festlegen. Sie können auch einen neuen Schritt-Timer erstellen, wenn Sie die nächste ausstehende Auftragsausführung für ein Objekt starten. Falls die Auftragsausführung länger als das Schritt-Timer-Intervall im Status IN_PROGRESS bleibt, schlägt sie fehl und wechselt in den terminalen Status TIMED_OUT.

So funktionieren Timer für Auftrags-Timeouts

Nachfolgend sehen Sie, wie die Zeitüberschreitungen während eines 20-minütigen Zeitlimits und die Schrittzeitüberschreitungen miteinander interagieren.

Im Folgenden werden die einzelnen Schritte erläutert:

Sie können die Wiederholungskonfiguration verwenden, um die Ausführung des Auftrags erneut zu versuchen, wenn bestimmte Kriterien erfüllt sind. Ein Wiederholungsversuch kann versucht werden, wenn bei einem Auftrag das Timeout überschritten wird oder wenn das Gerät ausfällt. Um die Ausführung aufgrund eines Timeout-Fehlers erneut zu versuchen, müssen Sie die Timeout-Konfiguration aktivieren.

Wie man Konfiguration wiederholen verwendet

Führen Sie die folgenden Schritte aus, um die Konfiguration zu wiederholen:

Versuchen Sie es erneut und brechen Sie die Konfiguration ab

Für jeden erneuten Versuch fallen zusätzliche Kosten für Sie an. AWS-Konto Um zu vermeiden, dass zusätzliche Gebühren aufgrund wiederholter Wiederholungsversuche anfallen, empfehlen wir, eine Abbruchkonfiguration hinzuzufügen. Weitere Informationen zu Preisen finden Sie unter AWS IoT Device Management Preise.

Es kann vorkommen, dass mehrere Wiederholungsversuche fehlschlagen, wenn bei einem hohen Prozentsatz Ihrer Geräte ein Timeout auftritt oder ein Fehler gemeldet wird. In diesem Fall können Sie die Abbruchkonfiguration verwenden, um den Auftrag abzubrechen und so zu vermeiden, dass Aufträge in der Warteschlange ausgeführt oder weitere Versuche wiederholt werden.

Bevor Sie eine fehlgeschlagene Auftragsausführung erneut versuchen, empfehlen wir Ihnen außerdem, zu überprüfen, ob die fehlgeschlagene Auftragsausführung erneut versucht werden kann, wie im folgenden Abschnitt beschrieben.

Wiederholungsversuch bei Fehlerart FAILED

Um Wiederholungsversuche für den Fehlertyp FAILED zu versuchen, müssen Ihre Geräte so programmiert sein, dass sie den FAILURE.Status einer fehlgeschlagenen Auftragsausführung an AWS IoT melden. Legen Sie die Wiederholungskonfiguration mit den Kriterien fest, nach denen die FAILED Auftragsausführung wiederholt werden soll, und geben Sie die Anzahl der auszuführenden Wiederholungen an. Wenn AWS IoT Jobs den FAILURE Status erkennt, wird automatisch versucht, die Auftragsausführung für das Gerät erneut zu versuchen. Die Wiederholungsversuche werden fortgesetzt, bis die Auftragsausführung erfolgreich ist oder die maximale Anzahl von Wiederholungsversuchen erreicht ist.

Sie können jeden Wiederholungsversuch und den Auftrag, der auf diesen Geräten ausgeführt wird, verfolgen. Indem Sie den Ausführungsstatus verfolgen, können Sie nach der angegebenen Anzahl von Wiederholungsversuchen Ihr Gerät verwenden, um Fehler zu melden und einen weiteren Wiederholungsversuch einzuleiten.

Fehler, die wiederholt werden können und die nicht wiederholt werden können

Ihr Fehler bei der Auftragsausführung kann wiederholt oder nicht wiederholt werden. Für jeden Wiederholungsversuch können Gebühren für Ihr AWS-Konto anfallen. Um zu vermeiden, dass bei mehreren Wiederholungsversuchen zusätzliche Gebühren anfallen, sollten Sie zunächst prüfen, ob Ihr Fehler bei der Auftragsausführung erneut versucht werden kann. Ein Beispiel für einen erneuten Versuch ist ein Verbindungsfehler, der auf Ihrem Gerät auftritt, wenn versucht wird, das Auftragsdokument von einer Amazon S3-URL herunterzuladen. Wenn Ihr Fehler bei der Auftragsausführung erneut versucht werden kann, programmieren Sie Ihr Gerät so, dass es einen FAILURE-Status meldet, falls die Auftragsausführung fehlschlägt. Stellen Sie dann die Wiederholungskonfiguration so ein, dass FAILED-Ausführungen erneut versucht werden.

Wenn die Ausführung nicht erneut versucht werden kann, empfehlen wir, das Gerät so zu programmieren, dass es einen REJECTED-Status an AWS IoT meldet, um einen erneuten Versuch zu vermeiden und Ihrem Konto möglicherweise zusätzliche Gebühren aufzuerlegen. Ein Fehler, der nicht wiederholt werden kann, ist zum Beispiel, wenn Ihr Gerät keine Auftragsaktualisierung empfangen kann oder wenn bei der Ausführung eines Auftrags ein Speicherfehler auftritt. In diesen Fällen versucht AWS IoT Jobs die Auftragsausführung nicht erneut, da Jobs die Ausführung des Jobs nur dann wiederholt, wenn der Status oder erkannt wird. FAILED TIMED_OUT

Wenn Sie festgestellt haben, dass ein Fehler bei der Auftragsausführung erneut versucht werden kann, sollten Sie die Geräteprotokolle überprüfen, falls ein erneuter Versuch immer noch fehlschlägt.

Wiederholungsversuch bei Fehlerart TIMEOUT

Wenn Sie bei der Erstellung eines Jobs das Timeout aktivieren, versucht AWS IoT Jobs, die Auftragsausführung für das Gerät erneut zu versuchen, wenn der Status von zu wechselt. IN_PROGRESS TIMED_OUT Diese Statusänderung kann auftreten, wenn für den Timer in Bearbeitung eine Zeitüberschreitung eintritt oder wenn ein von Ihnen festgelegter Schritt-Timer in IN_PROGRESS ist und dann das Zeitlimit überschritten wird. Die Wiederholungsversuche werden fortgesetzt, bis die Auftragsausführung erfolgreich ist oder bis die maximale Anzahl von Wiederholungsversuchen für diesen Fehlertyp erreicht ist.

Fortlaufende Aktualisierungen von Aufträgen und Mitgliedschaften in Objektgruppen

Bei kontinuierlichen Aufträgen mit dem Auftragsstatus IN_PROGRESS wird die Anzahl der Wiederholungsversuche auf Null zurückgesetzt, wenn die Gruppenmitgliedschaft eines Objekts aktualisiert wird. Nehmen wir beispielsweise an, Sie haben fünf Wiederholungsversuche angegeben und drei Wiederholungsversuche wurden bereits durchgeführt. Wenn ein Ding jetzt aus der Objektgruppe entfernt wird und dann wieder der Gruppe beitritt, z. B. bei dynamischen Objektgruppen, wird die Anzahl der Wiederholungsversuche auf Null zurückgesetzt. Sie können jetzt fünf Wiederholungsversuche für Ihre Objektgruppe durchführen, anstatt der beiden verbleibenden Versuche. Wenn ein Objekt aus der Objektgruppe entfernt wird, werden außerdem weitere Wiederholungsversuche abgebrochen.