AWS IoT Wireless 리소스에 대한 로깅 구성

CLI를 사용하여 AWS IoT에 대한 리소스별 로그인을 구성하려면

1. 기본적으로 모든 리소스의 로그 수준은 ERROR로 설정됩니다. 계정의 모든 리소스에 대해 기본 로그 수준 또는 리소스 유형별 로그 수준을 설정하려면 update-log-levels-by-resource-types 명령을 사용합니다. 다음 예제에서는 JSON 파일 Input.json을 생성해서 CLI 명령에 대한 입력으로 제공하는 방법을 보여줍니다. 이 명령을 사용하여 로깅을 선택적으로 비활성화하거나 특정 유형의 리소스 및 이벤트에 대한 기본 로그 수준을 재정의할 수 있습니다.

   {
       "DefaultLogLevel": "INFO",
       "WirelessDeviceLogOptions": 
        [
           {
            "Type": "Sidewalk",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                 "Event": "Registration",
                 "LogLevel": "DISABLED"
               }
             ]
           }, 
           {
            "Type": "LoRaWAN",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                "Event": "Join",
                "LogLevel": "DISABLED"
               }, 
               {
                "Event": "Rejoin",
                "LogLevel": "ERROR"
               }
             ]
           }
         ]
        "WirelessGatewayLogOptions": 
         [
           {
            "Type": "LoRaWAN",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                "Event": "CUPS_Request",
                "LogLevel": "DISABLED"
               }, 
               {
                 "Event": "Certificate",
                 "LogLevel": "ERROR"
               }
             ]
           }
         ]
   }

   여기서 각 항목은 다음과 같습니다.

   WirelessDeviceLogOptions

   무선 디바이스에 대한 로그 옵션 목록입니다. 각 로그 옵션에는 무선 디바이스 유형(Sidewalk 또는 LoRaWAN)과 무선 디바이스 이벤트 로그 옵션 목록이 포함됩니다. 각 무선 디바이스 이벤트 로그 옵션에는 선택적으로 이벤트 유형 및 해당 로그 수준이 포함될 수 있습니다.

   WirelessGatewayLogOptions

   무선 게이트웨이에 대한 로그 옵션 목록입니다. 각 로그 옵션에는 무선 게이트웨이 유형(LoRaWAN)과 무선 게이트웨이 이벤트 로그 옵션 목록이 포함됩니다. 각 무선 게이트웨이 이벤트 로그 옵션에는 선택적으로 이벤트 유형 및 해당 로그 수준이 포함될 수 있습니다.

   DefaultLogLevel

   모든 리소스에 사용할 로그 수준입니다. 유효 값은 ERROR, INFO 및 DISABLED입니다. 기본 값은 INFO입니다.

   LogLevel

   개별 리소스 유형 및 이벤트에 사용할 로그 수준입니다. 이러한 로그 수준은 기본 로그 수준(예: LoRaWAN 게이트웨이의 경우 로그 수준 INFO, 두 이벤트 유형의 경우 로그 수준 DISABLED 및 ERROR)을 재정의합니다.

   다음 명령을 실행하여 Input.json 파일을 명령에 대한 입력으로 제공하세요. 이 명령은 출력을 생성하지 않습니다.

   aws iotwireless update-log-levels-by-resource-types \ 
       --cli-input-json Input.json

   무선 디바이스 및 무선 게이트웨이에 대한 로그 옵션을 제거하려면 다음 명령을 실행합니다.

   {
       "DefaultLogLevel":"DISABLED",
       "WirelessDeviceLogOptions": [],
       "WireslessGatewayLogOptions":[]
   }

2. update-log-levels-by-resource-types 명령은 출력을 반환하지 않습니다. get-log-levels-by-resource-types 명령을 사용하여 리소스별 로깅 정보를 검색할 수 있습니다. 이 명령은 기본 로그 수준과 무선 디바이스 및 무선 게이트웨이 로그 옵션을 반환합니다.

   참고

   get-log-levels-by-resource-types 명령은 CloudWatch 콘솔에서 로그 수준을 직접 검색할 수 없습니다. get-log-levels-by-resource-types 명령을 사용하면 update-log-levels-by-resource-types 명령을 통해 리소스에 대해 지정한 최신 로그 수준 정보를 가져올 수 있습니다.

   aws iotwireless get-log-levels-by-resource-types 

   다음 명령을 실행하면 update-log-levels-by-resource-types로 지정한 최신 로깅 정보를 반환합니다. 예를 들어, 무선 디바이스 로그 옵션을 제거한 경우 get-log-levels-by-resource-types를 실행하면 이 값이 null로 반환됩니다.

   {
       "DefaultLogLevel": "INFO",
       "WirelessDeviceLogOptions": null,
        "WirelessGatewayLogOptions": 
         [
           {
            "Type": "LoRaWAN",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                "Event": "CUPS_Request",
                "LogLevel": "DISABLED"
               }, 
               {
                 "Event": "Certificate",
                 "LogLevel": "ERROR"
               }
             ]
           }
         ]
   }

3. 개별 무선 게이트웨이 또는 무선 디바이스 리소스에 대한 로그 수준을 제어하려면 다음 CLI 명령을 사용합니다.

   • put-resource-log-level

   • get-resource-log-level

   • reset-resource-log-level

   이러한 CLI를 사용하는 경우를 예로 들어 계정에서 많은 수의 무선 디바이스 또는 게이트웨이가 로그되고 있다고 가정해 보겠습니다. 일부 무선 디바이스에 대해서만 오류를 해결하려면 DefaultLogLevel을 DISABLED로 설정하여 모든 무선 디바이스에 대한 로깅을 비활성화하고 put-resource-log-level을 사용하여 계정에 있는 해당 디바이스에 대해서만 LogLevel을 ERROR로 설정할 수 있습니다.

   aws iotwireless put-resource-log-level \ 
       --resource-identifier 
       --resource-type WirelessDevice
       --log-level ERROR

   이 예에서 명령은 지정된 무선 디바이스 리소스에 대해서만 로그 수준을 ERROR로 설정하고 다른 모든 리소스에 대한 로그는 비활성화됩니다. 이 명령은 출력을 생성하지 않습니다. 이 정보를 검색하고 로그 수준이 설정되었는지 확인하려면 get-resource-log-level 명령을 사용하세요.

4. 이전 단계에서 문제를 디버깅하고 오류를 해결한 후 reset-resource-log-level 명령을 실행하여 해당 리소스의 로그 수준을 null로 재설정할 수 있습니다. put-resource-log-level 명령을 사용하여 여러 디바이스에 대한 오류 문제 해결과 같이 둘 이상의 무선 디바이스 또는 게이트웨이 리소스에 대한 로그 수준 재정의를 설정한 경우 reset-all-resource-log-levels 명령을 사용하여 해당 모든 리소스에 대해 로그 수준 재정의를 다시 null로 재설정할 수 있습니다.

   aws iotwireless reset-all-resource-log-levels

   이 명령은 출력을 생성하지 않습니다. 리소스에 대한 로깅 정보를 검색하려면 get-resource-log-level 명령을 실행합니다.