SiteWise 에지 게이트웨이 문제 해결 - AWS IoT SiteWise

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

SiteWise 에지 게이트웨이 문제 해결

AWS IoT SiteWise 에지 게이트웨이는 구성 요소 세트를 실행합니다. AWS IoT Greengrass Amazon CloudWatch 및 SiteWise Edge 게이트웨이의 로컬 파일 시스템에 이벤트를 기록하도록 SiteWise Edge 게이트웨이를 구성할 수 있습니다. 그런 다음 로그 파일을 보고 SiteWise 에지 게이트웨이 문제를 해결할 수 있습니다.

SiteWise 에지 게이트웨이가 보고한 CloudWatch 메트릭을 보고 연결 또는 데이터 스트림 관련 문제를 해결할 수도 있습니다. 자세한 정보는 Amazon AWS IoT SiteWise CloudWatch 메트릭을 사용한 모니터링을 참조하세요.

SiteWise 에지 게이트웨이 로그 구성 및 액세스

SiteWise Edge 게이트웨이 로그를 보려면 먼저 Amazon Logs로 로그를 전송하거나 로컬 파일 시스템에 CloudWatch 로그를 저장하도록 SiteWise Edge 게이트웨이를 구성해야 합니다.

  • 를 사용하여 SiteWise 에지 게이트웨이의 로그 파일을 AWS Management Console 보려면 CloudWatch 로그를 사용하십시오. 자세한 정보는 아마존 CloudWatch 로그 사용을 참조하세요.

  • 명령줄 또는 로컬 소프트웨어를 사용하여 SiteWise Edge 게이트웨이의 로그 파일을 보려면 로컬 파일 시스템 로그를 사용하십시오. 자세한 정보는 서비스 로그 사용을 참조하세요.

SiteWise 에지 게이트웨이 문제 해결

다음 정보를 사용하여 SiteWise 에지 게이트웨이 문제를 해결하십시오.

SiteWise 에지 게이트웨이에 팩을 배포할 수 없습니다.

AWS IoT Greengrass nucleus 구성 요소 (aws.greengrass.Nucleus) 가 최신 버전이 아닌 경우 SiteWise Edge 게이트웨이에 팩을 배포하지 못할 수 있습니다. AWS IoT Greengrass V2 콘솔을 사용하여 AWS IoT Greengrass nucleus 구성 요소를 업그레이드할 수 있습니다.

AWS IoT Greengrass 핵 구성 요소 업그레이드 (콘솔)
  1. AWS IoT Greengrass 콘솔로 이동합니다.

  2. 탐색 창의 AWS IoT Greengrass에서 배포를 선택합니다.

  3. 배포 목록에서 수정하려는 배포를 선택합니다.

  4. 수정을 선택합니다.

  5. 대상 지정 페이지에서 다음을 선택합니다.

  6. 구성 요소 선택 페이지의 퍼블릭 구성 요소에서 검색 상자에 aws.greengrass.Nucleus를 입력한 다음 aws.greengrass.Nucleus를 선택합니다.

  7. 다음을 선택합니다.

  8. 구성 요소 구성 페이지에서 다음을 선택합니다.

  9. 고급 설정 구성 페이지에서 다음을 선택합니다.

  10. 검토 페이지에서 배포를 선택합니다.

AWS IoT SiteWise OPC-UA 서버로부터 데이터를 받지 않음

AWS IoT SiteWise 자산이 OPC-UA 서버에서 전송한 데이터를 수신하지 않는 경우 SiteWise 에지 게이트웨이의 로그를 검색하여 문제를 해결할 수 있습니다. 다음 메시지가 포함된 정보 수준 swPublisher 로그를 찾습니다.

Emitting diagnostic name=PublishError.SomeException

로그 유형에 SomeException따라 다음 예외 유형과 해당 문제를 사용하여 Edge 게이트웨이 문제를 해결하십시오. SiteWise

  • ResourceNotFoundException— OPC-UA 서버가 자산의 속성 별칭과 일치하지 않는 데이터를 전송하고 있습니다. 이 예외는 두 가지 경우에 발생할 수 있습니다.

    • 속성 별칭은 정의한 원본 접두사를 포함해 OPC-UA 변수와 정확히 일치하지 않습니다. 속성 별칭 및 원본 접두사가 올바른지 확인합니다.

    • OPC-UA 변수를 자산 속성에 매핑하지 않았습니다. 자세한 정보는 산업 데이터 스트림을 자산 속성에 매핑을 참조하세요.

      원하는 OPC-UA 변수를 모두 이미 매핑한 경우 Edge 게이트웨이가 보내는 OPC-UA 변수를 필터링할 수 있습니다. AWS IoT SiteWise SiteWise 자세한 정보는 OPC-UA 노드 필터 사용을 참조하세요.

  • InvalidRequestException— OPC-UA 변수 데이터 유형이 자산 자산 자산 데이터 유형과 일치하지 않습니다. 예를 들어 OPC-UA 변수가 정수 데이터 형식인 경우, 해당 자산 속성은 정수 데이터 유형이어야 합니다. double 형식의 자산 속성은 OPC-UA 정수 값을 받을 수 없습니다. 이 문제를 해결하려면 새 속성을 올바른 데이터 형식으로 정의합니다.

  • TimestampOutOfRangeException— SiteWise 에지 게이트웨이가 허용 범위를 벗어나는 데이터를 전송하고 있습니다. AWS IoT SiteWise AWS IoT SiteWise 과거 7일 이전 또는 5분 이후의 타임스탬프가 있는 모든 데이터 포인트를 거부합니다. SiteWise 에지 게이트웨이의 전원이 끊기거나 AWS 클라우드와의 연결이 끊긴 경우 SiteWise 에지 게이트웨이의 캐시를 지워야 할 수 있습니다.

  • ThrottlingException또는 LimitExceededException— 요청이 AWS IoT SiteWise 서비스 할당량을 초과했습니다 (예: 수집된 데이터 포인트 비율 또는 자산 자산 데이터 API 작업에 대한 요청 속도). 구성이 AWS IoT SiteWise 할당량를 초과하지 않는지 확인합니다.

대시보드에 데이터가 표시되지 않았습니다.

대시보드에 데이터가 표시되지 않는 경우 게시자 구성과 SiteWise Edge Gateway의 데이터 원본이 동기화되지 않을 수 있습니다. 동기화되지 않은 경우 데이터 원본 이름을 업데이트하면 클라우드에서 엣지로의 동기화가 빨라져 동기화 중단 오류가 해결될 수 있습니다.

데이터 소스 이름을 업데이트하려면
  1. AWS IoT SiteWise 콘솔로 이동합니다.

  2. 탐색 창에서 Edge Gateways를 선택합니다.

  3. 대시보드에 연결된 SiteWise 에지 게이트웨이를 선택합니다.

  4. 데이터 소스에서 편집을 선택합니다.

  5. 새 소스 이름을 선택하고 저장을 선택하여 변경 내용을 확인합니다.

  6. 데이터 원본 테이블에서 데이터 원본 이름이 업데이트되었는지 확인하여 변경 내용을 확인합니다.

aws.iot에 “기본 클래스를 찾거나 로드할 수 없습니다”라는 메시지가 표시됩니다. SiteWiseEdgePublisher /greengrass/v2/logs의 로그 오류

이 오류가 표시되면 Edge 게이트웨이의 Java 버전을 업데이트해야 할 수 있습니다. SiteWise

  • 터미널에서 다음 명령을 실행합니다.

    java -version

    SiteWise 에지 게이트웨이가 실행 중인 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 이상으로 업데이트해야 합니다. Java 버전 11.0.20.8.1만 영향을 받으며, 다른 Java 버전을 사용하는 환경에서는 이전 버전의 IoT SiteWise Publisher 구성 요소를 계속 사용할 수 있습니다. 구성 요소 팩 업데이트에 대한 자세한 내용은 SiteWise Edge 게이트웨이 구성 요소 팩의 버전 변경 단원을 참조하십시오.

문제 AWS IoT Greengrass 해결

SiteWise 에지 게이트웨이를 구성하거나 배포할 때 발생하는 여러 문제에 대한 AWS IoT Greengrass해결책을 찾으려면 AWS IoT Greengrass 개발자 안내서의 문제 해결을 AWS IoT Greengrass 참조하십시오.