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

# AWS IoT 작업 문제 해결
<a name="jobs-troubleshooting"></a>

다음은 AWS IoT 작업에 대한 문제 해결 섹션입니다.

## AWS IoT 작업 엔드포인트를 찾으려면 어떻게 해야 합니까?
<a name="jobs-endpoint-troubleshooting"></a>

** AWS IoT 작업 컨트롤 플레인 엔드포인트를 찾으려면 어떻게 해야 합니까?**  
AWS IoT 작업은 HTTPS 프로토콜을 사용하여 컨트롤 플레인 API 작업을 지원합니다. HTTPS 프로토콜을 사용하여 올바른 컨트롤 플레인 엔드포인트에 연결했는지 확인하세요.  
 AWS 리전별 엔드포인트 목록은 [AWS IoT 코어 - 컨트롤 플레인 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-core-control-plane-endpoints)를 참조하세요.  
FIPS 준수 **AWS IoT 작업 컨트롤 플레인** 엔드포인트 목록은 [서비스별 FIPS 엔드포인트](https://aws.amazon.com//compliance/fips/#FIPS_Endpoints_by_Service)를 참조하세요.  
AWS IoT 작업 및는 동일한 AWS 리전별 엔드포인트를 AWS IoT Core 공유합니다.

** AWS IoT 작업 데이터 영역 엔드포인트를 찾으려면 어떻게 해야 합니까?**  
AWS IoT 작업은 HTTPS 및 MQTT 프로토콜을 사용하여 데이터 영역 API 작업을 지원합니다. HTTPS 프로토콜을 사용하여 올바른 데이터터 플레인 엔드포인트에 연결했는지 확인하세요.  
+ HTTPS 프로토콜
  + 아래에 표시된 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html) CLI 명령 또는 [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html) REST API를 사용합니다. 엔드포인트 유형에는 `iot:Jobs`를 사용합니다.

    ```
    aws iot describe-endpoint --endpoint-type iot:Jobs
    ```
+ MQTT 프로토콜
  + 아래에 표시된 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html) CLI 명령 또는 [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html) REST API를 사용합니다. 엔드포인트 유형에는 `iot:Data-ATS`를 사용합니다.

    ```
    aws iot describe-endpoint --endpoint-type iot:Data-ATS
    ```
FIPS 준수 **AWS IoT 작업 데이터 플레인** 엔드포인트는 [서비스별 FIPS 엔드포인트](https://aws.amazon.com//compliance/fips/#FIPS_Endpoints_by_Service)를 참조하세요.

## AWS IoT 작업 활동을 모니터링하고 지표를 제공하려면 어떻게 해야 합니까?
<a name="jobs-logs-troubleshooting"></a>

Amazon CloudWatch를 사용한 AWS IoT 작업 모니터링 활동은 진행 중인 AWS IoT 작업 작업에 대한 실시간 가시성을 제공하고 AWS IoT 규칙을 통해 CloudWatch 경보로 비용을 제어하는 데 도움이 됩니다. AWS IoT 작업 활동을 모니터링하고 CloudWatch 경보를 설정하려면 먼저 로깅을 구성해야 합니다. 로깅 설정에 대한 자세한 내용은 [AWS IoT 로깅 구성](configure-logging.md) 섹션을 참조하세요.

Amazon CloudWatch에 대한 자세한 내용과 IAM 사용자 역할을 통해 CloudWatch 리소스 사용 권한을 설정하는 방법에 대한 자세한 내용은 [Amazon CloudWatch의 자격 증명 및 액세스 관리](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)를 참조하세요.

**Amazon CloudWatch를 사용하여 AWS IoT 작업 지표 및 모니터링을 설정하려면 어떻게 해야 합니까?**  
 AWS IoT 로깅을 설정하려면 [AWS IoT 로깅 구성](https://docs.aws.amazon.com/iot/latest/developerguide/configure-logging.html)에 설명된 단계를 따릅니다. AWS IoT 로깅 설정은에서 수행할 수 있습니다. AWS Management Console AWS CLI또는 특정 사물 그룹에 대한 API. AWS IoT logging 설정은 AWS CLI 또는 API에서만 수행해야 합니다.  
[AWS IoT 작업 지표](https://docs.aws.amazon.com/iot/latest/developerguide/metrics_dimensions.html#jobs-metrics) 섹션에는 AWS IoT 작업 활동을 모니터링하는 데 사용되는 AWS IoT 작업 지표가 포함되어 있습니다. 및에서 지표를 보는 방법을 설명합니다 AWS Management Console AWS CLI.  
또한 면밀히 모니터링하려는 특정 지표에 대해 경고하도록 CloudWatch 경보를 설정할 수 있습니다. 경보 설정에 대한 지침은 [Amazon CloudWatch 경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.

## 디바이스 플릿 및 단일 디바이스 문제 해결
<a name="jobs-troubleshooting-for-fleethub"></a>

**작업 실행 상태는 무기한 `QUEUED`로 유지됩니다.**  
상태가 `QUEUED`인 작업 실행이 다음 논리적 상태(예: `IN_PROGRESS`, `FAILED` 또는 `TIMED_OUT`) 로 진행되지 않는 경우 다음 시나리오 중 하나가 원인일 수 있습니다.  
+ [CloudWatch 콘솔](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html)에 있는 CloudWatch 로그에서 디바이스 활동을 검토하세요. 자세한 내용은 [ CloudWatch Logs를 AWS IoT 사용한 모니터링을 참조하세요](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html).
+ 작업 및 후속 작업 실행과 관련된 IAM 역할에는 해당 IAM 역할에 연결된 IAM 정책의 정책 설명 중 하나에 나열된 올바른 권한이 없을 수 있습니다. [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html) API를 사용하여 해당 작업 및 후속 작업 실행에 연결된 IAM 역할을 식별하고 올바른 권한이 있는지 IAM 정책을 검토하세요. 정책 권한 설명이 업데이트되면 리소스에서 [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) API 명령을 수행할 수 있어야 합니다.

**내 사물 또는 사물 그룹에 대한 작업 실행이 생성되지 않았습니다.**  
작업의 상태가 `IN_PROGRESS`로 업데이트되면 대상 그룹의 모든 디바이스에 작업 문서가 롤아웃되기 시작합니다. 이 상태 업데이트는 각 대상 디바이스에 대한 작업 실행을 생성합니다. 대상 디바이스 중 하나에 대한 작업 실행이 생성되지 않은 경우 다음 지침을 참조하세요.  
+ 작업이 *직접* `thing`을 대상으로 지정하고, 작업이 `IN_PROGRESS` 상태이며 작업이 동시 실행 중이어야 합니다. 세 가지 조건을 모두 충족한다면 작업이 아직 대상 그룹의 모든 디바이스에 작업 실행을 전송 중이며 해당 `thing`이 아직 작업 실행을 받지 못한 것입니다.
  +  AWS Management Console에서 작업에 대한 대상 그룹의 디바이스와 작업 상태를 검토하거나 [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html) API 명령을 사용합니다.
  + [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html) API 명령을 사용하여 작업의 `IsConcurrent` 속성이 true 또는 false로 설정되어 있는지 검토하세요. 자세한 내용은 [작업 제한](https://docs.aws.amazon.com/iot/latest/developerguide/job-limits.html)을 참조하세요.
+ 작업이 *직접 `thing`을 대상으로 지정하지 않았습니다*.
  + `Thing`이 `ThingGroup`에 추가되었고 작업이 `ThingGroup`을 대상으로 지정했다면 `Thing`이 `ThingGroup`에 속하는지 확인해야 합니다.
  + 작업이 `IN_PROGRESS` 상태의 스냅샷 작업이며 동시 실행 중이라면, 아직 대상 그룹의 모든 디바이스에 작업 실행을 전송 중이며 해당 이 아직 작업 실행을 받지 못한 것입니다.
  + 작업이 `IN_PROGRESS` 상태의 연속 작업이며 동시 실행 중이라면, 아직 대상 그룹의 모든 디바이스에 작업 실행을 전송 중이며 해당 이 아직 작업 실행을 받지 못한 것입니다. 연속 작업의 경우에 한해, `ThingGroup`에서 `Thing`을 제거한 후 `ThingGroup`에 `Thing`을 다시 추가할 수 있습니다.
  + 작업이 상태인 스냅샷 작업`IN_PROGRESS`이고 동시 작업이 아닌 경우 `Thing` 또는 `ThingGroup` 멤버십 관계가 AWS IoT 작업에서 승인되지 않을 수 있습니다. `Job`을 생성하기 전에 `AddThingToThingGroup` 통화 후 몇 초의 대기 시간을 추가하는 것이 좋습니다. 또는 대상 선택을 `Continuous`로 전환하여 서비스가 지연 `Thing` 및 `ThingGroup` 멤버십 연결 이벤트를 채우도록 할 수 있습니다.

**`LimitedExceededException` 오류로 인한 새 작업 실패**  
`LimitedExceededException` 오류 응답과 함께 작업 생성이 실패하는 경우, `list-jobs` API를 호출하고 `isConcurrent=true`를 사용하여 모든 작업을 검토하여 작업 동시 실행 한도에 도달하지 않았는지 확인하세요. 동시 작업에 대한 추가 정보는 [작업 제한](https://docs.aws.amazon.com/iot/latest/developerguide/job-limits.html)을 참조하세요. 작업 동시 실행 제한과 한도 증가를 요청하려면 [AWS IoT Device Management 작업 제한과 할당량](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#job-limits)을 참조하세요.

**작업 문서 크기 제한**  
작업 문서 크기는 MQTT 페이로드 크기로 제한됩니다. 32kB(킬로바이트), 32,000B(바이트)보다 큰 작업 문서가 필요한 경우, Amazon S3에 작업 문서를 생성 및 저장하고 `CreateJob` API 또는 AWS CLI를 사용할 수 있도록 `documentSource` 필드에 Amazon S3 객체 URL을 추가하세요. 의 경우 작업을 생성할 때 Amazon S3 URL 텍스트 상자에 Amazon S3 객체 URL을 AWS Management Console추가합니다.  
+ AWS Management Console 작업 설명서 생성: [를 사용하여 작업 생성 및 관리 AWS Management Console](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-console.html)
+ AWS CLI 작업 설명서 생성: [를 사용하여 작업 생성 및 관리 AWS CLI](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)
+ `CreateJob` API 설명서: [CreateJob](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html)

**디바이스 측 MQTT 메시지 요청 스로틀 제한**  
오류 코드 400(`ThrottlingException`)을 수신한 경우 동시 디바이스 측 요청 한도에 도달하여 디바이스 측 MQTT 메시지가 실패한 것입니다. 스로틀 한도 및 조정 가능 여부에 대한 자세한 내용은 [AWS IoT Device Management 작업 한도 및 할당량](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#job-limits)을 참조하세요.

**연결 제한 시간 오류**  
오류 코드 400(`RequestExpired`)은 높은 지연 시간 또는 낮은 클라이언트 측 제한 시간 값으로 인한 연결 실패를 나타냅니다.  
+ 클라이언트 측과 서버 측 간의 연결 테스트에 대한 자세한 내용은 [디바이스 데이터 엔드포인트와의 연결 테스트](https://docs.aws.amazon.com/iot/latest/developerguide/iot-quick-start-test-connection.html)를 참조하세요.

**잘못된 API 명령어**  
API 명령이 유효하지 않다는 오류 메시지가 표시되지 않도록 올바른 API 명령을 입력했는지 확인하세요. AWS IoT API 명령의 전체 목록은 [AWS IoT API 참조](https://docs.aws.amazon.com/iot/latest/apireference/Welcome.html)를 참조하세요.

**서비스 측 연결 오류**  
오류 코드 503(`ServiceUnavailable`)은 오류가 서버 측에서 발생했음을 나타냅니다.  
+ 모든 [AWS Health DashboardAWS 서비스의 현재 상태는 (모든 서비스)](https://health.aws.amazon.com/health/status)를 참조하세요. AWS 
+ [AWS Health Dashboard 현재 개인 상태는 (개인 AWS 계정)](https://aws.amazon.com/premiumsupport/technology/aws-health-dashboard/)을 참조하세요 AWS 계정.