AWS IoT 로깅 구성

1. Select trusted entity(신뢰할 수 있는 엔터티 선택)에서 AWS Service를 선택합니다. 그런 다음 Use case(사용 사례)에서 IoT를 선택합니다. IoT가 표시되지 않는 경우 다른 AWS 서비스 사용 사례: 드롭다운 메뉴에서 IoT를 입력하고 검색합니다. 다음을 선택합니다.

2. Add permissions(권한 추가) 페이지에서 서비스 역할에 자동으로 연결되는 정책이 표시됩니다. 다음을 선택합니다.

3. Name, review, and create(이름 지정, 검토 및 생성) 페이지에서 해당 역할의 Role name(역할 이름) 및 Role description(역할 설명)을 입력하고 Create role(역할 생성)을 선택합니다.

AWS IoT 로깅을 구성하려면:

1. AWS IoT 콘솔에 로그인합니다. 자세한 내용은 AWS IoT 콘솔 열기 단원을 참조하십시오.

2. 왼쪽 탐색 창에서 로그(이전에는 설정 아래의 섹션)를 선택합니다.

3. 계정 수준 로깅 구성: 이벤트 수준 또는 리소스별 설정으로 재정의되지 않는 한 계정 수준 로깅은 모든 AWS IoT 플릿(디바이스 또는 엔드포인트)에 적용됩니다.

   1. 계정 수준 로깅에서 계정 수준 로깅 관리를 선택하여 업데이트합니다.

   2. "로깅 활성화" 확인란을 선택하여 CloudWatch로 로그 전송을 시작합니다. “로깅 활성화”를 선택하지 않으면는 이벤트 수준 또는 리소스 수준 로깅 구성에 관계없이 CloudWatch 로그 그룹에 로그를 보내지 AWS IoT 않습니다.

   3. IAM 로그 역할의 드롭다운 목록에서 기존 역할을 선택합니다. 역할 세부 정보를 보고 역할 권한을 검사할 수 있습니다. 또는 새 역할 생성을 선택하여 새 IAM 역할을 설정합니다. 로깅 역할은가 사용자를 대신하여 CloudWatch에 로그 항목을 AWS IoT 제출하도록 허용하는 정책을 제공합니다. 사용자 지정 CloudWatch 로그 그룹을 사용하여 이벤트 수준 로깅을 구성하는 경우이 로그 그룹의 ARN을 포함하도록 역할 정책을 업데이트해야 합니다.

   4. CloudWatch Logs에 표시할 로그 항목의 세부 수준에 해당하는 기본 로그 수준을 선택합니다. https://docs.aws.amazon.com/iot/latest/developerguide/configure-logging.html#log-level 참고: 로그 수준 “DEBUG”는 가장 세부 정보를 제공하지만 CloudWatch 비용은 증가합니다. CloudWatch 로그 그룹 대상은 계정 수준에서 구성할 수 없습니다. 그러나 다음 섹션에 설명된 대로 개별 이벤트 유형에 대한 사용자 지정 로그 그룹을 지정할 수 있습니다.

   5. 로깅 업데이트를 선택하여 변경 사항을 저장합니다.

4. 이벤트 수준 로깅을 사용하면 관련 이벤트에 대한 로그를 선택적으로 캡처하여 전용 CloudWatch 로그 그룹으로 전달할 수 있습니다. 이를 통해 검색 가능성을 높이기 위해 사용 사례별로 로그를 구성하고, 다양한 대상과 공유하고, 로그를 활성화하고 이벤트 중요도에 따라 로그 수준을 설정하여 CloudWatch 비용을 절감할 수 있습니다.

   이벤트 수준 로깅 구성: 이벤트 수준 로깅은 클라이언트 인증 시도와 같은 특정 AWS IoT 이벤트를 캡처합니다. 이러한 설정은 계정 수준 로깅을 재정의합니다.

   1. 이벤트 수준 로깅 섹션에서 이벤트 수준 로깅 관리를 선택하여 업데이트합니다.

   2. 기본적으로 이벤트 유형은 계정 수준 로깅 구성을 상속합니다. 참고: 리소스별 로깅이 구성된 경우 계정 및 이벤트 수준 설정을 재정의합니다.

   3. 개별 이벤트에 대한 설정을 수정하려면 해당 이벤트 행의 값을 클릭합니다. 로그 수준과 CloudWatch 로그 그룹 대상을 모두 조정할 수 있습니다. 사용자 지정 CloudWatch 로그 그룹 대상을 지정할 때 IAM 역할 정책에 새 로그 그룹에 대한 권한이 포함되어 있는지 확인해야 합니다. 역할 정책을 업데이트하지 않으면가 사용자 지정 로그 그룹에 로그를 AWS IoT 쓰지 못합니다. 선택한 후 확인 표시를 클릭하여 선택을 확인합니다. '수정됨' 열에 보류 중인 변경 사항을 나타내는 '예'가 표시됩니다.

   4. 로깅 업데이트를 클릭하여 변경 사항을 적용하거나 취소를 선택하여 취소합니다.

5. 리소스별 재정의 구성: 리소스별 재정의는 선택한 리소스에 로깅 설정을 적용합니다. 리소스는 사물 그룹, 소스 IP, 클라이언트 ID 또는 보안 주체 ID일 수 있습니다. 리소스별 로깅 구성은 계정 수준 및 이벤트 수준 설정을 모두 재정의합니다. 활성화하면 지정된 리소스에 대해 구성된 로깅 수준에서 모든 이벤트 유형에 대한 로그가 생성됩니다. 예를 들어, 다른 모든 사물에 대한 정보 수준 로깅을 유지하면서 특정 사물에 대한 디버그 수준 로깅을 설정할 수 있습니다.

   1. 리소스별 재정의 섹션에서 리소스별 재정의 추가를 선택합니다.

   2. 사물 그룹, 소스 IP, 클라이언트 ID 또는 보안 주체 ID 중에서 로그 대상을 선택합니다.

   3. 선택한 대상 유형에 해당하는 로그 대상 값을 입력합니다.

   4. 리소스별 로그 수준 섹션의 드롭다운 메뉴에서 원하는 로그 수준을 선택합니다.

   5. 제출을 클릭하여 재정의를 추가하거나 취소를 클릭하여 변경 사항을 취소합니다.

   6. 기존 리소스별 재정의를 수정하려면 리소스 옆의 확인란을 선택하고 “제거”를 클릭하여 재정의를 삭제하거나 “편집”을 클릭하여 수정합니다.

CLI를 사용하여에 대한 기본 로깅을 구성하려면 AWS IoT

1. set-v2-logging-options 명령을 사용하여 계정에 대한 로깅 옵션을 설정합니다.

   aws iot set-v2-logging-options \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

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

   --role-arn

   CloudWatch Logs의 로그에 쓸 수 있는 AWS IoT 권한을 부여하는 역할 ARN입니다. 초기 설정을 위해서는 Role-arn 구성이 필요합니다.

   --default-log-level

   사용할 로그 수준입니다. 유효한 값은 ERROR, WARN, INFO, DEBUG또는 입니다DISABLED. 초기 설정에는 Default-log-level 구성이 필요합니다.

   --no-disable-all-logs

   모든 AWS IoT 로깅을 활성화하는 선택적 파라미터입니다. 이 파라미터를 사용하여 현재 비활성화되어 있는 로깅을 활성화합니다.

   --disable-all-logs

   모든 AWS IoT 로깅을 비활성화하는 선택적 파라미터입니다. 현재 활성화된 로깅을 비활성화하려면 이 파라미터를 사용합니다.

   --event-configurations

   이 파라미터는 선택 사항이며 개별 이벤트 유형에 대한 로깅 설정을 사용자 지정할 수 있습니다.

   • eventType: 계정 수준 설정을 재정의하는 이벤트 유형입니다.

   • logLevel: DEBUG, INFO, ERROR, WARN 또는 DISABLED로 계정 수준 설정 재정의

   • logDestination: 로그 전송을 위한 사용자 지정 CloudWatch 로그 그룹 지정

   각 이벤트 유형에 대해 로깅 수준 및 로그 대상을 독립적으로 구성할 수 있습니다. 지정하지 않으면 이벤트가 계정 수준 설정을 상속합니다.

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

2. get-v2-logging-options 명령을 사용하여 현재 로깅 옵션을 가져옵니다.

   aws iot get-v2-logging-options \
       --verbose

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

   --verbose

   모든 eventTypes 및 해당 구성을 검색할 수 있는 선택적 파라미터입니다.

CLI를 사용하여에 대한 리소스별 재정의를 구성하려면 AWS IoT

1. aws iot set-v2-logging-options 명령을 사용하여 리소스별 로깅을 구성하기 전에 계정 수준 로깅을 활성화합니다.

2. set-v2-logging-level 명령을 사용하여 리소스별 재정의를 구성합니다. 사물 그룹 구성은 다음 예제를 참조하세요.

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   로깅을 구성하는 리소스의 유형과 이름입니다. targetType 값은 THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID 중 하나여야 합니다. 로그 대상 파라미터 값은 앞의 예제 명령과 같이 텍스트이거나 다음 예와 같이 JSON 문자열일 수 있습니다.

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   특정 리소스에 대한 로그를 작성할 때 사용하는 로깅 수준입니다. 유효한 값은 DEBUG, INFO, ERROR, WARN, DISABLED입니다.

3. list-v2-logging-levels 명령을 사용하여 현재 구성된 로깅 수준을 나열합니다.

   aws iot list-v2-logging-levels

4. delete-v2-logging-level 명령을 사용하여 다음 예와 같이 리소스별 로깅 수준을 삭제합니다.

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --target-type

   target-type 값은 THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID 중 하나여야 합니다.

   --target-name

   로깅 수준을 제거할 사물 그룹의 이름입니다.