Verfolgung des Fortschritts von Aufträgen

Überprüfen Sie den Auftragsfortschritt und die Details (Konsole)

Sehen Sie Metadaten exportieren (Konsole) sich Metadaten importieren (Konsole) oder an, um einen Sammelauftrag zu starten.

Übersicht über den Auftragsfortschritt in der AWS IoT SiteWise Konsole:

1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

2. Wählen Sie im Navigationsbereich die Option Massenoperationen Neu aus.

3. In der Fortschrittstabelle „Aufträge“ in der AWS IoT SiteWise Konsole wird die Liste der Aufträge für Massenvorgänge angezeigt.

4. In der Spalte Jobtyp wird beschrieben, ob es sich um einen Export- oder Importjob handelt. In den Spalten Importdatum wird das Datum angezeigt, an dem der Job gestartet wurde.

5. In der Spalte Status wird der Status des Jobs angezeigt. Sie können einen Job auswählen, um Details zu dem Job zu sehen.

6. Für den ausgewählten Job wird Erfolg angezeigt, wenn er erfolgreich war, oder eine Liste mit Fehlern, wenn der Job fehlgeschlagen ist. Außerdem wird für jeden Ressourcentyp eine Fehlerbeschreibung angezeigt.

Übersicht der Jobdetails in der AWS IoT SiteWise Konsole:

In der Tabelle mit dem Auftragsfortschritt in der AWS IoT SiteWise Konsole wird die Liste der Jobs für Massenvorgänge angezeigt.

1. Wählen Sie einen Job aus, um weitere Details zu sehen.

2. Bei einem Importjob Data source ARN steht der für den Amazon S3 S3-Speicherort der Importdatei.

3. Bei einem Exportauftrag Data destination ARN steht der für den Amazon S3 S3-Speicherort der Datei nach dem Export.

4. Das Status undStatus reason, geben zusätzliche Details zum aktuellen Job an. Weitere Details finden Sie unter Verfolgung des Auftragsfortschritts und Fehlerbehandlung.

5. Das Queued position steht für die Position des Auftrags in der Prozesswarteschlange. Die Jobs werden nacheinander verarbeitet. Eine Position von 1 in der Warteschlange gibt an, dass der Job als Nächstes verarbeitet wird.

6. Auf der Seite mit den Auftragsdetails werden auch die Anzahl der Auftragsfortschritte angezeigt.

   1. Es gibt folgende Typen für die Zählung des Auftragsfortschritts:

      1. Total resources— Gibt die Gesamtzahl der Anlagen an, die sich im Übertragungsprozess befinden.

      2. Succeeded— Gibt die Anzahl der Vermögenswerte an, die während des Prozesses erfolgreich übertragen wurden.

      3. Failed— Gibt die Anzahl der Anlagen an, die während des Vorgangs ausgefallen sind.

      4. Skipped— Gibt die Anzahl der Assets an, die während des Vorgangs übersprungen wurden.

7. Ein Auftragsstatus von PENDING oder zeigt anVALIDATING, dass der gesamte Auftragsfortschritt als – gezählt wird. Dies weist darauf hin, dass die Fortschrittszahlen der Jobs ausgewertet werden.

8. Ein Auftragsstatus von RUNNING zeigt die Total resources Anzahl an, d. h. den Job, der zur Verarbeitung weitergeleitet wurde. Die detaillierten Zählungen (SucceededFailed, undSkipped) beziehen sich auf die verarbeiteten Ressourcen. Die Summe der detaillierten Zählungen ist kleiner als die Total resources Anzahl, bis der Status des Jobs COMPLETED oder lautetERROR.

9. Wenn der Status eines Jobs COMPLETED oder lautetERROR, entspricht die Total resources Anzahl der Summe der detaillierten Anzahlen (SucceededFailed, undSkipped).

10. Wenn der Status eines Job lautetERROR, finden Sie in der Tabelle Auftragsfehler Einzelheiten zu den spezifischen Fehlern und Ausfällen. Weitere Details finden Sie unter Überprüfen Sie die Fehlerdetails (Konsole).

Überprüfen Sie den Auftragsfortschritt und die Einzelheiten (AWS CLI)

Nachdem Sie einen Massenvorgang gestartet haben, können Sie seinen Status mithilfe der folgenden API Aktionen überprüfen oder aktualisieren:

• Verwenden Sie die GetMetadataTransferJobAPIAktion, um Informationen zu einem bestimmten Job abzurufen.

  Rufen Sie Informationen ab mit dem GetMetadataTransferJobAPI:

  1. Erstellen Sie einen Übertragungsauftrag und führen Sie ihn aus. Rufen Sie die an GetMetadataTransferJobAPI.

     Beispiel AWS CLI Befehl:

     
     aws iottwinmaker get-metadata-transfer-job \ 
             --metadata-transfer-job-id your_metadata_transfer_job_id \
             --region your_region                           
     

  2. Der GetMetadataTransferJob API gibt ein MetadataTransferJobProgress Objekt mit den folgenden Parametern zurück:

     • succeededCount— Gibt die Anzahl der Vermögenswerte an, die während des Prozesses erfolgreich übertragen wurden.

     • failedCount— Gibt die Anzahl der Anlagen an, die während des Vorgangs ausgefallen sind.

     • skippedCount— Gibt die Anzahl der Assets an, die während des Vorgangs übersprungen wurden.

     • totalCount— Gibt die Gesamtzahl der Vermögenswerte an, die sich im Übertragungsprozess befinden.

     Diese Parameter geben den Status des Auftragsfortschritts an. Wenn der Status lautetRUNNING, helfen sie dabei, die Anzahl der Ressourcen nachzuverfolgen, die noch verarbeitet werden müssen.

     Wenn bei der Schemavalidierung Fehler auftreten oder wenn der Wert größer oder gleich 1 failedCountist, wechselt der Status des Jobs zuERROR. Ein vollständiger Fehlerbericht für den Job wird in Ihrem Amazon S3 S3-Bucket abgelegt. Weitere Details finden Sie unter Überprüfen Sie die Fehler.

• Verwenden Sie die ListMetadataTransferJobsAPIAktion, um aktuelle Jobs aufzulisten.

  Verwenden Sie eine JSON Datei, um die zurückgegebenen Jobs nach ihrem aktuellen Status zu filtern. Sehen Sie sich das folgende Verfahren an:

  1. Um die Filter anzugeben, die Sie verwenden möchten, erstellen Sie eine AWS CLI JSON Eingabedatei. Sie möchten Folgendes verwenden:

     {
         "sourceType": "s3",
         "destinationType": "iottwinmaker",
         "filters": [{
             "state": "COMPLETED"
         }]
     }

     Eine Liste der gültigen state Werte finden Sie ListMetadataTransferJobsFilterim AWS IoT TwinMaker APIReferenzhandbuch.

  2. Verwenden Sie die JSON Datei als Argument im folgenden AWS CLI Beispielbefehl:

     
     aws iottwinmaker list-metadata-transfer-job --region your_region \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     

• Verwenden Sie die CancelMetadataTransferJobAPIAktion, um einen Job abzubrechen. Dadurch wird der spezifische Metadatentransferauftrag API abgebrochen, ohne dass sich dies auf bereits exportierte oder importierte Ressourcen auswirkt:

  
  aws iottwinmaker cancel-metadata-transfer-job \ 
          --region your_region \ 
          --metadata-transfer-job-id job-to-cancel-id