CloudWatch 를 사용한 네트워크 모니터링 예제 AWS CLI

다음 코드 예제에서는 CloudWatch 네트워크 모니터링과 AWS Command Line Interface 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

작업

다음 코드 예시에서는 create-monitor을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: 집계 기간이 있는 네트워크 모니터를 생성하려면

다음 create-monitor 예제에서는 30 초로 aggregationPeriod 설정된 의 이름이 Example_NetworkMonitor 지정된 모니터를 생성합니다. 모니터와 연결된 프로브가 없기 INACTIVE 때문에 모니터state의 이니셜이 됩니다. 프로브가 추가될 때ACTIVE만 상태가 로 변경됩니다. update-monitor 또는 create-probe 명령을 사용하여 이 모니터에 프로브를 추가할 수 있습니다.


aws networkmonitor create-monitor \
     --monitor-name Example_NetworkMonitor \
     --aggregation-period 30

출력:


{
    "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "INACTIVE",
    "aggregationPeriod": 30,
    "tags": {}
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

예제 2: 를 사용하여 프로브로 네트워크 모니터를 생성TCP하려면 및 에 태그도 포함

다음 create-monitor 예제에서는 라는 모니터를 생성합니다Example_NetworkMonitor. 또한 명령은 ICMP 프로토콜을 사용하고 태그를 포함하는 하나의 프로브를 생성합니다. 요청에 전달aggregationPeriod되지 않으므로 60 초가 기본값으로 설정됩니다. 프로브가 있는 모니터state의 는 모니터가 가 될 PENDING 때까지 유지됩니다ACTIVE. 이 작업은 몇 분 정도 걸릴 수 있으며, 이 시점에서 state 가 로 변경ACTIVE되고 CloudWatch 지표 보기를 시작할 수 있습니다.


aws networkmonitor create-monitor \
    --monitor-name Example_NetworkMonitor \
    --probes sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,probeTags={Name=Probe1} \
    --tags Monitor=Monitor1

출력:


{
    "monitorArn": "arn:aws:networkmonitor:region111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 60,
    "tags": {
        "Monitor": "Monitor1"
    }
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

예제 3: 를 사용하여 프로브로 네트워크 모니터를 생성ICMP하려면 및 에 태그도 포함

다음 create-monitor 예제에서는 aggregationPeriod 의 30 이름이 초Example_NetworkMonitor인 모니터를 생성합니다. 또한 명령은 ICMP 프로토콜을 사용하고 태그를 포함하는 하나의 프로브를 생성합니다. 요청에 전달aggregationPeriod되지 않으므로 60 초가 기본값으로 설정됩니다. 프로브가 있는 모니터state의 는 모니터가 가 될 PENDING 때까지 유지됩니다ACTIVE. 이 작업은 몇 분 정도 걸릴 수 있으며, 이 시점에서 state 가 로 변경ACTIVE되고 CloudWatch 지표 보기를 시작할 수 있습니다.


aws networkmonitor create-monitor \
     --monitor-name Example_NetworkMonitor \
     --aggregation-period 30 \
     --probes sourceArn=arn:aws:ec2:region111122223333:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,probeTags={Name=Probe1} \
     --tags Monitor=Monitor1

출력:


{
    "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 30,
    "tags": {
        "Monitor": "Monitor1"
    }
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조CreateMonitor의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-probe을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: 를 TCP 사용하여 프로브를 생성하고 네트워크 모니터에 추가하는 방법

다음 create-probe 예제에서는 를 사용하는 프로브를 생성하고 라는 모니터에 프로브를 TCP protocol 추가합니다Example_NetworkMonitor. 일단 생성되면 프로브가 있는 모니터state의 는 모니터가 가 될 PENDING 때까지 유지됩니다ACTIVE. 이 작업은 몇 분 정도 걸릴 수 있으며, 이 때 상태가 로 변경ACTIVE되고 CloudWatch 지표 보기를 시작할 수 있습니다.


aws networkmonitor create-probe \
    --monitor-name Example_NetworkMonitor \
    --probe sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,tags={Name=Probe1}

출력:


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345",
    "destination": "10.0.0.100",
    "destinationPort": 80,
    "packetSize": 56,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "PENDING",
    "createdAt": "2024-03-29T12:41:57.314000-04:00",
    "modifiedAt": "2024-03-29T12:41:57.314000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

예제 2: 를 사용하여 프로브를 사용하는 프로브를 생성하고 이를 네트워크 모니터에 ICMP 추가하려면

다음 create-probe 예제에서는 를 사용하는 프로브를 생성하고 라는 모니터에 프로브를 ICMP protocol 추가합니다Example_NetworkMonitor. 일단 생성되면 프로브가 있는 모니터state의 는 모니터가 가 될 PENDING 때까지 유지됩니다ACTIVE. 이 작업은 몇 분 정도 걸릴 수 있으며, 이 때 상태가 로 변경ACTIVE되고 CloudWatch 지표 보기를 시작할 수 있습니다.


aws networkmonitor create-probe \
    --monitor-name Example_NetworkMonitor \
    --probe sourceArn=arn:aws:ec2:region:012345678910:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,tags={Name=Probe1}

출력:


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345",
    "destination": "10.0.0.100",
    "packetSize": 56,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "PENDING",
    "createdAt": "2024-03-29T12:44:02.452000-04:00",
    "modifiedAt": "2024-03-29T12:44:02.452000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조CreateProbe의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-monitor을 사용하는 방법을 보여 줍니다.

AWS CLI

모니터를 삭제하려면

다음 delete-monitor 예제에서는 이름이 인 모니터를 삭제합니다Example_NetworkMonitor.


aws networkmonitor delete-monitor \
    --monitor-name Example_NetworkMonitor

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조DeleteMonitor의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-probe을 사용하는 방법을 보여 줍니다.

AWS CLI

프로브를 삭제하려면

다음 delete-probe 예제에서는 이름이 인 네트워크 모니터probe-12345에서 ID가 인 프로브를 삭제합니다Example_NetworkMonitor.


aws networkmonitor delete-probe \
    --monitor-name Example_NetworkMonitor \
    --probe-id probe-12345

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조DeleteProbe의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-monitor을 사용하는 방법을 보여 줍니다.

AWS CLI

모니터 정보를 가져오려면

다음 get-monitor 예제에서는 이름이 인 모니터에 대한 정보를 가져옵니다Example_NetworkMonitor.


aws networkmonitor get-monitor \
    --monitor-name Example_NetworkMonitor

출력:


{
    "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "ACTIVE",
    "aggregationPeriod": 60,
    "tags": {},
    "probes": [],
    "createdAt": "2024-04-01T17:58:07.211000-04:00",
    "modifiedAt": "2024-04-01T17:58:07.211000-04:00"
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조GetMonitor의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-probe을 사용하는 방법을 보여 줍니다.

AWS CLI

프로브 세부 정보를 보려면

다음 get-probe 예제에서는 라는 모니터와 연결된 가 있는 프로브에 대한 세부 정보를 반환probeIDprobe-12345합니다Example_NetworkMonitor.


aws networkmonitor get-probe \
    --monitor-name Example_NetworkMonitor \
    --probe-id probe-12345

출력:


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345",
    "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345",
    "destination": "10.0.0.100",
    "destinationPort": 80,
    "protocol": "TCP",
    "packetSize": 56,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "ACTIVE",
    "createdAt": "2024-03-29T12:41:57.314000-04:00",
    "modifiedAt": "2024-03-29T12:42:28.610000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조GetProbe의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-monitors을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: 모든 모니터를 나열하려면(단일 모니터)

다음 list-monitors 예제에서는 단일 모니터의 목록만 반환합니다. 모니터의 state는 ACTIVE 이고 모니터aggregationPeriod의 는 60초입니다.


aws networkmonitor list-monitors

출력:


{
    "monitors": [{
            "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor",
            "monitorName": "Example_NetworkMonitor",
            "state": "ACTIVE",
            "aggregationPeriod": 60,
            "tags": {
                "Monitor": "Monitor1"
            }
        }
    ]
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

예제 2: 모든 모니터를 나열하려면(여러 모니터)

다음 list-monitors 예제에서는 3개의 모니터 목록을 반환합니다. 한 모니터state의 는 ACTIVE 및 CloudWatch 지표 생성입니다. 다른 두 모니터의 상태는 CloudWatch 지표를 생성INACTIVE하거나 생성하지 않습니다. 세 모니터 모두 60초aggregationPeriod의 를 사용합니다.


aws networkmonitor list-monitors

출력:


{
    "monitors": [
        {
            "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor",
            "monitorName": "Example_NetworkMonitor",
            "state": "INACTIVE",
            "aggregationPeriod": 60,
            "tags": {}
        },
        {
            "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor2",
            "monitorName": "Example_NetworkMonitor2",
            "state": "ACTIVE",
            "aggregationPeriod": 60,
            "tags": {
                "Monitor": "Monitor1"
            }
        },
        {
            "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/TestNetworkMonitor_CLI",
            "monitorName": "TestNetworkMonitor_CLI",
            "state": "INACTIVE",
            "aggregationPeriod": 60,
            "tags": {}
        }
    ]
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조ListMonitors의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스의 태그를 나열하려면

다음 list-tags-for-resource 예제에서는 이름이 인 모니터의 태그 목록을 반환합니다Example_NetworkMonitor.


aws networkmonitor list-tags-for-resource \
    --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor

출력:


{
    "tags": {
        "Environment": "Dev",
        "Application": "PetStore"
    }
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스에 태그를 지정하려면

다음 tag-resource 예제에서는 Environment=Dev 및 태그Example_NetworkMonitor로 이름이 지정된 모니터에 Application=PetStore 태그를 지정합니다.


aws networkmonitor tag-resource \
    --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \
    --tags Environment=Dev,Application=PetStore

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스의 태그를 해제하려면

다음 untag-resource 예제에서는 키-값 페어가 인 tag-keys 파라미터를 라는 모니터와의 연결Environment Application에서 제거합니다Example_NetworkMonitor.


aws networkmonitor untag-resource \
    --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \
    --tag-keys Environment Application

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-monitor을 사용하는 방법을 보여 줍니다.

AWS CLI

모니터를 업데이트하려면

다음 update-monitor 예제에서는 모니터를 60 초aggregationPeriod에서 30 초로 변경합니다.


aws networkmonitor update-monitor \
    --monitor-name Example_NetworkMonitor \
    --aggregation-period 30

출력:


{
    "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 30,
    "tags": {
        "Monitor": "Monitor1"
    }
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조UpdateMonitor의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-probe을 사용하는 방법을 보여 줍니다.

AWS CLI

프로브를 업데이트하려면

다음 update-probe 예제에서는 프로브의 원래 destination IP 주소를 업데이트하고 도 packetSize로 업데이트합니다60.


aws networkmonitor update-probe \
    --monitor-name Example_NetworkMonitor \
    --probe-id probe-12345 \
    --destination 10.0.0.150 \
    --packet-size 60

출력:


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345",
    "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345",
    "destination": "10.0.0.150",
    "destinationPort": 80,
    "protocol": "TCP",
    "packetSize": 60,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "PENDING",
    "createdAt": "2024-03-29T12:41:57.314000-04:00",
    "modifiedAt": "2024-03-29T13:52:23.115000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

자세한 내용은 Amazon 사용 설명서의 Amazon CloudWatch Network Monitor 작동 방식을 참조하세요. CloudWatch

자세한 API 내용은 명령 참조UpdateProbe의 섹션을 참조하세요. AWS CLI

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

CloudWatch 로그

CodeArtifact