View a markdown version of this page

Überwachen Sie die Ausführung des Workflows - AWS Transfer Family
CloudWatch Protokollierung für einen WorkflowCloudWatch Metriken für Workflows

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Überwachen Sie die Ausführung des Workflows

Amazon CloudWatch überwacht Ihre AWS Ressourcen und die Anwendungen, die Sie ausführen, AWS Cloud in Echtzeit. Sie können Amazon verwenden, CloudWatch um Kennzahlen zu sammeln und zu verfolgen. Dabei handelt es sich um Variablen, die Sie für Ihre Workflows messen können. Mithilfe von Amazon können Sie Workflow-Metriken und konsolidierte Protokolle anzeigen CloudWatch.

CloudWatch Protokollierung für einen Workflow

CloudWatch bietet konsolidierte Überwachung und Protokollierung des Workflow-Fortschritts und der Ergebnisse.

AWS Transfer Family bietet zwei Möglichkeiten, Protokolle zur Ausführung verwalteter Workflows an Amazon zu übermitteln CloudWatch:

  • Eine von Ihnen angegebene Protokollgruppe (strukturiertes Protokollziel) — Sie geben eine CloudWatch Logs-Protokollgruppe als strukturiertes Protokollziel für den Workflow an, und Transfer Family übermittelt die Workflow-Ausführungsprotokolle für Sie an diese Protokollgruppe. Für diese Option ist keine Protokollierungsrolle erforderlich. Um sie zu verwenden, geben Sie den Amazon-Ressourcennamen (ARN) einer Protokollgruppe im StructuredLogDestinations Parameter an, wenn Sie den Workflow erstellen (siehe StructuredLogDestinations in der AWS Transfer Family API-Referenz). Die Protokollgruppe muss sich im selben Land AWS-Konto AWS-Region wie der Workflow befinden.

    Um ein strukturiertes Protokollziel zu konfigurieren, muss die IAM-Richtlinie für den Prinzipal, der den Workflow erstellt, die folgenden Berechtigungen enthalten:

    • logs:CreateLogDelivery

    • logs:DeleteLogDelivery

    • logs:DescribeLogGroups

    • logs:DescribeResourcePolicies

    • logs:GetLogDelivery

    • logs:ListLogDeliveries

    • logs:PutResourcePolicy

    • logs:UpdateLogDelivery

  • Eine Protokollierungsrolle — Sie fügen dem Server, an den der Workflow angehängt ist, eine IAM-Protokollierungsrolle zu. Transfer Family übernimmt die Rolle, die Workflow-Ausführungsprotokolle in eine Protokollgruppe mit dem Namen /aws/transfer/server-id zu schreiben. Details hierzu finden Sie unter Konfigurieren Sie die CloudWatch Protokollierungsrolle.

Beide Mechanismen schreiben den gleichen Inhalt des Workflow-Ausführungsprotokolls im gleichen JSON-Format. Der Unterschied besteht nur darin, wo die Protokolle übermittelt werden: an die von Ihnen angegebene /aws/transfer/server-id Protokollgruppe oder über die Protokollierungsrolle an die Protokollgruppe auf dem Server.

Sehen Sie sich CloudWatch Amazon-Protokolle für Workflows an

  1. Öffnen Sie die CloudWatch Amazon-Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Wählen Sie im linken Navigationsbereich Logs und dann Log-Gruppen aus.

  3. Wählen Sie auf der Seite „Protokollgruppen“ in der Navigationsleiste die richtige Region für Ihren AWS Transfer Family Server aus.

  4. Wählen Sie die Protokollgruppe aus, die Ihre Workflow-Logs enthält.

    • Wenn der Workflow ein strukturiertes Protokollziel verwendet, wählen Sie die Protokollgruppe aus, deren ARN Sie im StructuredLogDestinations Parameter des Workflows angegeben haben.

    • Wenn der Workflow eine Protokollierungsrolle auf dem Server verwendet, wählen Sie die Protokollgruppe aus, die Ihrem Server entspricht. Wenn Ihre Server-ID beispielsweise lautets-1234567890abcdef0, ist es Ihre Protokollgruppe/aws/transfer/s-1234567890abcdef0.

  5. Auf der Detailseite der Protokollgruppe werden die neuesten Log-Streams angezeigt. Der Name des Log-Streams für den Workflow hängt davon ab, welchen Protokollierungsmechanismus der Workflow verwendet:

    • Für ein strukturiertes Protokollziel wird der Workflow-Logstream benanntworkflowID/executionID. Beispiel:

      w-abcdef01234567890/021345abcdef6789

    • Für eine Protokollierungsrolle enthält die Serverprotokollgruppe zwei Protokollstreams für den Benutzer, den Sie untersuchen: einen für jede Secure Shell (SSH) File Transfer Protocol (SFTP) -Sitzung und einen für den Workflow, der gerade ausgeführt wird. Das Format für den Workflow-Logstream istusername.workflowID.uniqueStreamSuffix.

    Wenn Ihr Benutzer es beispielsweise istmary-major, haben Sie die folgenden Log-Streams:

    mary-major-east.1234567890abcdef0
mary.w-abcdef01234567890.021345abcdef6789
    Anmerkung

    Die in diesem Beispiel aufgeführten 16-stelligen alphanumerischen Identifikatoren sind fiktiv. Die Werte, die Sie in Amazon sehen, sind unterschiedlich. CloudWatch

Die Seite „Ereignisse protokollieren“ für einen Workflow-Log-Stream enthält die Details für die Workflow-Ausführung. Wenn der Workflow eine Protokollierungsrolle verwendet, zeigt der mary-major-usa-east.1234567890abcdef0 Stream die Details für jede Benutzersitzung an, und der mary.w-abcdef01234567890.021345abcdef6789 Stream enthält die Details für den Workflow. Wenn der Workflow ein strukturiertes Protokollziel verwendet, enthält der w-abcdef01234567890/021345abcdef6789 Stream die Details für den Workflow.

Im Folgenden finden Sie ein Beispiel für einen Protokollstream fürmary.w-abcdef01234567890.021345abcdef6789, der auf einem Workflow (w-abcdef01234567890) basiert, der einen Kopierschritt enthält. 

{
    "type": "ExecutionStarted",
    "details": {
        "input": {
            "initialFileLocation": {
                "bucket": "amzn-s3-demo-bucket",
                "key": "mary/workflowSteps2.json",
                "versionId": "version-id",
                "etag": "etag-id"
            }
        }
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails": {
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"StepStarted",
    "details": {
        "input": {
            "fileLocation": {
                "backingStore":"S3",
                "bucket":"amzn-s3-demo-bucket",
                "key":"mary/workflowSteps2.json",
                "versionId":"version-id",
                "etag":"etag-id"
            }
        },
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails": {
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"StepCompleted",
    "details":{
        "output":{},
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails":{
        "serverId":"server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"ExecutionCompleted",
    "details": {},
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails":{
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
}

CloudWatch Metriken für Workflows

AWS Transfer Family bietet mehrere Metriken für Workflows. Sie können Kennzahlen dafür anzeigen, wie viele Workflow-Ausführungen in der letzten Minute gestartet, erfolgreich abgeschlossen und fehlgeschlagen sind. Alle CloudWatch Metriken für Transfer Family werden unter beschriebenVerwendung von CloudWatch Messobjekten für Transfer Family-Server.