# 네트워크 분석기 구성 생성 및 리소스 추가
추적 메시징을 스트리밍하려면 먼저 네트워크 분석기 구성을 생성하고 모니터링하려는 리소스를 이 구성에 추가합니다. 구성을 생성할 때 다음을 수행할 수 있습니다.
+ 구성 이름을 지정하고 선택적으로 설명을 입력합니다.
+ 로그 메시지의 프레임 정보 및 세부 수준 등의 구성 설정을 사용자 지정합니다.
+ 모니터링하기를 원하는 리소스를 추가합니다. 리소스는 무선 디바이스 또는 무선 게이트웨이 또는 둘 다일 수 있습니다.
지정하는 구성 설정에 따라 구성에 추가하는 리소스에 대해 수신할 추적 메시징 정보가 결정됩니다. 모니터링 사용 사례에 따라 여러 구성을 만들 수도 있습니다.
다음은 구성을 생성하고 리소스를 추가하는 방법을 보여줍니다.
**Topics**
+ [네트워크 분석기 구성 생성](network-analyzer-create.md)
+ [리소스 추가 및 네트워크 분석기 구성 업데이트](network-analyzer-resources.md)
# 네트워크 분석기 구성 생성
무선 게이트웨이 또는 무선 디바이스를 모니터링하려면 먼저 네트워크 분석기 구성을 만들어야 합니다. 구성을 생성할 때 구성 이름만 지정하면 됩니다. 구성 설정을 생성한 후에도 구성 설정을 사용자 지정하고 모니터링할 리소스를 구성에 추가할 수 있습니다. 구성 설정에 따라 해당 리소스에 대해 수신할 추적 메시징 정보가 결정됩니다.
모니터링할 리소스와 해당 리소스에 대해 수신하려는 정보 수준에 따라 여러 구성을 만들 수 있습니다. 예를 들어, AWS 계정에 있는 특정 게이트웨이 집합에 대한 오류 정보만 표시하는 구성을 만들 수 있습니다. 모니터링할 무선 디바이스에 대한 모든 정보를 표시하는 구성을 만들 수도 있습니다.
다음 섹션에서는 다양한 구성 설정과 구성을 생성하는 방법을 보여줍니다.
## 구성 설정
네트워크 분석기 구성을 생성하거나 업데이트할 때 다음 파라미터를 사용자 지정하여 로그 스트림 정보를 필터링할 수도 있습니다.
+
**프레임 정보(Frame info)**
이 설정은 추적 메시지의 무선 디바이스 리소스에 대한 프레임 정보입니다. 프레임 정보는 네트워크 서버와 최종 디바이스 간의 통신을 디버깅하는 데 사용할 수 있습니다. 기본적으로 활성화됩니다.
+
**로그 수준**
정보 또는 오류 로그를 보거나 로깅을 해제할 수 있습니다.
+
**정보**
로그 수준이 **정보(Info)**인 로그는 더 상세하며 오류 로그 스트림과 정보 로그 스트림을 모두 포함합니다. 정보 로그를 사용하여 디바이스 또는 게이트웨이 상태의 변경 사항을 볼 수 있습니다.
**참고**
자세한 로그 스트림을 수집하면 추가 비용이 발생할 수 있습니다. 요금에 대한 자세한 내용은 [AWS IoT Core 요금](https://aws.amazon.com/iot-core/pricing/)을 참조하십시오.
+
**오류**
로그 수준이 **오류(Error)**인 로그는 덜 상세하고 오류 정보만 표시합니다. 애플리케이션에 디바이스 연결 오류와 같은 오류가 있는 경우 이러한 로그를 사용할 수 있습니다. 로그 스트림의 정보를 사용하여 플릿의 리소스에 대한 오류를 식별하고 문제를 해결할 수 있습니다.
## 콘솔을 사용하여 구성 생성
AWS IoT 콘솔 또는 AWS IoT 무선 API를 사용하여 네트워크 분석기 구성을 생성하고 선택적으로 파라미터를 사용자 지정할 수 있습니다. 또한 여러 구성을 생성하고 나중에 사용하지 않는 구성을 삭제할 수 있습니다.
**네트워크 분석기 구성 생성**
1. [AWS IoT 콘솔의 네트워크 분석기 허브](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)를 열고 **Create configuration**(구성 생성)을 선택합니다.
1. 구성 설정을 지정합니다.
+
**이름, 설명 및 태그**
문자, 숫자, 하이픈 또는 밑줄만 포함하는 고유한 **Configuration name**(구성 이름)을 지정합니다. 선택 사항인 **설명(Description)** 필드를 사용하여 구성에 대한 정보를 제공하고 **태그(Tags)** 필드를 사용하여 구성에 대한 메타데이터의 키 값 쌍을 추가합니다. 리소스 이름 지정 및 설명에 대한 자세한 내용은 [AWS IoT 무선 리소스 설명](iotwireless-describe-resources.md) 단원을 참조하세요.
+
**구성 설정**
프레임 정보를 사용 중지할지 여부를 선택하고 **로그 수준 선택(Select log levels)**을 사용하여 추적 메시지 로그에 사용할 로그 수준을 선택합니다. **다음**을 선택합니다.
1. 구성에 리소스 추가 지금 리소스를 추가하거나 **생성(Create)**을 선택한 후 나중에 리소스를 추가합니다. 나중에 리소스를 추가하려면 **생성(Create)**을 선택합니다.
**네트워크 분석기 허브(Network Analyzer hub)** 페이지에서 생성한 구성과 설정을 볼 수 있습니다. 새 구성의 세부 정보를 보려면 구성 이름을 선택합니다.
**네트워크 분석기 구성 삭제**
모니터링할 리소스와 해당 리소스에 대해 수신하려는 추적 메시징 정보 수준에 따라 여러 개의 네트워크 분석기 구성을 만들 수 있습니다.
**콘솔에서 구성을 제거하는 방법**
1. [AWS IoT 콘솔의 네트워크 분석기 허브](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)로 이동하여 제거할 구성을 선택합니다.
1. **작업**을 선택한 후 **삭제**를 선택합니다.
## API를 사용하여 구성 생성
API를 사용하여 네트워크 분석기 구성을 만들려면 [CreateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateNetworkAnalyzerConfiguration.html) API 작업 또는 [create-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-network-analyzer-configuration.html) CLI 명령을 사용합니다.
구성을 생성할 때 구성 이름만 지정하면 됩니다. 또한 이 API 작업을 사용하여 구성 설정을 지정하고 구성을 생성할 때 리소스를 추가할 수 있습니다. 또는 나중에 [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) API 작업 또는 [pdate-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) CLI 명령을 사용하여 지정할 수 있습니다.
+
**구성 생성**
구성을 생성할 때 구성 이름을 지정해야 합니다. 예를 들어, 다음 명령은 이름과 선택적으로 설명만 제공하여 구성을 생성합니다. 기본적으로 구성에는 프레임 정보가 활성화되어 있으며 `INFO` 로그 수준을 사용합니다.
```
aws iotwireless create-network-analyzer-configuration \
--configuration-name My_Network_Analyzer_Config \
--description "My first network analyzer configuration"
```
이 명령을 실행하면 네트워크 분석기 구성의 ARN 및 ID가 표시됩니다.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
+
**리소스로 구성 생성**
구성 설정을 사용자 지정하려면 `trace-content` 파라미터를 사용하세요. 리소스를 추가하려면 `WirelessDevices` 및 `WirelessGateways` 파라미터를 사용하여 구성에 추가할 게이트웨이, 디바이스 또는 둘 다를 지정하세요. 예를 들어, 다음 명령은 구성 설정을 사용자 지정하고 구성에 `WirelessGatewayID` 및 `WirelessDeviceID`로 지정된 무선 리소스를 추가합니다.
```
aws iotwireless create-network-analyzer-configuration \
--configuration-name My_NetworkAnalyzer_Config \
--trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR" \
--wireless-gateways "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1"
--wireless-devices "1ffd32c8-8130-4194-96df-622f072a315f"
```
다음 예에서는 명령 실행의 출력을 보여줍니다.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
**네트워크 분석기 구성 나열**
모니터링할 리소스와 해당 리소스에 대해 수신하려는 추적 메시징 정보의 세부 수준에 따라 여러 개의 네트워크 분석기 구성을 만들 수 있습니다. 이러한 구성을 만든 후 [ListNetworkAnalyzerConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListNetworkAnalyzerConfigurations.html) API 작업 또는 [list-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-network-analyzer-configuration.html) CLI 명령을 사용하여 해당 구성 목록을 가져옵니다.
```
aws iotwireless list-network-analyzer-configurations
```
이 명령을 실행하면 AWS 계정에 있는 모든 네트워크 분석기 구성이 표시됩니다. `max-results` 파라미터를 사용하여 표시할 구성의 개수를 지정할 수도 있습니다. 다음은 이 명령 실행의 출력을 보여줍니다.
```
{
"NetworkAnalyzerConfigurationList": [
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Name": "My_Network_Analyzer_Config1"
},
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/90123456-a1a2-9a87-65b4-c12bf3c2d09a",
"Name": "My_Network_Analyzer_Config2"
}
]
}
```
**네트워크 분석기 구성 삭제**
[DeleteNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteNetworkAnalyzerConfiguration.html) API 작업 또는 [delete-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-network-analyzer-configuration.html) CLI 명령을 사용하여 더 이상 사용하지 않는 구성을 삭제할 수 있습니다.
```
aws iotwireless delete-network-analyzer-configuration \
--configuration-name My_NetworkAnalyzer_Config
```
이 명령을 실행하면 출력을 생성하지 않습니다. 사용 가능한 구성을 보려면 `ListNetworkAnalyzerConfigurations` API 작업을 사용하면 됩니다.
## 다음 단계
네트워크 분석기 구성을 만들었으므로 구성에 리소스를 추가하거나 구성 설정을 업데이트할 수 있습니다. 자세한 내용은 [리소스 추가 및 네트워크 분석기 구성 업데이트](network-analyzer-resources.md) 단원을 참조하십시오.
# 리소스 추가 및 네트워크 분석기 구성 업데이트
추적 메시징을 활성화하려면 먼저 구성에 리소스를 추가해야 합니다. 하나의 기본 네트워크 분석기 구성만 사용할 수 있습니다. AWS IoT Core for LoRaWAN은 **NetworkAnalyzerConfig\$1Default**라는 이름을 이 구성에 할당하며 이 필드는 편집할 수 없습니다. 이 구성은 콘솔에서 네트워크 분석기를 사용할 때 자동으로 AWS 계정에 추가됩니다.
이 기본 구성에 모니터링할 리소스를 추가할 수 있습니다. 리소스는 LoRaWAN 디바이스와 LoRaWAN 게이트웨이 중 하나 또는 둘 모두일 수 있습니다. 구성에 각 개별 리소스를 추가하려면 무선 게이트웨이 및 무선 디바이스 식별자를 사용합니다.
## 구성 설정
설정을 구성하려면 먼저 기본 구성에 리소스를 추가하고 추적 메시징을 활성화합니다. 추적 메시지 로그를 수신한 후 다음 파라미터를 사용자 지정하여 기본 구성을 업데이트하고 로그 스트림을 필터링할 수도 있습니다.
+
**프레임 정보(Frame info)**
이 설정은 추적 메시지의 무선 디바이스 리소스의 프레임 정보입니다. 프레임 정보는 기본적으로 사용되며 네트워크 서버와 종단 디바이스 간의 통신을 디버깅하는 데 사용할 수 있습니다.
+
**로그 수준**
정보 또는 오류 로그를 보거나 로깅을 해제할 수 있습니다.
+
**정보**
로그 수준이 **정보(Info)**인 로그는 더 상세하며 자세한 정보를 제공하고 오류가 들어 있는 로그 스트림을 포함합니다. 정보 로그를 사용하여 디바이스 또는 게이트웨이 상태의 변경 사항을 볼 수 있습니다.
**참고**
자세한 로그 스트림을 수집하면 추가 비용이 발생할 수 있습니다. 요금에 대한 자세한 내용은 [AWS IoT Core 요금](https://aws.amazon.com/iot-core/pricing/)을 참조하십시오.
+
**오류**
로그 수준이 **오류(Error)**인 로그는 덜 상세하고 오류 정보만 표시합니다. 애플리케이션에 디바이스 연결 오류와 같은 오류가 있는 경우 이러한 로그를 사용할 수 있습니다. 로그 스트림의 정보를 사용하여 플릿의 리소스에 대한 오류를 식별하고 문제를 해결할 수 있습니다.
## 필수 조건
리소스를 추가하려면 먼저 모니터링할 게이트웨이 및 디바이스를 AWS IoT Core for LoRaWAN에 온보딩해야 합니다. 자세한 내용은 [AWS IoT Core for LoRaWAN에 게이트웨이 및 디바이스 연결](lorawan-getting-started.md) 단원을 참조하십시오.
## 콘솔을 사용하여 리소스 추가 및 네트워크 분석기 구성 업데이트
AWS IoT 콘솔 또는 AWS IoT 무선 API를 사용하여 리소스를 추가하고 선택적 파라미터를 사용자 지정할 수 있습니다. 리소스 외에도 구성 설정을 편집하고 업데이트된 구성을 저장할 수도 있습니다.
**구성에 리소스를 추가하려면(콘솔)**
1. [AWS IoT 콘솔의 네트워크 분석기 허브](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)를 열고 네트워크 분석기 구성인 **NetworkAnalyzerConfig\$1Default**를 선택합니다.
1. **리소스 추가(Add resources)**를 선택합니다.
1. 무선 게이트웨이 및 무선 디바이스 식별자를 사용하여 모니터링할 리소스를 추가합니다. 최대 250개의 무선 게이트웨이 또는 무선 디바이스를 추가할 수 있습니다. 리소스를 추가하려면
1. **게이트웨이 보기(View gateways)** 또는 **디바이스 보기(View devices)** 탭을 사용하여 AWS 계정에 추가한 게이트웨이 및 디바이스 목록을 봅니다.
1. 모니터링하려는 디바이스나 게이트웨이의 `WirelessDeviceID` 또는 `WirelessGatewayID`를 복사하여 해당 리소스의 식별자 값을 입력합니다.
1. 리소스를 계속 추가하려면 **게이트웨이 추가(Add gateway)** 또는 **디바이스 추가(Add device)**를 선택하고 무선 게이트웨이 또는 디바이스를 추가합니다. 더 이상 모니터링하지 않을 리소스를 추가한 경우 **리소스 제거(Remove resource)**를 선택합니다.
1. 리소스를 모두 추가한 다음 **추가(Add)**를 선택합니다.
**네트워크 분석기 허브 페이지(Network Analyzer hub page)**에서 추가한 게이트웨이 및 디바이스 수를 확인할 수 있습니다. 추적 메시징 세션을 활성화할 때까지 게이트웨이와 디바이스를 계속 추가할 수 있습니다. 세션이 활성화된 후 리소스를 추가하려면 세션을 비활성화해야 합니다.
**네트워크 분석기 구성을 편집하려면(콘솔)**
네트워크 분석기 구성을 편집하고 추적 메시지 로그에 대한 프레임 정보 및 로그 수준을 사용 중지할지 여부를 선택할 수도 있습니다.
1. [AWS IoT 콘솔의 네트워크 분석기 허브](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)를 열고 네트워크 분석기 구성인 **NetworkAnalyzerConfig\$1Default**를 선택합니다.
1. **편집**을 선택합니다.
1. 프레임 정보를 사용 중지할지 여부를 선택하고 **로그 수준 선택(Select log levels)**을 사용하여 추적 메시지 로그에 사용할 로그 수준을 선택합니다. **Save**(저장)를 선택합니다.
네트워크 분석기 구성의 세부 정보 페이지에 지정한 구성 설정이 표시됩니다.
## API를 사용하여 리소스 추가 및 네트워크 분석기 구성 업데이트
[AWS IoT 무선 API 작업](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/) 또는 [AWS IoT 무선 CLI 명령](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html)을 사용하여 리소스를 추가하고 네트워크 분석기 구성에 대한 구성 설정을 업데이트할 수 있습니다.
+ 리소스를 추가하고 네트워크 분석기 구성을 업데이트하려면 [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) API 또는 [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) CLI를 사용합니다.
+
**리소스 추가**
추가하려는 무선 디바이스의 경우 `WirelessDevicesToAdd`를 사용하여 디바이스의 `WirelessDeviceID`를 문자열 배열로 입력합니다. 추가하려는 무선 게이트웨이의 경우 `WirelessGatewaysToAdd`를 사용하여 게이트웨이의 `WirelessGatewayID`를 문자열 배열로 입력합니다.
+
**구성 편집**
네트워크 분석기 구성을 편집하려면 `TraceContent` 파라미터를 사용하여 `WirelessDeviceFrameInfo`가 `ENABLED` 또는 `DISABLED`여야 하는지 여부와 `LogLevel` 파라미터가 `INFO`, `ERROR` 또는 `DISABLED`여야 하는지 여부를 지정합니다.
```
{
"TraceContent": {
"LogLevel": "string",
"WirelessDeviceFrameInfo": "string"
},
"WirelessDevicesToAdd": [ "string" ],
"WirelessDevicesToRemove": [ "string" ],
"WirelessGatewaysToAdd": [ "string" ],
"WirelessGatewaysToRemove": [ "string" ]
}
```
+ 추가한 구성 및 리소스에 대한 정보를 보려면 [GetNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) API 작업 또는 [get-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-network-analyzer-configuration.html) 명령을 사용합니다. 네트워크 분석기 구성의 이름 `NetworkAnalyzerConfig_Default`를 입력으로 제공합니다.
## 다음 단계
리소스를 추가하고 구성에 대한 선택적 구성 설정을 지정했으므로 이제 WebSocket 프로토콜을 사용하여 네트워크 분석기를 사용하는 AWS IoT Core for LoRaWAN과의 연결을 설정할 수 있습니다. 그런 다음 추적 메시징을 활성화하고 리소스에 대한 추적 메시지 수신을 시작할 수 있습니다. 자세한 내용은 [WebSocket을 사용하여 네트워크 분석기 추적 메시지 스트리밍](network-analyzer-api.md) 단원을 참조하십시오.