IoT SiteWise 커넥터 - AWS IoT Greengrass
요구 사항파라미터입력 데이터출력 데이터Limits라이선스Changelog다음 사항도 참조하십시오.

AWS IoT Greengrass Version 1 는 2023년 6월 30일에 수명 연장 단계에 들어갔습니다. AWS IoT Greengrass V1 관리형 정책에 대한 자세한 정보는 섹션을 참조하세요. 이 날짜 이후에는 기능, 개선 사항, 버그 수정 또는 보안 패치를 제공하는 업데이트를 릴리스하지 AWS IoT Greengrass V1 않습니다. 에서 실행되는 디바이스는 중단 AWS IoT Greengrass V1 되지 않고 계속 작동하며 클라우드에 연결됩니다. 로 마이그레이션 AWS IoT Greengrass Version 2하는 것이 좋습니다. 이 마이그레이션하면 추가 플랫폼 에 대한 중요한 새 기능과 지원이 추가됩니다. https://docs.aws.amazon.com/greengrass/v2/developerguide/operating-system-feature-support-matrix.html

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

IoT SiteWise 커넥터

IoT SiteWise 커넥터는 로컬 장치 및 장비 데이터를 의 자산 자산으로 보냅니다AWS IoT SiteWise. 이 커넥터를 사용하여 여러 OPC-UA 서버에서 데이터를 수집하고 IoT에 게시할 수 있습니다. SiteWise 커넥터는 데이터를 현재 AWS 계정 및 리전의 자산 속성으로 보냅니다.

참고

SiteWise IoT는 산업용 장치 및 장비로부터 데이터를 수집, 처리 및 시각화하는 완전 관리형 서비스입니다. 이 커넥터에서 자산의 측정 속성으로 전송된 원시 데이터를 처리하는 자산 속성을 구성할 수 있습니다. 예를 들어 디바이스의 섭씨 온도 데이터 포인트를 화씨로 변환하는 변환 속성을 정의하거나 시간당 평균 온도를 계산하는 지표 속성을 정의할 수 있습니다. 자세한 내용은 AWS IoT SiteWise 사용 설명서의(AWS IoT SiteWise이)란 무엇입니까? 섹션을 참조하십시오.

커넥터는 OPC-UA 서버에서 전송된 OPC-UA 데이터 스트림 경로를 SiteWise 사용하여 IoT로 데이터를 전송합니다. 예를 들어, 데이터 흐름 경로 /company/windfarm/3/turbine/7/temperature는 풍력 발전소 #3 터빈 #7의 온도 센서를 나타낼 수 있습니다. AWS IoT Greengrass 코어에서 인터넷 연결이 끊어지면 커넥터는 AWS 클라우드 클라우드에 성공적으로 연결할 수 있을 때까지 데이터를 캐싱합니다. 데이터 캐싱에 사용되는 최대 디스크 버퍼 크기를 구성할 수 있습니다. 캐시 크기가 최대 디스크 버퍼 크기를 초과하면 커넥터는 대기열에서 가장 오래된 데이터를 폐기합니다.

IoT SiteWise 커넥터를 구성하고 배포한 후 IoT 콘솔에서 게이트웨이 및 OPC-UA 소스를 추가할 수 있습니다. SiteWise 콘솔에서 소스를 구성할 때 IoT 커넥터가 전송하는 OPC-UA 데이터 스트림 경로를 필터링하거나 접두사를 붙일 수 있습니다. SiteWise 게이트웨이 및 소스 설정을 완료하는 방법에 대한 지침은 AWS IoT SiteWise 사용 설명서의 게이트웨이 추가를 참조하십시오.

IoT는 IoT SiteWise 자산의 측정 속성에 매핑한 데이터 스트림에서만 데이터를 SiteWise 수신합니다. 데이터 스트림을 자산 속성에 매핑하려면 속성의 별칭을 OPC-UA 데이터 스트림 경로와 동일하게 설정할 수 있습니다. 자산 모델 정의 및 자산 생성에 대한 자세한 내용은 AWS IoT SiteWise 사용 설명서의 산업 자산 모델링을 참조하십시오.

참고

스트림 관리자를 사용하여 OPC-UA 서버 이외의 SiteWise 소스에서 IoT로 데이터를 업로드할 수 있습니다. 스트림 관리자는 또한 지속성 및 대역폭 관리를 위한 맞춤형 지원을 제공합니다. 자세한 설명은 AWS IoT Greengrass 코어에서 데이터 스트림 관리 섹션을 참조하세요.

이 커넥터는 컨테이너 없음 격리 모드에서 실행되므로, Docker 컨테이너에서 실행되는 Greengrass 그룹에 이 커넥터를 배포할 수 있습니다.

이 커넥터의 버전은 다음과 같습니다.

버전

ARN

12(권장)

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12

11

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11

10

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10

9

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9

8

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8

7

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7

6

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6

5

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5

4

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4

3

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3

2

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2

1

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1

버전 변경 사항에 대한 자세한 내용은 Changelog를 참조하십시오.

요구 사항

이 커넥터에는 다음과 같은 요구 사항이 있습니다.

Version 9, 10, 11, and 12
중요

이 버전에는 AWS IoT Greengrass 코어 소프트웨어 v1.10.0 및 스트림 관리자라는 새로운 요구 사항이 도입되었습니다.

  • AWS IoT Greengrass 코어 소프트웨어 v1.10.2.

  • Greengrass 그룹에 스트림 관리자가 활성화되어 있습니다.

  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Java 8입니다.

  • 이 SiteWise 커넥터는 IoT가 모두 AWS IoT Greengrass지원되는 Amazon Web Services 지역에서만 사용할 수 있습니다.

  • Greengrass 그룹 역할에 추가된 IAM 정책. 이 역할을 사용하면 다음 예제와 같이 AWS IoT Greengrass 그룹이 대상 루트 자산 및 해당 하위 자산에서 iotsitewise:BatchPutAssetPropertyValue 작업에 액세스할 수 있습니다. Condition정책에서 를 제거하여 커넥터가 모든 IoT SiteWise 자산에 액세스하도록 허용할 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    자세한 내용은 IAM 사용 설명서의 IAM 정책 추가 및 제거를 참조하세요.

Versions 6, 7, and 8
중요

이 버전에는 AWS IoT Greengrass 코어 소프트웨어 v1.10.0 및 스트림 관리자라는 새로운 요구 사항이 도입되었습니다.

  • AWS IoT Greengrass 코어 소프트웨어 v1.10.0.

  • Greengrass 그룹에 스트림 관리자가 활성화되어 있습니다.

  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Java 8입니다.

  • 이 SiteWise 커넥터는 IoT가 모두 AWS IoT Greengrass지원되는 Amazon Web Services 지역에서만 사용할 수 있습니다.

  • Greengrass 그룹 역할에 추가된 IAM 정책. 이 역할을 사용하면 다음 예제와 같이 AWS IoT Greengrass 그룹이 대상 루트 자산 및 해당 하위 자산에서 iotsitewise:BatchPutAssetPropertyValue 작업에 액세스할 수 있습니다. Condition정책에서 를 제거하여 커넥터가 모든 IoT SiteWise 자산에 액세스하도록 허용할 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    자세한 내용은 IAM 사용 설명서의 IAM 정책 추가 및 제거를 참조하세요.

Version 5

  • AWS IoT Greengrass 코어 소프트웨어 v1.9.4 이상.

  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Java 8입니다.

  • 이 SiteWise 커넥터는 IoT가 모두 AWS IoT Greengrass지원되는 Amazon Web Services 지역에서만 사용할 수 있습니다.

  • Greengrass 그룹 역할에 추가된 IAM 정책. 이 역할을 사용하면 다음 예제와 같이 AWS IoT Greengrass 그룹이 대상 루트 자산 및 해당 하위 자산에서 iotsitewise:BatchPutAssetPropertyValue 작업에 액세스할 수 있습니다. Condition정책에서 를 제거하여 커넥터가 모든 IoT SiteWise 자산에 액세스하도록 허용할 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    자세한 내용은 IAM 사용 설명서의 IAM 정책 추가 및 제거를 참조하세요.

Version 4

  • AWS IoT Greengrass 코어 소프트웨어 v1.10.0.

  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Java 8입니다.

  • 이 SiteWise 커넥터는 IoT가 모두 AWS IoT Greengrass지원되는 Amazon Web Services 지역에서만 사용할 수 있습니다.

  • Greengrass 그룹 역할에 추가된 IAM 정책. 이 역할을 사용하면 다음 예제와 같이 AWS IoT Greengrass 그룹이 대상 루트 자산 및 해당 하위 자산에서 iotsitewise:BatchPutAssetPropertyValue 작업에 액세스할 수 있습니다. Condition정책에서 를 제거하여 커넥터가 모든 IoT SiteWise 자산에 액세스하도록 허용할 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    자세한 내용은 IAM 사용 설명서의 IAM 정책 추가 및 제거를 참조하세요.

Version 3

  • AWS IoT Greengrass 코어 소프트웨어 v1.9.4 이상.

  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Java 8입니다.

  • 이 SiteWise 커넥터는 IoT가 모두 AWS IoT Greengrass지원되는 Amazon Web Services 지역에서만 사용할 수 있습니다.

  • Greengrass 그룹 역할에 추가된 IAM 정책. 이 역할을 사용하면 다음 예제와 같이 AWS IoT Greengrass 그룹이 대상 루트 자산 및 해당 하위 자산에서 iotsitewise:BatchPutAssetPropertyValue 작업에 액세스할 수 있습니다. Condition정책에서 를 제거하여 커넥터가 모든 IoT SiteWise 자산에 액세스하도록 허용할 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    자세한 내용은 IAM 사용 설명서의 IAM 정책 추가 및 제거를 참조하세요.

Versions 1 and 2

  • AWS IoT Greengrass 코어 소프트웨어 v1.9.4 이상.

  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Java 8입니다.

  • 이 SiteWise 커넥터는 IoT가 모두 AWS IoT Greengrass지원되는 Amazon Web Services 지역에서만 사용할 수 있습니다.

  • 다음 예제와 같이 대상 루트 자산 및 하위 자산에서 AWS IoT Core 및 iotsitewise:BatchPutAssetPropertyValue 작업에 대한 액세스를 허용하는 Greengrass 그룹 역할에 추가된 IAM 정책. Condition정책에서 를 제거하여 커넥터가 모든 IoT SiteWise 자산에 액세스하도록 허용할 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        },
        {
            "Effect": "Allow",
            "Action": [
                 "iot:Connect",
                 "iot:DescribeEndpoint",
                 "iot:Publish",
                 "iot:Receive",
                 "iot:Subscribe"
            ],
            "Resource": "*"
        }
    ]
}

    자세한 내용은 IAM 사용 설명서의 IAM 자격 증명 권한 추가 및 제거를 참조하세요.

파라미터

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12
SiteWiseLocalStoragePath

IoT SiteWise 커넥터가 영구 데이터를 쓸 수 있는 AWS IoT Greengrass 호스트의 디렉터리입니다. 기본값은 /var/sitewise입니다.

AWS IoT 콘솔의 표시 이름: 로컬 스토리지 경로

필수: false

유형: string

유효한 패턴: ^\s*$|\/.

AWSSecretsArnList

각각에 OPC-UA 사용자 이름과 암호 키-값 페어가 포함된 AWS Secrets Manager의 암호 목록입니다. 각 암호는 키-값 페어 유형 암호여야 합니다.

AWS IoT 콘솔의 표시 이름: OPC-UA 사용자 이름/비밀번호 암호의 ARN 목록

필수: false

유형: JsonArrayOfStrings

유효한 패턴: \[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]

MaximumBufferSize

IoT SiteWise 디스크 사용량의 최대 크기 (GB) 기본값은 10GB입니다.

AWS IoT 콘솔의 표시 이름: 최대 디스크 버퍼 크기

필수: false

유형: string

유효한 패턴: ^\s*$|[0-9]+

Version 1
SiteWiseLocalStoragePath

IoT SiteWise 커넥터가 영구 데이터를 쓸 수 있는 AWS IoT Greengrass 호스트의 디렉터리입니다. 기본값은 /var/sitewise입니다.

AWS IoT 콘솔의 표시 이름: 로컬 스토리지 경로

필수: false

유형: string

유효한 패턴: ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

OPC-UA 사용자 이름과 암호 키-값 페어가 포함된 AWS Secrets Manager의 암호입니다. 이 암호는 키-값 페어 유형 암호여야 합니다.

AWS IoT 콘솔의 표시 이름: OPC-UA 사용자 이름/암호 비밀의 ARN

필수: false

유형: string

유효한 패턴: ^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+

SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId

OPC-UA 사용자 이름 및 비밀번호 암호를 참조하는 AWS IoT Greengrass 그룹의 암호 리소스입니다.

AWS IoT 콘솔의 표시 이름: OPC-UA 사용자 이름/암호 비밀 리소스

필수: false

유형: string

유효한 패턴: ^$|.+

MaximumBufferSize

IoT SiteWise 디스크 사용량의 최대 크기 (GB) 기본값은 10GB입니다.

AWS IoT 콘솔의 표시 이름: 최대 디스크 버퍼 크기

필수: false

유형: string

유효한 패턴: ^\s*$|[0-9]+

커넥터 만들기 예(AWS CLI)

다음 AWS CLI 명령은 IoT SiteWise 커넥터가 ConnectorDefinition 포함된 초기 버전을 사용하여 a를 생성합니다.

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyIoTSiteWiseConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11"
        }
    ]
}'
참고

이 커넥터의 Lambda 함수에는 수명이 긴 수명 주기가 있습니다.

AWS IoT Greengrass 콘솔에서는 그룹의 커넥터 페이지에서 커넥터를 추가할 수 있습니다. 자세한 설명은 Greengrass 커넥터 시작하기(콘솔) 섹션을 참조하세요.

입력 데이터

이 커넥터는 MQTT 메시지를 출력 데이터로 게시하지 않습니다.

출력 데이터

이 커넥터는 MQTT 메시지를 출력 데이터로 게시하지 않습니다.

Limits

이 커넥터에는 다음을 포함하여 SiteWise IoT에서 부과하는 다음과 같은 모든 제한이 적용됩니다. 자세한 내용은 AWS 일반 참조의 AWS IoT SiteWise 엔드포인트 및 할당량을 참조하십시오.

  • AWS 계정당 최대 게이트웨이 수입니다.

  • 게이트웨이당 최대 OPC-UA 소스 수입니다.

  • 저장되는 데이터 포인트의 최대 속도 timestamp-quality-value (TQV) 입니다. AWS 계정

  • 자산 속성별로 저장된 TQV 데이터 포인트의 최대 비율입니다.

라이선스

Version 9, 10, 11, and 12

IoT SiteWise 커넥터에는 다음과 같은 타사 소프트웨어/라이선스가 포함됩니다.

이 커넥터는 Greengrass 코어 소프트웨어 라이선스 계약에 따라 릴리스됩니다.

Versions 6, 7, and 8

IoT SiteWise 커넥터에는 다음과 같은 타사 소프트웨어/라이선스가 포함됩니다.

이 커넥터는 Greengrass 코어 소프트웨어 라이선스 계약에 따라 릴리스됩니다.

Versions 1, 2, 3, 4, and 5

IoT SiteWise 커넥터에는 다음과 같은 타사 소프트웨어/라이선스가 포함됩니다.

이 커넥터는 Greengrass 코어 소프트웨어 라이선스 계약에 따라 릴리스됩니다.

Changelog

다음 표에서는 의 각 릴리스에서 변경된 중요 사항에 대해 설명합니다.

버전

변경

날짜

12

  • 이 버전에는 버그 수정이 포함되어 있습니다.

2021년 12월 22일

11

  • 숨겨진 문자 또는 인쇄할 수 없는 문자가 포함된 문자열을 지원합니다. 숨겨진 문자와 인쇄할 수 없는 문자는 문자열이 AWS 클라우드(으)로 전송되기 전에 자동으로 제거됩니다.

  • IoT SiteWise 게이트웨이가 잘못된 요청을 무한 재시도하던 문제를 수정했습니다.

  • IoT SiteWise 게이트웨이가 고주파 데이터 소스에 연결되었을 때 체크포인트가 손상되는 문제를 수정했습니다.

  • 게이트웨이 구성 문제를 해결하는 데 도움이 되도록 오류 메시지를 개선했습니다.

2021년 3월 24일

10

소스 연결이 끊겼다가 다시 설정되었을 때 처리를 개선하도록 StreamManager을(를) 구성하였습니다. 또한 이 버전은 SourceTimestamp을(를) 사용할 수 없을 때 ServerTimestamp와(과) 함께 OPC-UA 값을 허용합니다.

2021년 1월 22일

9

사용자 지정 Greengrass StreamManager 스트림 대상, OPC-UA 데드밴딩, 사용자 지정 스캔 모드 및 사용자 지정 스캔 속도에 대한 지원이 시작되었습니다. 또한 IoT SiteWise 게이트웨이에서 구성을 업데이트하는 동안 개선된 성능도 포함됩니다.

2020년 12월 15일

8

커넥터에 간헐적인 네트워크 연결이 발생할 때의 안정성이 개선되었습니다.

2020년 11월 19일

7

게이트웨이 지표 관련 문제가 해결되었습니다.

2020년 8월 14일

6

새로운 OPC-UA 태그의 CloudWatch 메트릭 및 자동 검색에 대한 지원이 추가되었습니다. 이 버전은 스트림 관리자와 AWS IoT Greengrass 코어 소프트웨어 v1.10.0 이상이 필요합니다.

2020년 4월 29일

5

AWS IoT Greengrass 코어 소프트웨어 v1.9.4와의 호환성 문제가 해결되었습니다.

2020년 2월 12일

4

OPC-UA 서버 재연결 문제가 해결되었습니다.

2020년 2월 7일

3

iot:* 권한 요구 사항이 제거되었습니다.

2019년 12월 17일

2

여러 OPC-UA 암호 리소스에 대한 지원이 추가되었습니다.

2019년 12월 10일

1

최초 릴리스.

2019년 12월 2일

Greengrass 그룹은 한 번에 하나의 커넥터 버전만 포함할 수 있습니다. 커넥터 버전 업그레이드에 대한 자세한 내용은 커넥터 버전 업그레이드을 참조하십시오.

다음 사항도 참조하십시오.