Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. AWS
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
를 사용한 CloudWatch Synthetics 예제 AWS CLI
다음 코드 예제에서는 CloudWatch Synthetics와 AWS Command Line Interface 함께를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 관련 시나리오의 컨텍스트에 따라 표시되며, 개별 서비스 함수를 직접적으로 호출하는 방법을 보여줍니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
주제
작업
다음 코드 예시는 associate-resource의 사용 방법을 보여 줍니다.
- AWS CLI
-
카나리를 그룹과 연결하려면
다음
associate-resource예제에서는 카나리를demo_group이라는 그룹과 연결합니다.aws synthetics associate-resource \ --group-identifierdemo_group\ --resource-arnarn:aws:synthetics:us-east-1:123456789012:canary:demo_canary이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 AssociateResource
를 참조하세요.
-
다음 코드 예시는 create-canary의 사용 방법을 보여 줍니다.
- AWS CLI
-
카나리를 생성하려면
다음
create-canary예제에서는demo_canary라는 카나리를 생성합니다.aws synthetics create-canary \ --namedemo_canary\ --code '{"S3Bucket": "artifacts3bucket", "S3Key":"demo_canary.zip", "Handler": "index.lambda_handler"}' \ --artifact-s3-locations3://amzn-s3-demo-bucket/demo_canary.zip\ --execution-role-arnarn:aws:iam::123456789012:role/demo_canary_role\ --schedule Expression="rate(10 minutes)" \ --runtime-versionsyn-nodejs-puppeteer-9.1출력:
{ "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": {} } }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateCanary
를 참조하세요.
-
다음 코드 예시는 create-group의 사용 방법을 보여 줍니다.
- AWS CLI
-
그룹 생성
다음
create-group예시에서는demo_group이라는 그룹을 생성합니다.aws synthetics create-group \ --namedemo_group출력:
{ "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" } }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateGroup
을 참조하세요.
-
다음 코드 예시는 delete-canary의 사용 방법을 보여 줍니다.
- AWS CLI
-
카나리를 영구적으로 삭제하려면
다음
delete-canary예제에서는demo_canary라는 카나리를 삭제합니다.aws synthetics delete-canary \ --namedemo_canary이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteCanary
를 참조하세요.
-
다음 코드 예시는 delete-group의 사용 방법을 보여 줍니다.
- AWS CLI
-
그룹 삭제
다음
delete-group예제에서는demo_group이라는 그룹을 삭제합니다.aws synthetics delete-group \ --group-identifierdemo_group이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteGroup
을 참조하세요.
-
다음 코드 예시는 describe-canaries-last-run의 사용 방법을 보여 줍니다.
- AWS CLI
-
각 카나리의 최신 실행 정보를 보려면
다음
describe-canaries-last-run예제에서는 생성한 각 카나리의 가장 최근 실행을 반환합니다.aws synthetics describe-canaries-last-run출력:
{ "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" } } ] }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeCanariesLastRun
섹션을 참조하세요.
-
다음 코드 예시는 describe-canaries의 사용 방법을 보여 줍니다.
- AWS CLI
-
계정의 카나리를 나열하려면
다음
describe-canaries예제에서는 계정의 카나리에 대한 세부 정보를 나열합니다.aws synthetics describe-canaries출력:
{ "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" } } ] }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeCanaries
를 참조하세요.
-
다음 코드 예시는 describe-runtime-versions의 사용 방법을 보여 줍니다.
- AWS CLI
-
합성 카나리 런타임 버전 목록을 반환하려면
다음
describe-runtime-versions예제에서는 합성 카나리 런타임 버전 목록을 반환합니다.aws synthetics describe-runtime-versions출력:
{ "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" } ] }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DDescribeRuntimeVersions
섹션을 참조하세요.
-
다음 코드 예시는 disassociate-resource의 사용 방법을 보여 줍니다.
- AWS CLI
-
그룹에서 카나리를 제거하려면
다음
disassociate-resource예제에서는demo_group이라는 그룹에서 카나리를 제거합니다.aws synthetics disassociate-resource \ --group-identifierdemo_group\ --resource-arnarn:aws:synthetics:us-east-1:123456789012:canary:demo_canary이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DisassociateResource
를 참조하세요.
-
다음 코드 예시는 get-canary-runs의 사용 방법을 보여 줍니다.
- AWS CLI
-
지정된 카나리에 대한 실행 목록을 검색하려면
다음
get-canary-runs예제에서는demo_canary라는 카나리의 실행 목록을 검색합니다.aws synthetics get-canary-runs \ --namedemo_canary출력:
{ "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" } ] }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 GetCanaryRuns
를 참조하세요.
-
다음 코드 예시는 get-canary의 사용 방법을 보여 줍니다.
- AWS CLI
-
하나의 카나리에 대한 전체 정보를 검색하려면
다음
get-canary예제에서는demo_canary라는 카나리에 대한 전체 정보를 검색합니다.aws synthetics get-canary \ --namedemo_canary출력:
{ "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" } } }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 GetCanary
를 참조하세요.
-
다음 코드 예시는 get-group의 사용 방법을 보여 줍니다.
- AWS CLI
-
하나의 그룹에 대한 정보를 반환하려면
다음
get-group예제에서는demo_group이라는 그룹에 대한 정보를 반환합니다.aws synthetics get-group \ --group-identifierdemo_group출력:
{ "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" } }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 GetGroup
을 참조하세요.
-
다음 코드 예시는 list-associated-groups의 사용 방법을 보여 줍니다.
- AWS CLI
-
그룹 목록을 반환하려면
다음
list-associated-groups예제에서는demo_canary라는 카나리와 연결된 그룹의 목록을 반환합니다.aws synthetics list-associated-groups \ --resource-arnarn:aws:synthetics:us-east-1:123456789012:canary:demo_canary출력:
{ "Groups": [ { "Id": "example123", "Name": "demo_group", "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123" } ] }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ListAssociatedGroups
섹션을 참조하세요.
-
다음 코드 예시는 list-group-resources의 사용 방법을 보여 줍니다.
- AWS CLI
-
지정된 그룹과 연결된 카나리의 ARN 목록을 반환하려면
다음
list-group-resources예제에서는demo_group이라는 그룹과 연결된 카나리의 ARN 목록을 반환합니다.aws synthetics list-group-resources \ --group-identifierdemo_group출력:
{ "Resources": [ "arn:aws:synthetics:us-east-1:123456789012:canary:demo_canary" ] }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ListGroupResources
를 참조하세요.
-
다음 코드 예시는 list-groups의 사용 방법을 보여 줍니다.
- AWS CLI
-
계정의 모든 그룹 목록을 반환하려면
다음
list-groups예제에서는 계정의 모든 그룹 목록을 반환합니다.aws synthetics list-groups출력:
{ "Groups": [ { "Id": "example123", "Name": "demo_group", "Arn": "arn:aws:synthetics:us-east-1:123456789012:group:example123" } ] }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ListGroups
를 참조하세요.
-
다음 코드 예시는 list-tags-for-resource의 사용 방법을 보여 줍니다.
- AWS CLI
-
예제 1: 카나리와 연결된 태그 표시
다음
list-tags-for-resource예제에서는demo_canary라는 카나리와 연결된 태그를 반환합니다.aws synthetics list-tags-for-resource \ --resource-arnarn:aws:synthetics:us-east-1:123456789012:canary:demo_canary출력:
{ "Tags": { "blueprint": "heartbeat" } }예제 2: 그룹과 연결된 태그 표시
다음
list-tags-for-resource예제에서는demo_group이라는 그룹과 연결된 태그를 반환합니다.aws synthetics list-tags-for-resource \ --resource-arnarn:aws:synthetics:us-east-1:123456789012:group:example123출력:
{ "Tags": { "team": "Devops" } }자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ListTagsForResource
를 참조하세요.
-
다음 코드 예시는 start-canary의 사용 방법을 보여 줍니다.
- AWS CLI
-
카나리를 실행하려면
다음
start-canary예제에서는demo_canary라는 카나리를 실행합니다.aws synthetics start-canary \ --namedemo_canary이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 StartCanary
섹션을 참조하세요.
-
다음 코드 예시는 stop-canary의 사용 방법을 보여 줍니다.
- AWS CLI
-
카나리를 중지하려면
다음
stop-canary예제에서는demo_canary라는 카나리를 중지합니다.aws synthetics stop-canary \ --namedemo_canary이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 StopCanary
섹션을 참조하세요.
-
다음 코드 예시는 tag-resource의 사용 방법을 보여 줍니다.
- AWS CLI
-
예제 1: 카나리에 태그 할당
다음
tag-resource예제에서는demo_canary라는 카나리에 태그를 할당합니다.aws synthetics tag-resource \ --resource-arnarn:aws:synthetics:us-east-1:123456789012:canary:demo_canary\ --tagsblueprint=heartbeat이 명령은 출력을 생성하지 않습니다.
예제 2: 그룹에 태그를 할당
다음
tag-resource예제에서는demo_group이라는 그룹에 태그를 할당합니다.aws synthetics tag-resource \ --resource-arnarn:aws:synthetics:us-east-1:123456789012:group:example123\ --tagsteam=Devops이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 TagResource
를 참조하세요.
-
다음 코드 예시는 untag-resource의 사용 방법을 보여 줍니다.
- AWS CLI
-
예제 1: 카나리에서 태그 제거
다음
untag-resource예제에서는demo_canary라는 카나리에서 태그를 제거합니다.aws synthetics untag-resource \ --resource-arnarn:aws:synthetics:us-east-1:123456789012:canary:demo_canary\ --tag-keysblueprint이 명령은 출력을 생성하지 않습니다.
예제 2: 그룹에서 태그 제거
다음
untag-resource예제에서는demo_group이라는 그룹에서 태그를 제거합니다.aws synthetics untag-resource \ --resource-arnarn:aws:synthetics:us-east-1:123456789012:group:example123\ --tag-keysteam이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 UntagResource
를 참조하세요.
-
다음 코드 예시는 update-canary의 사용 방법을 보여 줍니다.
- AWS CLI
-
카나리를 업데이트하려면
다음
update-canary예제에서는demo_canary라는 카나리의 구성을 업데이트합니다.aws synthetics update-canary \ --namedemo_canary\ --schedule Expression="rate(15 minutes)"이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 Synthetic 모니터링(카나리)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 UpdateCanary
를 참조하세요.
-