기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 문제 해결 AWS IoT SiteWise 다음 정보를 사용하여 문제를 해결합니다 AWS IoT SiteWise. **Topics** + [SiteWise Edge 게이트웨이 문제 해결](troubleshooting-gateway.md) + [AWS IoT SiteWise 포털 문제 해결](troubleshooting-portal.md) + [AWS IoT SiteWise 규칙 작업 문제 해결](troubleshoot-rule.md) + [일괄 가져오기 및 내보내기 작업 문제 해결](troubleshooting-bulk.md) # SiteWise Edge 게이트웨이 문제 해결 관련 주제를 탐색하여 일반적인 AWS IoT SiteWise Edge 게이트웨이 문제를 해결합니다. SiteWise Edge 게이트웨이가 보고한 CloudWatch 지표를 보고 연결 또는 데이터 스트림 관련 문제를 해결할 수도 있습니다. 자세한 내용은 [Amazon CloudWatch 지표 AWS IoT SiteWise 로 모니터링](monitor-cloudwatch-metrics.md) 단원을 참조하십시오. **Topics** + [SiteWise Edge 게이트웨이 로그 구성 및 액세스](#configure-gateway-logs) + [SiteWise Edge 게이트웨이 문제 해결](#troubleshoot-gateway-issues) + [에서 AWS IoT SiteWise Edge 애플리케이션 문제 해결 Siemens Industrial Edge](#troubleshoot-siemens-app) + [Edge에서 오픈 소스 통합 문제 해결](#open-source-troubleshooting) + [AWS IoT Greengrass 문제 해결](#troubleshoot-greengrass-issues) ## SiteWise Edge 게이트웨이 로그 구성 및 액세스 SiteWise Edge 게이트웨이 로그를 보려면 먼저 Amazon CloudWatch Logs로 로그를 보내거나 로컬 파일 시스템에 로그를 저장하도록 SiteWise Edge 게이트웨이를 구성해야 합니다. + 를 사용하여 SiteWise Edge 게이트웨이의 로그 파일을 AWS Management Console 보려면 CloudWatch Logs를 사용합니다. SiteWise 자세한 내용은 [Amazon CloudWatch Logs 사용](gateway-cloudwatch-logs.md) 단원을 참조하십시오. + 명령줄 또는 로컬 소프트웨어를 사용하여 SiteWise Edge 게이트웨이의 로그 파일을 보려면 로컬 파일 시스템 로그를 사용합니다. 자세한 내용은 [에서 서비스 로그 사용 AWS IoT SiteWise](gateway-local-logs.md) 단원을 참조하십시오. ## SiteWise Edge 게이트웨이 문제 해결 다음 정보를 사용하여 SiteWise Edge 게이트웨이 문제를 해결합니다. **Topics** + [SiteWise Edge 게이트웨이에 팩을 배포할 수 없음](#gateway-issue-ggv2-packs) + [AWS IoT SiteWise OPC UA 서버에서 데이터를 수신하지 않음](#gateway-issue-data-streams) + [대시보드에 데이터가 표시되지 않음](#gateway-issue-no-data) + [/greengrass/v2/logs 오류에서 aws.iot.siteWiseEdgePublisher 로그에 “메인 클래스를 찾거나 로드할 수 없음”이라는 메시지가 표시됨.](#troubleshoot-java-issues) + ['SESSION\$1TAKEN\$1OVER' 또는 'com.aws.greengrass.mqttclient.MqttClient 스풀러를 통해 메시지를 게시하지 못했으며 다시 시도할 것입니다.' 메시지가 표시됨 로그에서](#sa-troubleshoot-multiple-use) + ['com.aws.greengrass.deployment.IotJobsHelper: 배포 작업을 찾을 수 없습니다.' 또는 '배포 결과가 이미 보고되었습니다.' 메시지가 표시됨 로그에서](#sa-troubleshoot-reuse) + [OPC UA 데이터 소스의 속성 그룹에서 타임스탬프 설정을 구성하려고 하면 'SYNC\$1FAILED' 상태가 표시됩니다.](#troubleshoot-gateway-sync-failed-timestamp) + [변환된 데이터 유형이 포함되지 않음](#troubleshoot-data-conversion) + [트러스트 스토어 문제](#troubleshoot-trust-stores) + [프록시 지원 설치 문제](#troubleshoot-proxy-during-installation) ### SiteWise Edge 게이트웨이에 팩을 배포할 수 없음 AWS IoT Greengrass nucleus 구성 요소(`aws.greengrass.Nucleus`)가 오래된 경우 SiteWise Edge 게이트웨이에 팩을 배포하지 못할 수 있습니다. AWS IoT Greengrass V2 콘솔을 사용하여 AWS IoT Greengrass nucleus 구성 요소를 업그레이드할 수 있습니다. **AWS IoT Greengrass nucleus 구성 요소를 업그레이드하려면(콘솔)** 1. [AWS IoT Greengrass 콘솔](https://console.aws.amazon.com/greengrassIntro)로 이동합니다. 1. 탐색 창의 **AWS IoT Greengrass**에서 **배포**를 선택합니다. 1. **배포 목록**에서 수정하려는 배포를 선택합니다. 1. **수정**을 선택합니다. 1. **대상 지정** 페이지에서 **다음**을 선택합니다. 1. **구성 요소 선택** 페이지의 **퍼블릭 구성 요소**에서 검색 상자에 **aws.greengrass.Nucleus**를 입력한 다음 **aws.greengrass.Nucleus**를 선택합니다. 1. **다음**을 선택합니다. 1. **구성 요소 구성** 페이지에서 **다음**을 선택합니다. 1. **고급 설정 구성** 페이지에서 **다음**을 선택합니다. 1. **검토** 페이지에서 **배포**를 선택합니다. ### AWS IoT SiteWise OPC UA 서버에서 데이터를 수신하지 않음 AWS IoT SiteWise 자산이 OPC UA 서버에서 전송한 데이터를 수신하지 않는 경우 SiteWise Edge 게이트웨이의 로그를 검색하여 문제를 해결할 수 있습니다. 다음 메시지가 포함된 정보 수준 `swPublisher` 로그를 찾습니다. ``` Emitting diagnostic name=PublishError.SomeException ``` 로그의 *SomeException* 유형에 따라 다음 예외 유형 및 해당 문제를 사용하여 SiteWise Edge 게이트웨이 문제를 해결합니다. + **ResourceNotFoundException** – OPC UA 서버에서 자산의 속성 별칭과 일치하지 않는 데이터를 보냅니다. 이 예외는 두 가지 경우에 발생할 수 있습니다. + 속성 별칭은 정의한 원본 접두사를 포함해 OPC UA 변수와 정확히 일치하지 않습니다. 속성 별칭 및 원본 접두사가 올바른지 확인합니다. + OPC UA 변수를 자산 속성에 매핑하지 않았습니다. 자세한 내용은 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md) 단원을 참조하십시오. 원하는 모든 OPC UA 변수를 이미 매핑한 경우 SiteWise Edge 게이트웨이가 전송하는 OPC UA 변수를 필터링 AWS IoT SiteWise할 수 있습니다. 자세한 내용은 [SiteWise Edge에서 OPC UA 노드 필터 사용](opc-ua-node-filters.md) 단원을 참조하십시오. + **InvalidRequestException** – OPC UA 변수 데이터 형식이 자산 속성 데이터 형식과 일치하지 않습니다. 예를 들어 OPC UA 변수가 정수 데이터 형식인 경우, 해당 자산 속성은 정수 데이터 유형이어야 합니다. 배정밀도 형식의 자산 속성은 OPC UA 정수 값을 받을 수 없습니다. 이 문제를 해결하려면 새 속성을 올바른 데이터 형식으로 정의합니다. + **TimestampOutOfRangeException** - SiteWise Edge 게이트웨이가 AWS IoT SiteWise 허용 범위를 벗어나는 데이터를 전송하고 있습니다.는 타임스탬프가 과거 7일 이전이거나 향후 5분 이전인 모든 데이터 포인트를 AWS IoT SiteWise 거부합니다. SiteWise Edge 게이트웨이의 전원이 끊어지거나 AWS 클라우드에 연결되지 않은 경우 SiteWise Edge 게이트웨이의 캐시를 지워야 할 수 있습니다. + **ThrottlingException** 또는 **LimitExceededException** - 요청이 수집된 데이터 포인트 비율 또는 자산 속성 데이터 API 작업에 대한 요청 비율과 같은 AWS IoT SiteWise 서비스 할당량을 초과했습니다. 구성이 [AWS IoT SiteWise 할당량](endpoints-and-quotas.md#quotas)를 초과하지 않는지 확인합니다. ### 대시보드에 데이터가 표시되지 않음 대시보드에 데이터가 표시되지 않으면 SiteWise Edge 게이트웨이의 **게시자 구성**과 **데이터 소스**가 동기화되지 않을 수 있습니다. 동기화되지 않는 경우 데이터 소스 이름을 변경하면 클라우드에서 엣지로의 동기화가 빨라져 동기화되지 않음 오류가 수정될 수 있습니다. **데이터 소스의 이름을 업데이트하려면 다음을 수행하세요.** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 창에서 **엣지 게이트웨이**를 선택합니다. 1. 대시보드에 연결된 SiteWise Edge 게이트웨이를 선택합니다. 1. **데이터 소스**에서 **편집**을 선택합니다. 1. 새 소스 **이름**을 선택하고 **저장**을 선택하여 변경 내용을 확인합니다. 1. **데이터 원본** 테이블에서 데이터 원본 이름이 업데이트되었는지 확인하여 변경 내용을 확인합니다. ### /greengrass/v2/logs 오류에서 aws.iot.siteWiseEdgePublisher 로그에 “메인 클래스를 찾거나 로드할 수 없음”이라는 메시지가 표시됨. 이 오류가 표시되면 SiteWise Edge 게이트웨이의 Java 버전을 업데이트해야 할 수 있습니다. + 터미널에서 다음 명령을 실행합니다. ``` java -version ``` SiteWise Edge 게이트웨이가 실행 중인 Java 버전이 `OpenJDK Runtime Environment` 아래에 표시됩니다. 다음과 같은 응답이 표시됩니다. ``` openjdk version "11.0.20" 2023-07-18 LTS OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node) ``` 자바 버전 11.0.20.8.1을 실행하는 경우 IoT SiteWise 퍼블리셔 팩을 버전 2.4.1 이상으로 업데이트해야 합니다. 자바 버전 11.0.20.8.1만 영향을 받으며, 다른 자바 버전을 사용하는 환경에서는 IoT SiteWise Publisher 구성 요소의 이전 버전을 계속 사용할 수 있습니다. 구성 요소 팩 업데이트에 대한 자세한 내용은 [SiteWise Edge 게이트웨이 구성 요소 팩 버전 변경](manage-gateways-ggv2.md#manage-gateway-update-packs) 단원을 참조하세요. ### 'SESSION\$1TAKEN\$1OVER' 또는 'com.aws.greengrass.mqttclient.MqttClient 스풀러를 통해 메시지를 게시하지 못했으며 다시 시도할 것입니다.' 메시지가 표시됨 로그에서 `/greengrass/v2/logs/greengrass.log`의 로그에 `SESSION_TAKEN_OVER`가 포함된 경고 또는 `com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.`가 포함된 오류가 표시되면 여러 디바이스의 여러 SiteWise Edge 게이트웨이에 동일한 구성 파일을 사용하려고 하는 것일 수 있습니다. 각 SiteWise Edge 게이트웨이는 AWS 계정에 연결하기 위해 고유한 구성 파일이 필요합니다. ### 'com.aws.greengrass.deployment.IotJobsHelper: 배포 작업을 찾을 수 없습니다.' 또는 '배포 결과가 이미 보고되었습니다.' 메시지가 표시됨 로그에서 `/greengrass/v2/logs/greengrass.log`의 로그에 `com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.` 또는 `Deployment result already reported.`가 표시되면 동일한 구성 파일을 재사용하려고 하는 것일 수 있습니다. 다음과 같은 여러 해결 방법이 있습니다. + 구성 파일을 재사용하려면 다음을 수행하세요. 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 창에서 **엣지 게이트웨이**를 선택합니다. 1. 재사용하려는 SiteWise Edge 게이트웨이를 선택합니다. 1. **업데이트** 탭을 선택합니다. 1. 다른 게시자 버전을 선택하고 **배포**를 선택합니다. [Siemens Industrial Edge의 게이트웨이 생성](sa-create-config.md)의 단계에 따라 새 구성 파일을 생성합니다. ### OPC UA 데이터 소스의 속성 그룹에서 타임스탬프 설정을 구성하려고 하면 'SYNC\$1FAILED' 상태가 표시됩니다. 버전 2.5.0 AWS IoT Greengrass 에서에 대한 OPC UA 수집기 구성 요소가 AWS IoT SiteWise 업데이트되면 새로운 타임스탬프 구성 옵션이 도입되었습니다. 디바이스의 타임스탬프 또는 서버의 타임스탬프를 사용할 수 있습니다. OPC UA 수집기 구성 요소의 이전 버전은이 옵션을 지원하지 않으며 동기화에 실패합니다. 두 가지 방법으로 실패한 데이터 소스 동기화 상태를 확인할 수 있습니다. 권장되는 방법은 IoT SiteWise OPC UA 수집기 구성 요소를 버전 2.5.0 이상으로 업그레이드하는 것입니다. 또는 타임스탬프를 로 설정한 경우 이전 OPC UA 수집기 구성 요소 버전을 계속 사용할 수 있습니다`Source`. IoT SiteWise OPC UA 수집기 구성 요소를 업그레이드하는 방법은 섹션을 참조하세요[AWS IoT SiteWise 구성 요소의 버전 업데이트](manage-gateways-ggv2.md#update-component-version). 모든 구성 요소의 최신 버전을 사용하는 것이 좋습니다. **참고** 데이터 소스 동기화 상태가 실패해도 데이터 중단은 없습니다. 소스 데이터는 계속 들어갑니다 AWS IoT SiteWise. 구성이 AWS IoT Greengrass V2 배포의 IoT SiteWise OPC UA 수집기 구성 요소와 동기화되지 않습니다. **속성 그룹의 타임스탬프 구성을 변경하려면** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 창에서 **엣지 게이트웨이**를 선택합니다. 1. 편집할 게이트웨이를 선택합니다. 1. **데이터 소스** 섹션에서 동기화 실패 상태의 데이터 소스를 선택하고 **편집**을 선택합니다. 1. **고급 구성을** 확장한 다음 **그룹 설정을** 확장합니다. 1. **타임스탬프**에서 **소스를** 선택합니다. **소스를** 선택하면 구성에서 `timestampToReturn` 속성이 제거됩니다. 이 설정을 사용하면 기본적으로 디바이스에서 데이터 소스 타임스탬프를 수집할 수 있으므로 데이터 소스가 IoT SiteWise OPC UA 수집기 구성 요소와 동기화될 수 있습니다. 1. **저장**을 선택합니다. ### 변환된 데이터 유형이 포함되지 않음 지원되지 않는 OPC UA 데이터 형식을 문자열로 변환할 때 오류가 표시되는 경우 몇 AWS IoT SiteWise가지 가능한 이유가 있습니다. + 변환하려는 데이터 유형이 복잡한 데이터 유형입니다. 복잡한 데이터 유형은 지원되지 않습니다. + **Amazon S3를 사용한AWS IoT SiteWise Buffered**를 **대상**으로 사용하면 전체 문자열 값이 Amazon S3 버킷에 푸시된 파일에 보존됩니다. 나중에 데이터를 수집하면 1 AWS IoT SiteWise 024바이트보다 긴 전체 문자열 값이 거부됩니다. ### 트러스트 스토어 문제 SiteWise Edge의 트러스트 스토어와 관련된 문제가 발생하면 다음 문제 해결 단계를 고려하세요. + AWS IoT Greengrass 루트 CA 인증서가 있고 적절한 트러스트 스토어에 올바른 형식이 지정되어 있는지 확인합니다. + Java KeyStore 암호가 올바르게 설정되고 SiteWise Edge 구성 요소에 액세스할 수 있는지 확인합니다. + 사용자 지정 인증서(예: HTTPS 프록시용)가 올바른 형식(일반적으로 PEM)이고 트러스트 스토어로 올바르게 가져오는지 확인합니다. + 트러스트 스토어에 올바른 파일 권한이 있고 SiteWise Edge 프로세스에 액세스할 수 있는지 확인합니다. + SiteWise Edge 로그에서 트러스트 스토어 문제를 나타낼 수 있는 SSL/TLS 관련 오류를 검토합니다. + 와 같은 도구를 사용하여 SSL/TLS 연결을 독립적으로 테스트`openssl`하여 트러스트 스토어 기능 확인 ### 프록시 지원 설치 문제 프록시 구성 프로세스 중에 문제가 발생하면 다음 문제 해결 단계를 고려하세요. + 프록시 URL의 형식이 올바르고 적절한 체계(`http://` 또는 `https://`)가 포함되어 있는지 확인합니다. + 프록시 자격 증명에 특수 문자가 포함된 경우 모든 프록시 자격 증명이 URL로 인코딩되었는지 확인합니다. + 비프록시 목록에 필요한 모든 로컬 주소 및 AWS 서비스 엔드포인트가 포함되어 있는지 확인합니다. + HTTPS 프록시의 경우 제공된 CA 인증서가 PEM 형식인지 확인합니다. + 설치 로그에서 문제의 원인을 나타낼 수 있는 특정 오류 메시지를 검토합니다. + 프록시 연결을 독립적으로 테스트하여 올바르게 작동하는지 확인합니다. ## 에서 AWS IoT SiteWise Edge 애플리케이션 문제 해결 Siemens Industrial Edge Siemens Industrial Edge 디바이스에서 AWS IoT SiteWise Edge 애플리케이션의 문제를 해결하려면 Siemens Industrial Edge Management 또는 Siemens Industrial Edge 디바이스(IED) 포털을 통해 애플리케이션의 로그에 액세스할 수 있습니다. 자세한 내용은 Siemens 설명서의 [로그 다운로드](https://docs.eu1.edge.siemens.cloud/build_a_device/device_building/concepts/howto-download-edge-device-logs.html)를 참조하세요. ### 내 데이터가에 표시되지 않음 AWS IoT SiteWise + Databus 사용자에게 문제가 없고 **Databus\$1Configuration**의 체크 표시 아이콘이 회색이 아닌 녹색인지 확인합니다. + Secure Storage가 포함된 버전에서 Siemens Industrial Edge Management를 실행하지 않을 수 있습니다. Siemens OS 버전을 업그레이드합니다. 자세한 내용은 [Siemens Secure Storage 및 AWS IoT SiteWise Edge 애플리케이션](sitewise-edge-on-siemens.md#sa-secure-storage) 단원을 참조하십시오. ### 로그에 'Config 파일 누락 AWS\$1REGION'이 표시됩니다. Siemens 로그에 `Config file missing AWS_REGION`이 표시되면 구성 파일의 JSON이 손상된 것입니다. 새 구성 파일을 생성해야 합니다. [Siemens Industrial Edge의 게이트웨이 생성](sa-create-config.md)의 단계에 따라 새 구성 파일을 생성합니다. ### Edge 게이트웨이 구성에 '동기화되지 않음' 오류 메시지가 표시됩니다. 배포가 완료된 후 Siemens Industrial Edge 게이트웨이에 `Out of sync` 오류 메시지가 표시되면 IoT SiteWise 게시자 구성 요소가 게이트웨이와 동기화되지 않은 것입니다. IoT SiteWise 게시자 구성 요소는 Siemens Industrial Edge 게이트웨이의 백그라운드에서 작동하여 MQTT 주제 기능을 제공합니다. `iotsitewise:publisher:3` 대신 기능 네임스페이스를 사용하도록 Siemens Industrial Edge 게이트웨이를 업그레이드했습니다`iotsitewise:publisher:2`. 게시자의 최신 버전으로 업데이트하여이 문제를 해결할 수 있습니다. **IoT SiteWise 게시자의 최신 버전으로 업그레이드하려면** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 창에서 **엣지 게이트웨이**를 선택합니다. 1. 편집할 Siemens Industrial Edge 게이트웨이를 선택합니다. 1. **엣지 기능** 섹션에서 **소프트웨어 버전 보기를** 선택합니다. 1. 게시자 드롭다운 메뉴에서 IoT SiteWise **게시**자의 최신 버전을 선택합니다. 1. **완료**를 선택합니다. ## Edge에서 오픈 소스 통합 문제 해결 이 섹션에서는 오픈 소스 도구를 SiteWise Edge와 통합할 때 발생할 수 있는 일반적인 문제에 대한 솔루션을 제공합니다. **참고** Node-RED®, InfluxDB® 및 Grafana®는 SiteWise Edge의 공급업체 또는 공급업체가 아닙니다. ### 연결 문제 Node-RED가 MQTT 브로커에 연결할 수 없음 MQTT 브로커가 실행 중이고 지정된 포트에서 액세스할 수 있는지 확인합니다. 네트워크 구성을 확인하고 브로커 주소가 올바른지 확인합니다. MQTT 브로커 상태를 확인하려면 다음을 실행합니다. ``` docker ps | grep emqx ``` InfluxDB 연결 오류 인증 토큰이 유효하고 올바른 조직 및 버킷 이름을 지정했는지 확인합니다. InfluxDB가 실행 중이고 액세스할 수 있는지 확인합니다. InfluxDB 상태를 확인하려면 다음을 실행합니다. ``` curl -I http://localhost:8086 ``` Grafana가 InfluxDB에 연결할 수 없음 URL, 인증 토큰, 조직 및 버킷을 포함하여 Grafana의 InfluxDB 데이터 소스 구성이 올바른지 확인합니다. ### 데이터 흐름 문제 에 데이터가 표시되지 않음 AWS IoT SiteWise Node-RED 흐름의 속성 별칭이 예상 형식과 일치하는지 확인합니다. MQTT 주제 구조가 올바른지, SiteWise Edge 게이트웨이가 MQTT 브로커로부터 데이터를 수신하도록 올바르게 구성되어 있는지 확인합니다. InfluxDB에 저장된 SiteWise Edge 데이터 없음 Node-RED 보존 흐름이 올바르게 구성되었고 InfluxDB 라이터 노드에 적절한 버킷 및 측정 설정이 있는지 확인합니다. Node-RED 디버그 출력에서 오류가 있는지 확인합니다. 데이터 형식 오류 데이터 변환 함수가 형식 간에 데이터를 올바르게 변환하는지 확인합니다. Node-RED 디버그 노드를 사용하여 흐름의 각 단계에서 데이터를 검사합니다. ### 성능 문제 높은 CPU 또는 메모리 사용량 리소스 사용량을 모니터링하고 필요에 따라 구성 요소의 구성을 조정합니다. 데이터 수집 빈도를 줄이거나 데이터 필터링을 구현하여 처리 부하를 줄이는 것이 좋습니다. 리소스 사용량을 모니터링하려면 다음을 실행합니다. ``` docker stats ``` 느린 Grafana 대시보드 로드 InfluxDB 쿼리를 최적화하고 대시보드 패널에 시간 범위 제한을 추가하는 것이 좋습니다. 적절한 집계 함수를 사용하여 표시되는 데이터 포인트 수를 줄입니다. ### 로깅 및 진단 문제를 해결하려면 각 구성 요소의 로그를 확인합니다. 노드-빨간색 로그 Node-RED 콘솔에서 로그를 보거나 다음을 실행합니다. ``` docker logs node-red ``` InfluxDB 로그 다음을 실행하여 로그에 액세스합니다. ``` docker logs influxdb ``` Grafana 로그 다음을 실행하여 로그를 봅니다. ``` docker logs grafana ``` SiteWise Edge 로그 SiteWise Edge 게이트웨이 로그에서 MQTT 연결 및 데이터 처리 문제를 확인합니다. 자세한 내용은 [SiteWise Edge 게이트웨이 문제 해결](#troubleshooting-gateway) 단원을 참조하십시오. ## AWS IoT Greengrass 문제 해결 SiteWise Edge 게이트웨이를 구성하거나 배포하는 데 발생하는 여러 문제에 대한 해결 방법은 *AWS IoT Greengrass 개발자 안내서*의 [문제 해결을 AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-troubleshooting.html) AWS IoT Greengrass참조하세요. # AWS IoT SiteWise 포털 문제 해결 AWS IoT SiteWise 포털의 일반적인 문제를 해결합니다. ## 사용자와 관리자는 AWS IoT SiteWise 포털에 액세스할 수 없습니다. 사용자 또는 관리자가 AWS IoT SiteWise 포털에 액세스할 수 없는 경우 로그인 성공을 방해하는 연결된 AWS Identity and Access Management (IAM) 정책에서 제한된 권한이 있을 수 있습니다. 로그인 실패로 이어지는 IAM 정책의 다음 예를 참조하세요. **참고** `"Condition"` 요소가 포함된 IAM 정책을 첨부하면 로그인에 실패합니다. **예 1**: 이 조건은 제한된 IP이며, 이로 인해 로그인에 실패합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "IpAddress": { "aws:SourceIp": [ "203.0.113.0/24" ] } } } ] } ``` ------ **예 2**: 이 조건은 포함된 태그이며, 이로 인해 로그인에 실패합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "StringLike": { "aws:ResourceTag/project": "*" } } } ] } ``` ------ 포털에 사용자나 관리자를 추가할 때 제한된 IP와 같이 사용자 권한을 제한하는 IAM 정책을 생성하지 마세요. 권한이 제한된 연결된 정책은 AWS IoT SiteWise 포털에 연결할 수 없습니다. # AWS IoT SiteWise 규칙 작업 문제 해결 에서 AWS IoT SiteWise 규칙 작업의 문제를 해결하려면 다음 절차 중 하나를 수행할 AWS IoT Core수 있습니다. + Amazon CloudWatch Logs 구성 + 규칙에 대한 재게시 오류 작업 구성 그 다음 오류 메시지를 이 주제의 오류와 비교하여 문제를 해결합니다. **Topics** + [AWS IoT Core 로그 구성](#configure-iot-logs) + [재게시 오류 작업 구성](#configure-republish-error-action) + [규칙 문제 해결](#troubleshoot-rule-issues) + [규칙 문제 해결(AWS IoT SiteWise)](#rule-tutorial-troubleshoot-rule) + [규칙 문제 해결(DynamoDB)](#dynamodb-tutorial-troubleshoot-rule) ## AWS IoT Core 로그 구성 CloudWatch Logs에 다양한 수준의 정보를 로깅 AWS IoT 하도록를 구성할 수 있습니다. **CloudWatch Logs를 구성하고 액세스하려면 다음을 수행하세요.** 1. 에 대한 로깅을 구성하려면 *AWS IoT 개발자 안내서*의 [ CloudWatch Logs를 사용한 모니터링을](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) AWS IoT Core참조하세요. 1. [CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch/)로 이동합니다. 1. 탐색 창에서 **로그 그룹**을 선택합니다. 1. **AWSIotLogs** 그룹을 선택합니다. 1. 최근 로그 스트림을 선택합니다. 기본적으로 CloudWatch는 가장 최근 로그 스트림을 먼저 표시합니다. 1. 로그 항목을 선택하여 로그 메시지를 확장합니다. 로그 항목은 다음 스크린샷처럼 보일 수 있습니다. ![\[CloudWatch "AWS IoT Logs" 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-logs-console.png) 1. 오률 메시지를 이 주제의 오류와 비교하여 문제를 해결합니다. ## 재게시 오류 작업 구성 오류 메시지를 처리하도록 규칙에 대한 오류 작업을 구성할 수 있습니다. 이 절차에서는 MQTT 테스트 클라이언트에서 오류 메시지를 보기 위해 재게시 규칙 작업을 오류 작업으로 구성합니다. **참고** 재게시 오류 작업은 `ERROR` 수준 로그와 동일한 로그만 출력합니다. 상세 로그를 보려면 [CloudWatch Logs를 구성](#configure-iot-logs)해야 합니다. **규칙에 재게시 오류 작업 추가** 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)로 이동합니다. 1. 왼쪽 탐색 창에서 **작업**을 선택한 다음 **규칙**을 선택합니다. 1. 규칙을 선택합니다. 1. **오류 작업**에서 **작업 추가**를 선택합니다. 1. ** AWS IoT 주제에 메시지 다시 게시를** 선택합니다. ![\[AWS IoT Core 재게시 작업이 강조 표시된 “작업 선택” 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/rule-ingestion/rule-choose-republish-action-console.png) 1. 페이지 하단에서 **작업 구성**을 선택합니다. 1. **주제에** 고유한 주제(예: **sitewise/windfarm/rule/error**)를 입력합니다. AWS IoT Core 는이 주제에 오류 메시지를 다시 게시합니다. 1. **선택을** 선택하여 오류 작업을 수행할 수 있는 AWS IoT Core 액세스 권한을 부여합니다. 1. 규칙에 대해 생성한 역할 옆에 있는 **선택**을 선택합니다. 1. **역할 업데이트**를 선택하여 역할에 권한을 더 추가합니다. 1. **작업 추가**를 선택합니다. 규칙의 오류 작업은 다음 스크린샷과 비슷해야 합니다. ![\[AWS IoT Core "규칙" 페이지 오류 작업 다시 게시 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/rule-ingestion/rule-confirm-republish-error-action-console.png) 1. 콘솔의 왼쪽 상단에 있는 뒤로 화살표를 선택하여 AWS IoT 콘솔 홈으로 돌아갑니다. 재게시 오류 작업을 설정한 후에는 AWS IoT Core의 MQTT 테스트 클라이언트에서 오류 메시지를 볼 수 있습니다. 다음 절차에서는 MQTT 테스트 클라이언트에서 오류 주제를 구독합니다. MQTT 테스트 클라이언트에서 규칙의 오류 메시지를 받아 문제를 해결할 수 있습니다. **오류 작업 주제 구독** 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)로 이동합니다. 1. 왼쪽 탐색 페이지에서 **테스트**를 선택하여 MQTT 테스트 클라이언트를 엽니다. 1. **구독 주제** 필드에 이전에 구성한 오류 주제(예: **sitewise/windfarm/rule/error**)를 입력하고 **주제 구독**을 선택합니다. ![\[AWS IoT Core "주제 구독" 버튼이 강조 표시된 "MQTT 클라이언트" 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-subscribe-error-topic-console.png) 1. 오류 메시지가 나타나는지 확인한 다음 오류 메시지에서 `failures` 배열을 확장합니다. 그런 다음 오류 메시지를 이 주제의 오류와 비교하여 문제를 해결합니다. ## 규칙 문제 해결 다음 정보를 사용하여 규칙 문제를 해결합니다. **Topics** + [오류: 멤버는 현재 타임스탬프 전 604800초, 후 300초 이내에 있어야 합니다.](#rule-error-timestamp-out-of-range) + [오류: 속성 값이 데이터 유형 이 일치하지 않습니다.](#rule-error-invalid-data-type) + [오류: 사용자 이 수행할 권한이 없음: iotsitewise:BatchPutAssetPropertyValue on resource](#rule-error-role-not-authorized) + [오류: iot.amazonaws.com이 수행할 수 없음: sts:AssumeRole on resource: ](#rule-error-unable-to-assume-role) + [정보: 요청이 전송되지 않았습니다. 대체 템플릿을 수행한 후 PutAssetPropertyValueEntries가 비어 있습니다.](#rule-info-request-was-empty) ### 오류: 멤버는 현재 타임스탬프 전 604800초, 후 300초 이내에 있어야 합니다. 타임스탬프는 현재 Unix 에포크 시간과 비교하여 7일 이전 또는 5분 이후입니다. 다음을 시도해 보세요. + 타임스탬프가 Unix 에포크 시간(UTC)인지 확인합니다. 다른 시간대로 타임스탬프를 제공하면 이 오류가 표시됩니다. + 타임스탬프가 초 단위인지 확인합니다. 타임스탬프가 초 단위의 시간(Unix epoch 시간)으로 분할되고 나노초 단위로 오프셋될 것으로 AWS IoT SiteWise 예상합니다. + 지난 7일 이내로 타임스탬프가 지정된 데이터를 업로드하고 있는지 확인합니다. ### 오류: 속성 값이 데이터 유형 이 일치하지 않습니다. 규칙 작업의 항목에는 대상 자산 속성이 아닌 다른 데이터 유형이 있습니다. 예를 들어 대상 자산 속성이 `DOUBLE`이고 선택한 데이터 유형이 **정수**이거나 `integerValue`에서 값을 전달했습니다. 다음을 시도해 보세요. + AWS IoT 콘솔에서 규칙을 구성하는 경우 각 항목에 대해 올바른 **데이터 유형을** 선택했는지 확인합니다. + API 또는 AWS Command Line Interface (AWS CLI)에서 규칙을 구성하는 경우 `value` 객체가 올바른 유형 필드(예: `DOUBLE` 속성)를 사용하는`doubleValue`지 확인합니다. ### 오류: 사용자 이 수행할 권한이 없음: iotsitewise:BatchPutAssetPropertyValue on resource 규칙이 대상 자산 속성에 액세스할 권한이 없거나 대상 자산 속성이 존재하지 않습니다. 다음을 시도해 보세요. + 속성 별칭이 올바른지와 지정된 속성 별칭이 있는 자산 속성이 있는지 확인합니다. 자세한 내용은 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md) 단원을 참조하십시오. + 규칙에 역할이 있는지와 역할이 대상 자산 속성(예: 대상 자산 계층 구조)에 대한 `iotsitewise:BatchPutAssetPropertyValue` 권한을 허용하는지 확인합니다. 자세한 내용은 [AWS IoT 필요한 액세스 권한 부여](grant-rule-access.md) 단원을 참조하세요. ### 오류: iot.amazonaws.com이 수행할 수 없음: sts:AssumeRole on resource: 사용자는 AWS Identity and Access Management (IAM)에서 규칙에 대한 역할을 수임할 권한이 없습니다. 사용자에게 규칙의 역할에 대한 `iam:PassRole` 권한이 허용되는지 확인합니다. 자세한 내용은 *AWS IoT 개발자 가이드*의 [역할 전달 권한](https://docs.aws.amazon.com/iot/latest/developerguide/pass-role.html) 단원을 참조하세요. ### 정보: 요청이 전송되지 않았습니다. 대체 템플릿을 수행한 후 PutAssetPropertyValueEntries가 비어 있습니다. **참고** 이 메시지는 `INFO` 수준 로그입니다. 요청에 모든 필수 파라미터가 포함된 항목이 하나 이상 있어야 합니다. 대체 템플릿을 포함한 규칙의 파라미터가 비어 있지 않은 값을 생성하는지 확인합니다. 대체 템플릿은 규칙 쿼리 문의 `AS` 절에 정의된 값에 액세스할 수 없습니다. 자세한 내용은 *AWS IoT 개발자 가이드*의 [대체 템플릿](https://docs.aws.amazon.com/iot/latest/developerguide/iot-substitution-templates.html)을 참조하세요. ## 규칙 문제 해결(AWS IoT SiteWise) CPU 및 메모리 사용량 데이터가 예상 AWS IoT SiteWise 대로에 표시되지 않는 경우이 절차의 단계에 따라 규칙 문제를 해결합니다. 이 절차에서는 MQTT 테스트 클라이언트에서 오류 메시지를 보기 위해 재게시 규칙 작업을 오류 작업으로 구성합니다. 문제 해결을 위해 CloudWatch 로깅에 로깅을 구성할 수도 있습니다. 자세한 내용은 [AWS IoT SiteWise 규칙 작업 문제 해결](#troubleshoot-rule) 단원을 참조하세요. **규칙에 재게시 오류 작업 추가** 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)로 이동합니다. 1. 왼쪽 탐색 창에서 **메시지 라우팅**을 선택한 다음 **규칙**을 선택합니다. 1. 이전에 생성한 규칙을 선택하고 **편집**을 선택합니다. 1. **오류 작업 - *선택 사항***에서 **오류 작업 추가**를 선택합니다. 1. ** AWS IoT 주제에 메시지 다시 게시를** 선택합니다. 1. **주제에** 오류 경로(예: **sitewise/rule/tutorial/error**)를 입력합니다. AWS IoT Core 는이 주제에 오류 메시지를 다시 게시합니다. 1. 앞서 생성한 역할(예: **SiteWiseTutorialDeviceRuleRole**)을 선택합니다. 1. **업데이트**를 선택합니다. 재게시 오류 작업을 설정한 후에는 AWS IoT Core의 MQTT 테스트 클라이언트에서 오류 메시지를 볼 수 있습니다. 다음 절차에서는 MQTT 테스트 클라이언트에서 오류 주제를 구독합니다. **오류 작업 주제 구독** 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)로 이동합니다. 1. 왼쪽 탐색 페이지에서 **MQTT 테스트 클라이언트**를 선택하여 MQTT 테스트 클라이언트를 엽니다. 1. **주제 필터** 필드에서 **sitewise/rule/tutorial/error**를 입력한 다음 **구독**을 선택합니다. 오류 메시지가 나타나면 오류 메시지에서 `failures` 배열을 보고 문제를 진단합니다. 가능한 문제 및 해결 방법에 대한 자세한 내용은 [AWS IoT SiteWise 규칙 작업 문제 해결](#troubleshoot-rule) 단원을 참조하세요. 오류가 나타나지 않는 경우 규칙이 활성화되어 있고 오류 재게시 작업에서 구성한 것과 동일한 주제를 구독했는지 확인합니다. 그런 후에도 오류가 계속 나타나지 않으면 디바이스 스크립트가 실행 중이고 디바이스 섀도우를 성공적으로 업데이트하는지 확인하세요. **참고** 디바이스의 섀도우 업데이트 주제를 구독하여 AWS IoT SiteWise 작업에서 구문 분석하는 페이로드를 볼 수도 있습니다. 이렇게 하려면 다음 주제를 구독하세요. ``` $aws/things/+/shadow/update/accepted ``` ## 규칙 문제 해결(DynamoDB) 데모 자산 데이터가 예상대로 DynamoDB 테이블에 표시되지 않는 경우 이 절차의 단계에 따라 규칙 문제를 해결합니다. 이 절차에서는 MQTT 테스트 클라이언트에서 오류 메시지를 보기 위해 재게시 규칙 작업을 오류 작업으로 구성합니다. 문제 해결을 위해 CloudWatch 로깅에 로깅을 구성할 수도 있습니다. 자세한 내용을 알아보려면 *AWS IoT 개발자 가이드*의 [CloudWatch Logs를 통해 모니터링](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html)을 참조하세요. **규칙에 재게시 오류 작업 추가** 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)로 이동합니다. 1. 왼쪽 탐색 창에서 **작업**을 선택한 다음 **규칙**을 선택합니다. 1. 앞서 생성한 규칙을 선택합니다. ![\[AWS IoT 코어 "규칙" 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-rule-console.png) 1. **오류 작업**에서 **작업 추가**를 선택합니다. 1. ** AWS IoT 주제에 메시지 다시 게시를** 선택합니다. ![\[AWS IoT 재게시 작업이 강조 표시된 코어 "작업 선택" 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-republish-action-console.png) 1. 페이지 하단에서 **작업 구성**을 선택합니다. 1. **주제**에 **windspeed/error**를 입력합니다. AWS IoT Core는이 주제에 오류 메시지를 다시 게시합니다. ![\[AWS IoT "주제"가 강조 표시된 코어 "재게시 작업 구성" 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-configure-republish-action-console.png) 1. **선택을** 선택하여 이전에 생성한 역할을 사용하여 오류 작업을 수행할 수 있는 AWS IoT 코어 액세스 권한을 부여합니다. 1. 해당 역할 옆에 있는 **선택**을 선택합니다. ![\[AWS IoT 역할 선택 버튼이 강조 표시된 코어 "재게시 작업 구성" 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-select-role-console.png) 1. **역할 업데이트**를 선택하여 역할에 권한을 더 추가합니다. ![\[AWS IoT 역할 업데이트 버튼이 강조 표시된 코어 "재게시 작업 구성" 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-update-role-console.png) 1. **작업 추가**를 선택하여 오류 작업 추가를 완료합니다. 1. 콘솔 왼쪽 상단의 뒤로 화살표를 선택하여 AWS IoT 코어 콘솔 홈으로 돌아갑니다. 재게시 오류 작업을 설정한 후 AWS IoT 코어의 MQTT 테스트 클라이언트에서 오류 메시지를 볼 수 있습니다. 다음 절차에서는 MQTT 테스트 클라이언트에서 오류 주제를 구독합니다. **오류 작업 주제 구독** 1. AWS IoT 코어 콘솔의 왼쪽 탐색 페이지에서 **테스트를** 선택합니다. 1. **구독 주제** 필드에 **windspeed/error**를 입력하고 **주제 구독**을 선택합니다. ![\[AWS IoT "주제 구독" 버튼이 강조 표시된 코어 "MQTT 클라이언트" 페이지 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-subscribe-error-topic-console.png) 1. 오류 메시지가 나타나는지 확인하고 오류 메시지에서 `failures` 배열을 탐색하여 다음과 같은 일반적인 문제를 진단합니다. + 규칙 쿼리 문의 오타 + 역할 권한 부족 오류가 나타나지 않는 경우 규칙이 활성화되어 있고 오류 재게시 작업에서 구성한 것과 동일한 주제를 구독했는지 확인합니다. 그래도 오류가 나타나지 않으면 데모 풍력 발전소 자산이 여전히 존재하고 풍속 속성에 대한 알림을 활성화했는지 확인합니다. 데모 자산이 만료되고 사라진 경우 새 데모를 생성하고 규칙 쿼리 문을 업데이트하여 업데이트된 자산 모델 및 속성 ID를 반영 AWS IoT SiteWise할 수 있습니다. IDs # 일괄 가져오기 및 내보내기 작업 문제 해결 전송 작업 중에 발생한 오류를 처리하고 진단하려면 AWS IoT TwinMaker **GetMetadataTransferJob** API를 참조하세요. 1. 전송 작업을 생성하고 실행한 후 **GetMetadataTransferJob** API를 직접적으로 호출합니다. ``` aws iottwinmaker get-metadata-transfer-job \ --metadata-transfer-job-id your_metadata_transfer_job_id \ --region us-east-1 ``` 1. 작업 상태가 다음 상태 중 하나로 변경됩니다. + COMPLETED + 취소됨 + ERROR 1. **GetMetadataTransferJob** API는 [MetadataTransferJobProgress](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html) 객체를 반환합니다. 1. **MetadataTransferJobProgress** 객체는 다음 파라미터를 포함합니다. + **failedCount**: 전송 프로세스 중에 실패한 자산 수를 나타냅니다. + **skippedCount**: 전송 프로세스 중에 건너뛴 자산 수를 나타냅니다. + **succeededCount**: 전송 프로세스 중에 성공한 자산 수를 나타냅니다. + **totalCount**: 전송 프로세스와 관련된 총 자산 수를 나타냅니다. 1. 또한 미리 서명된 URL이 포함된 API 직접 호출을 통해 **reportUrl** 요소가 반환됩니다. 전송 작업에 조사가 필요한 오류가 있는 경우 이 URL에서 전체 오류 보고서를 다운로드할 수 있습니다.