CloudWatch Beispiele für Synthetics unter Verwendung von AWS CLI

Um einen Canary einer Gruppe zuzuordnen

Im folgenden associate-resource Beispiel wird ein Kanarienvogel einer Gruppe mit dem Namen zugeordnetdemo_group.

aws synthetics associate-resource \
    --group-identifier demo_group \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um einen Kanarienvogel zu erstellen

Im folgenden create-canary Beispiel wird ein Kanarienvogel mit dem Namen erstelltdemo_canary.

aws synthetics create-canary \
    --name demo_canary \
    --code '{"S3Bucket": "artifacts3bucket", "S3Key":"demo_canary.zip", "Handler": "index.lambda_handler"}' \
    --artifact-s3-location s3://amzn-s3-demo-bucket/demo_canary.zip \
    --execution-role-arn arn:aws:iam::123456789012:role/demo_canary_role \
    --schedule Expression="rate(10 minutes)" \
    --runtime-version syn-nodejs-puppeteer-9.1

Ausgabe:

{
    "Canary": {
        "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
        "Name": "demo_canary",
        "Code": {
            "Handler": "index.lambda_handler"
        },
        "ExecutionRoleArn": "arn:aws:iam::123456789012:role/demo_canary_role",
        "Schedule": {
            "Expression": "rate(10 minutes)",
            "DurationInSeconds": 0
        },
        "RunConfig": {
            "TimeoutInSeconds": 600,
            "MemoryInMB": 1000,
            "ActiveTracing": false
        },
        "SuccessRetentionPeriodInDays": 31,
        "FailureRetentionPeriodInDays": 31,
        "Status": {
            "State": "CREATING",
            "StateReasonCode": "CREATE_PENDING"
        },
        "Timeline": {
            "Created": "2024-10-15T19:03:08.826000+05:30",
            "LastModified": "2024-10-15T19:03:08.826000+05:30"
        },
        "ArtifactS3Location": "amzn-s3-demo-bucket/demo_canary.zip",
        "RuntimeVersion": "syn-nodejs-puppeteer-9.1",
        "Tags": {}
    }
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um eine Gruppe zu erstellen

Im folgenden create-group Beispiel wird eine Gruppe mit dem Namen erstelltdemo_group.

aws synthetics create-group \
    --name demo_group

Ausgabe:

{
    "Group": {
        "Id": "example123",
        "Name": "demo_group",
        "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123",
        "Tags": {},
        "CreatedTime": "2024-10-15T14:47:23.811000+05:30",
        "LastModifiedTime": "2024-10-15T14:47:23.811000+05:30"
    }
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um einen Canary dauerhaft zu löschen

Im folgenden delete-canary Beispiel wird ein Kanarienvogel mit dem Namen demo_canary gelöscht.

aws synthetics delete-canary \
    --name demo_canary

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um eine Gruppe zu löschen

Im folgenden delete-group Beispiel wird eine Gruppe mit dem Namen demo_group gelöscht.

aws synthetics delete-group \
    --group-identifier demo_group

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um Informationen aus dem letzten Lauf jedes Canary-Laufs zu sehen

Das folgende describe-canaries-last-run Beispiel gibt den letzten Lauf jedes Canary-Programms zurück, das Sie erstellt haben.

aws synthetics describe-canaries-last-run

Ausgabe:

{
    "CanariesLastRun": [
        {
            "CanaryName": "demo_canary",
            "LastRun": {
                "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
                "Name": "demo_canary",
                "Status": {
                    "State": "PASSED",
                    "StateReason": "",
                    "StateReasonCode": ""
                },
                "Timeline": {
                    "Started": "2024-10-15T19:20:39.691000+05:30",
                    "Completed": "2024-10-15T19:20:58.211000+05:30"
                },
                "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-abc-example1234/2024/10/15/13/50-39-690"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um Kanarienvögel in Ihrem Konto aufzulisten

Das folgende describe-canaries Beispiel listet die Informationen zu Canaries in Ihrem Konto auf.

aws synthetics describe-canaries

Ausgabe:

{
    "Canaries": [
        {
            "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
            "Name": "demo_canary",
            "Code": {
                "SourceLocationArn": "arn:aws:lambda:us-east-1:123456789012:layer:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example11111b8:1",
                "Handler": "pageLoadBlueprint.handler"
            },
            "ExecutionRoleArn": "arn:aws:iam::123456789012:role/service-role/CloudWatchSyntheticsRole-demo_canary-a12-a123bc456789",
            "Schedule": {
                "Expression": "rate(5 minutes)",
                "DurationInSeconds": 0
            },
            "RunConfig": {
                "TimeoutInSeconds": 300,
                "MemoryInMB": 1000,
                "ActiveTracing": false
            },
            "SuccessRetentionPeriodInDays": 31,
            "FailureRetentionPeriodInDays": 31,
            "Status": {
            "State": "RUNNING"
            },
            "Timeline": {
                "Created": "2024-10-15T18:55:15.168000+05:30",
                "LastModified": "2024-10-15T18:55:40.540000+05:30",
                "LastStarted": "2024-10-15T18:55:40.540000+05:30"
            },
            "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-a12-a123bc456789",
            "EngineArn": "arn:aws:lambda:us-east-1:123456789012:function:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example111118:1",
            "RuntimeVersion": "syn-nodejs-puppeteer-9.1",
            "Tags": {
                "blueprint": "heartbeat"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um eine Liste der Synthetics Canary-Runtime-Versionen zurückzugeben

Das folgende describe-runtime-versions Beispiel gibt die Liste der Synthetics Canary-Runtime-Versionen zurück.

aws synthetics describe-runtime-versions

Ausgabe:

{
    "RuntimeVersions": [
        {
            "VersionName": "syn-nodejs-puppeteer-9.1",
            "Description": "Security fixes and bug fix for date range error in har. Dependencies: Node JS 20.x, Puppeteer-core 22.12.1, Chromium 126.0.6478.126",
            "ReleaseDate": "2024-10-02T05:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-9.0",
            "Description": "Upgraded Chromium and Puppeteer. Dependencies: Node JS 20.x, Puppeteer-core 22.12.1, Chromium 126.0.6478.126",
            "ReleaseDate": "2024-07-22T05:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-8.0",
            "Description": "Upgraded Chromium and Puppeteer. Dependencies: Node JS 20.x, Puppeteer-core 22.10.0, Chromium 125.0.6422.112",
            "ReleaseDate": "2024-06-21T05:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-7.0",
            "Description": "Upgraded Chromium and Puppeteer. Dependencies: Node JS 18.x, Puppeteer-core 21.9.0, Chromium 121.0.6167.139",
            "ReleaseDate": "2024-03-08T05:30:00+05:30"
            },
        {
            "VersionName": "syn-nodejs-puppeteer-6.2",
            "Description": "Updated shared libraries for Chromium and added ephemeral storage monitoring. Dependencies: Node JS 18.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146",
            "ReleaseDate": "2024-02-02T05:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-6.1",
            "Description": "Added puppeteer launch retry. Dependencies: Node JS 18.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146",
            "ReleaseDate": "2023-11-13T05:30:00+05:30",
            "DeprecationDate": "2024-03-08T13:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-6.0",
            "Description": "Reduced X-Ray traces of a canary run, improved duration metric and upgraded to NodeJS 18.x. Dependencies: Node JS 18.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146",
            "ReleaseDate": "2023-09-15T05:30:00+05:30",
            "DeprecationDate": "2024-03-08T13:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-5.2",
            "Description": "Updated shared libraries for Chromium. Dependencies: Node JS 16.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146",
            "ReleaseDate": "2024-02-01T05:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-5.1",
            "Description": "Fixes a bug about missing request headers in har. Dependencies: Node JS 16.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146",
            "ReleaseDate": "2023-08-09T05:30:00+05:30",
            "DeprecationDate": "2024-03-08T13:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-5.0",
            "Description": "Upgraded Puppeteer and Chromium. Dependencies: Node JS 16.x, Puppeteer-core 19.7.0, Chromium 111.0.5563.146",
            "ReleaseDate": "2023-07-21T05:30:00+05:30",
            "DeprecationDate": "2024-03-08T13:30:00+05:30"
        },
        {
            "VersionName": "syn-nodejs-puppeteer-4.0",
            "Description": "Upgraded to NodeJS 16.x. Dependencies: Node JS 16.x, Puppeteer-core 5.5.0, Chromium 92.0.4512.0",
            "ReleaseDate": "2023-05-01T05:30:00+05:30",
            "DeprecationDate": "2024-03-08T13:30:00+05:30"
        }
    ]
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um einen Canary aus einer Gruppe zu entfernen

Im folgenden disassociate-resource Beispiel wird ein Canary aus der genannten Gruppe entferntdemo_group.

aws synthetics disassociate-resource \
    --group-identifier demo_group \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um eine Liste von Läufen für einen bestimmten Canary abzurufen

Im folgenden get-canary-runs Beispiel wird eine Liste von Läufen für den genannten demo_canary Canary abgerufen.

aws synthetics get-canary-runs \
    --name demo_canary

Ausgabe:

{
    "CanaryRuns": [
        {
            "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
            "Name": "demo_canary",
            "Status": {
                "State": "PASSED",
                "StateReason": "",
                "StateReasonCode": ""
            },
            "Timeline": {
                "Started": "2024-10-16T10:38:57.013000+05:30",
                "Completed": "2024-10-16T10:39:25.793000+05:30"
            },
            "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-abc-example1234/2024/10/15/13/50-39-690"
        }
    ]
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um vollständige Informationen über einen Kanarienvogel abzurufen

Im folgenden get-canary Beispiel werden vollständige Informationen über den genannten demo_canary Kanarienvogel abgerufen.

aws synthetics get-canary \
    --name demo_canary

Ausgabe:

{
    "Canary": {
        "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
        "Name": "demo_canary",
        "Code": {
            "SourceLocationArn": "arn:aws:lambda:us-east-1:123456789012:layer:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example111118:1",
            "Handler": "pageLoadBlueprint.handler"
        },
        "ExecutionRoleArn": "arn:aws:iam::123456789012:role/demo_canary_role",
        "Schedule": {
            "Expression": "rate(10 minutes)",
            "DurationInSeconds": 0
        },
        "RunConfig": {
            "TimeoutInSeconds": 300,
            "MemoryInMB": 1000,
            "ActiveTracing": false
        },
        "SuccessRetentionPeriodInDays": 31,
        "FailureRetentionPeriodInDays": 31,
        "Status": {
            "State": "RUNNING"
        },
        "Timeline": {
            "Created": "2024-10-15T18:55:15.168000+05:30",
            "LastModified": "2024-10-15T18:55:40.540000+05:30",
            "LastStarted": "2024-10-15T18:55:40.540000+05:30"
        },
        "ArtifactS3Location": "cw-syn-results-123456789012-us-east-1/canary/us-east-1/demo_canary-a12-a123bc456789",
        "EngineArn": "arn:aws:lambda:us-east-1:123456789012:function:cwsyn-demo_canary-a1b2c3d4-5678-90ab-cdef-example111118:1",
        "RuntimeVersion": "syn-nodejs-puppeteer-9.1",
        "Tags": {
            "blueprint": "heartbeat"
        }
    }
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um Informationen zu einer Gruppe zurückzugeben

Das folgende get-group Beispiel gibt Informationen über die angegebene Gruppe zurückdemo_group.

aws synthetics get-group \
    --group-identifier demo_group

Ausgabe:

{
    "Group": {
        "Id": "example123",
        "Name": "demo_group",
        "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123",
        "Tags": {},
        "CreatedTime": "2024-10-15T14:47:23.811000+05:30",
        "LastModifiedTime": "2024-10-15T14:47:23.811000+05:30"
    }
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um eine Liste der Gruppen zurückzugeben

Das folgende list-associated-groups Beispiel gibt eine Liste der Gruppen zurück, die dem genannten Kanarienvogel zugeordnet sinddemo_canary.

aws synthetics list-associated-groups \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary

Ausgabe:

{
    "Groups": [
        {
            "Id": "example123",
            "Name": "demo_group",
            "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123"
        }
    ]
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um eine Liste ARNs der Kanarienvögel zurückzugeben, die der angegebenen Gruppe zugeordnet sind

Das folgende list-group-resources Beispiel gibt eine Liste ARNs der Kanarienvögel zurück, die der genannten Gruppe zugeordnet sind. demo_group

aws synthetics list-group-resources \
    --group-identifier demo_group

Ausgabe:

{
    "Resources": [
        "arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary"
    ]
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um eine Liste aller Gruppen im Konto zurückzugeben

Das folgende list-groups Beispiel gibt eine Liste aller Gruppen im Konto zurück.

aws synthetics list-groups

Ausgabe:

{
    "Groups": [
        {
            "Id": "example123",
            "Name": "demo_group",
            "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123"
        }
    ]
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 1: Um die Tags anzuzeigen, die einem Kanarienvogel zugeordnet sind

Das folgende list-tags-for-resource Beispiel gibt die Tags zurück, die einem Kanarienvogel mit dem Namen zugeordnet sinddemo_canary.

aws synthetics list-tags-for-resource \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary

Ausgabe:

{
    "Tags": {
        "blueprint": "heartbeat"
    }
}

Beispiel 2: Um die mit einer Gruppe verknüpften Tags anzuzeigen

Das folgende list-tags-for-resource Beispiel gibt die Tags zurück, die einer Gruppe mit dem Namen zugeordnet sinddemo_group.

aws  synthetics list-tags-for-resource \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:group:example123

Ausgabe:

{
    "Tags": {
        "team": "Devops"
    }
}

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um einen Canary laufen zu lassen

Im folgenden start-canary Beispiel wird ein Canary namens ausgeführtdemo_canary.

aws synthetics start-canary \
    --name demo_canary

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um einen Kanarienvogel zu stoppen

Das folgende stop-canary Beispiel stoppt den genannten Kanarienvogeldemo_canary.

aws synthetics stop-canary \
    --name demo_canary

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 1: Um dem Canary ein Tag zuzuweisen

Im folgenden tag-resource Beispiel wird dem genannten demo_canary Kanarienvogel ein Tag zugewiesen.

aws synthetics tag-resource \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary \
    --tags blueprint=heartbeat

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Beispiel 2: Um der Gruppe ein Tag zuzuweisen

Im folgenden tag-resource Beispiel wird der genannten demo_group Gruppe ein Tag zugewiesen.

aws synthetics tag-resource \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:group:example123 \
    --tags team=Devops

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 1: Um ein Tag vom Canary zu entfernen

Im folgenden untag-resource Beispiel wird ein Tag aus dem Kanariensystem mit dem Namen entferntdemo_canary.

aws synthetics untag-resource \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary \
    --tag-keys blueprint

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Beispiel 2: Um ein Tag aus der Gruppe zu entfernen

Das folgende untag-resource Beispiel weist ein Tag zu und entfernt ein Tag aus der Gruppe mit dem Namendemo_group.

aws synthetics untag-resource \
    --resource-arn arn:aws:synthetics:us-east-1:123456789012:group:example123 \
    --tag-keys team

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.

Um einen Canary zu aktualisieren

Das folgende update-canary Beispiel aktualisiert die Konfiguration eines Canary namensdemo_canary.

aws synthetics update-canary \
    --name demo_canary \
    --schedule Expression="rate(15 minutes)"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Synthetic Monitoring (Canaries) im CloudWatch Amazon-Benutzerhandbuch.