기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 디바이스 측 로그를 Amazon CloudWatch에 업로드합니다.
<a name="upload-device-logs-to-cloudwatch"></a>

기록 디바이스 측 로그를 Amazon CloudWatch에 업로드하여 현장에서의 디바이스 활동을 모니터링하고 분석할 수 있습니다. 디바이스 측 로그에는 시스템, 애플리케이션 및 디바이스 로그 파일이 포함될 수 있습니다. 이 프로세스는 CloudWatch Logs 규칙 작업 파라미터를 사용하여 디바이스 측 로그를 고객이 정의한 [로그 그룹](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)에 게시합니다.

## 작동 방식
<a name="upload-process-overview"></a>

이 프로세스는 AWS IoT 디바이스가 형식이 지정된 로그 파일이 포함된 MQTT 메시지를 AWS IoT 주제에 전송할 때 시작됩니다. AWS IoT 규칙은 메시지 주제를 모니터링하고 사용자가 정의한 CloudWatch Logs 그룹에 로그 파일을 전송합니다. 그런 다음 정보를 검토하고 분석할 수 있습니다.

**Topics**
+ [MQTT 주제](#upload-mqtt-topics-overview)
+ [규칙 작업](#upload-rule-action-overview)

### MQTT 주제
<a name="upload-mqtt-topics-overview"></a>

로그를 게시하는 데 사용할 MQTT 주제 네임스페이스를 선택합니다. 일반 주제 공간에는 `$aws/rules/things/thing_name/logs` 형식을, 오류 주제에는 `$aws/rules/things/thing_name/logs/errors` 형식을 사용하는 것이 좋습니다. 로그 및 오류 주제의 명명 구조는 권장되지만 필수는 아닙니다. 자세한 내용은 [AWS IoT Core에 대한 MQTT 주제 설계](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html)를 참조하세요.

권장 공통 주제 공간을 사용하면 AWS IoT 기본 수집 예약 주제를 활용할 수 있습니다. AWS IoT 기본 수집은 AWS IoT 규칙 작업에서 지원하는 AWS 서비스로 디바이스 데이터를 안전하게 전송합니다. 수집 경로에서 게시/구독 메시지 브로커를 제거해 비용 효율성이 더 커집니다. 자세한 내용은 [Basic Ingest를 사용하여 메시징 비용 절감](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html)을 참조하세요.

BatchMode를 사용하여 로그 파일을 업로드하는 경우 메시지는 UNIX 타임스탬프 및 메시지를 포함하는 특정 형식을 따라야 합니다. 자세한 내용은 [CloudWatch Logs 규칙 작업](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html)의 [BatchMode에 대한 MQTT 메시지 형식 요구 사항](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html#cloudwatch-logs-rule-action-message-format) 주제를 참조하세요.

### 규칙 작업
<a name="upload-rule-action-overview"></a>

가 클라이언트 디바이스에서 MQTT 메시지를 AWS IoT 수신하면 AWS IoT 규칙은 고객 정의 주제를 모니터링하고 사용자가 정의한 CloudWatch 로그 그룹에 콘텐츠를 게시합니다. 이 프로세스에서는 CloudWatch Logs 규칙 작업을 사용하여 MQTT에 로그 파일 배치가 있는지 모니터링합니다. 자세한 내용은 [CloudWatch Logs](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html) AWS IoT 규칙 작업을 참조하세요.

#### BatchMode
<a name="upload-batch-mode-overview"></a>

 `batchMode`는 AWS IoT CloudWatch Logs 규칙 작업 내의 부울 파라미터입니다. 이 파라미터는 선택 사항이며 기본적으로 꺼짐(`false`) 상태입니다. 디바이스 측 로그 파일을 배치로 업로드하려면 AWS IoT 규칙을 생성할 때이 파라미터를 켜야 합니다(`true`). 자세한 내용은 [AWS IoT 규칙 작업](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rule-actions.html) 섹션의 [CloudWatch Logs](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html)를 참조하세요.