Kinesis Video Streams용 엣지 커넥터
Kinesis Video Streams 구성 요소용 엣지 커넥터(aws.iot.EdgeConnectorForKVS
)는 로컬 카메라에서 비디오 피드를 읽고 스트림을 Kinesis Video Streams에 게시합니다. 실시간 스트리밍 프로토콜(RTSP)을 사용하여 인터넷 프로토콜(IP) 카메라에서 비디오 피드를 읽도록 이 구성 요소를 구성할 수 있습니다. 그런 다음 Amazon Managed Grafana 또는 로컬 Grafana 서버에서 대시보드를 설정하여 비디오 스트림을 모니터링하고 조작할 수 있습니다.
이 구성 요소를 AWS IoT TwinMaker와 통합하여 Grafana 대시보드에서 비디오 스트림을 표시하고 제어할 수 있습니다. AWS IoT TwinMaker는 물리적 시스템의 운영 디지털 트윈을 구축할 수 있게 하는 AWS 서비스입니다. AWS IoT TwinMaker를 사용하여 센서, 카메라 및 엔터프라이즈 애플리케이션의 데이터를 시각화하여 물리적 공장, 건물 또는 산업 플랜트를 추적할 수 있습니다. 이 데이터를 사용하여 작업을 모니터링하고 오류를 진단하고 오류를 수정할 수도 있습니다. 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 What is AWS IoT TwinMaker?를 참조하세요.
이 구성 요소는 산업 데이터를 모델링하고 저장하는 AWS 서비스인 AWS IoT SiteWise에 구성을 저장합니다. AWS IoT SiteWise에서 자산은 디바이스, 장비 또는 다른 객체 그룹과 같은 객체를 나타냅니다. 이 구성 요소를 구성하고 사용하려면 각 Greengrass 코어 디바이스와 각 코어 디바이스에 연결된 각 IP 카메라에 대한 AWS IoT SiteWise 자산을 생성합니다. 각 자산에는 라이브 스트리밍, 온디맨드 업로드, 로컬 캐싱과 같은 기능을 제어하도록 구성하는 속성이 있습니다. 각 카메라의 URL을 지정하려면 AWS Secrets Manager에서 카메라의 URL이 포함된 보안 암호를 생성합니다. 카메라에 인증이 필요한 경우 URL에 사용자 이름과 암호도 지정합니다. 그런 다음 IP 카메라의 자산 속성에서 해당 보안 암호를 지정합니다.
이 구성 요소는 각 카메라의 비디오 스트림을 Kinesis 비디오 스트림에 업로드합니다. 각 카메라의 AWS IoT SiteWise 자산 구성에서 대상 Kinesis 비디오 스트림의 이름을 지정합니다. Kinesis 비디오 스트림이 존재하지 않으면 이 구성 요소가 스트림을 생성합니다.
AWS IoT TwinMaker는 이러한 AWS IoT SiteWise 자산 및 Secrets Manager 보안 암호를 생성하기 위해 실행할 수 있는 스크립트를 제공합니다. 이러한 리소스를 생성하는 방법과 이 구성 요소를 설치, 구성 및 사용하는 방법에 대한 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker video integration을 참조하세요.
참고
Kinesis Video Streams 구성 요소용 엣지 커넥터는 다음 AWS 리전에서만 사용할 수 있습니다.
-
미국 동부(버지니아 북부)
-
미국 서부(오리건)
-
유럽(프랑크푸르트)
-
유럽(아일랜드)
-
아시아 태평양(싱가포르)
버전
이 구성 요소에는 다음과 같은 버전이 있습니다.
-
1.0.x
유형
이 구성 요소는 일반 구성 요소(aws.greengrass.generic
)입니다. Greengrass nucleus는 구성 요소의 수명 주기 스크립트를 실행합니다.
자세한 내용은 구성 요소 유형 섹션을 참조하세요.
운영 체제
이 구성 요소는 Linux 코어 디바이스에만 설치할 수 있습니다.
요구 사항
이 구성 요소의 요구 사항은 다음과 같습니다.
-
이 구성 요소는 구성 요소 구성이 각 코어 디바이스에 고유해야 하므로 단일 코어 디바이스에만 배포할 수 있습니다. 이 구성 요소를 코어 디바이스 그룹에 배포할 수 없습니다.
-
코어 디바이스에 설치된 GStreamer
1.18.4 이상. 자세한 내용은 Installing GStreamer 를 참조하세요. apt
가 있는 디바이스에서는 다음 명령을 실행하여 GStreamer를 설치할 수 있습니다.sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps sudo apt install -y gstreamer1.0-libav sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools
-
각 코어 디바이스의 AWS IoT SiteWise 자산. 이 AWS IoT SiteWise 자산은 코어 디바이스를 나타냅니다. 이 자산을 생성하는 방법에 대한 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker video integration을 참조하세요.
-
각 코어 디바이스에 연결하는 각 IP 카메라의 AWS IoT SiteWise 자산. 이러한 AWS IoT SiteWise 자산은 각 코어 디바이스로 비디오를 스트리밍하는 카메라를 나타냅니다. 각 카메라의 자산은 카메라에 연결된 코어 디바이스의 자산에 연결되어 있어야 합니다. 카메라 자산에는 Kinesis 비디오 스트림, 인증 보안 암호 및 비디오 스트리밍 파라미터를 지정하기 위해 구성할 수 있는 속성이 있습니다. 카메라 자산을 생성하고 구성하는 방법에 대한 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker video integration을 참조하세요.
-
각 IP 카메라의 AWS Secrets Manager 보안 암호. 이 보안 암호에서는 키-값 페어를 정의해야 하며, 여기서 키는
RTSPStreamUrl
이고 값은 카메라의 URL입니다. 카메라에 인증이 필요한 경우 이 URL에 사용자 이름과 암호를 포함합니다. 이 구성 요소에 필요한 리소스를 생성할 때 스크립트를 사용하여 보안 암호를 생성할 수 있습니다. 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker video integration을 참조하세요.Secrets Manager 콘솔 및 API를 사용하여 추가 보안 암호를 생성할 수도 있습니다. 자세한 내용은 AWS Secrets Manager 사용 설명서의 보안 암호 생성을 참조하세요.
-
다음 예제 IAM 정책에 표시된 대로 Greengrass 토큰 교환 역할에서 다음 AWS Secrets Manager, AWS IoT SiteWise 및 Kinesis Video Streams 작업을 허용해야 합니다.
참고
이 예제 정책에서는 디바이스가
IPCamera1Url
및IPCamera2Url
이라는 보안 암호 값을 가져올 수 있도록 허용합니다. 각 IP 카메라를 구성할 때 해당 카메라의 URL이 포함된 보안 암호를 지정합니다. 카메라에 인증이 필요한 경우 URL에 사용자 이름과 암호도 지정합니다. 코어 디바이스의 토큰 교환 역할에서 연결할 각 IP 카메라의 보안 암호에 대한 액세스를 허용해야 합니다.{ "Version": "2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:
region
:account-id
:secret:IPCamera1Url
", "arn:aws:secretsmanager:region
:account-id
:secret:IPCamera2Url
" ] }, { "Action": [ "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "kinesisvideo:CreateStream", "kinesisvideo:DescribeStream", "kinesisvideo:GetDataEndpoint", "kinesisvideo:PutMedia", "kinesisvideo:TagStream" ], "Effect": "Allow", "Resource": [ "*" ] } ] }참고
고객 관리형 AWS Key Management Service 키를 사용하여 보안 암호를 암호화하는 경우에는 디바이스 역할에서
kms:Decrypt
작업도 허용해야 합니다.
엔드포인트 및 포트
이 구성 요소는 기본 작업에 필요한 엔드포인트 및 포트 외에 다음 엔드포인트 및 포트에 대한 아웃바운드 요청도 수행할 수 있어야 합니다. 자세한 내용은 프록시 또는 방화벽을 통해 디바이스 트래픽 허용 섹션을 참조하세요.
엔드포인트 | 포트 | 필수 | 설명 |
---|---|---|---|
|
443 | 예 |
Kinesis Video Streams에 데이터를 업로드합니다. |
|
443 | 예 |
비디오 스트림 메타데이터를 AWS IoT SiteWise에 게시합니다. |
|
443 | 예 |
카메라 URL 보안 암호를 코어 디바이스로 다운로드합니다. |
의존성
구성 요소를 배포하면 AWS IoT Greengrass에서 해당 종속성의 호환 버전도 배포합니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 모든 해당 종속성에 대한 요구 사항을 충족해야 합니다. 이 단원에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 의미 체계 버전 제약 조건이 나열되어 있습니다. AWS IoT Greengrass 콘솔
다음 표에는 이 구성 요소의 버전 1.0.0~1.0.5에 대한 종속성이 나열되어 있습니다.
구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하세요.
구성
이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음 구성 파라미터를 제공합니다.
SiteWiseAssetIdForHub
-
이 코어 디바이스를 나타내는 AWS IoT SiteWise 자산의 ID입니다. 이 자산을 생성하고 사용하여 이 구성 요소와 연동하는 방법에 대한 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker video integration을 참조하세요.
예: 구성 병합 업데이트
{ "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }
라이선스
이 구성 요소에는 다음 타사 소프트웨어/라이선스가 포함되어 있습니다.
-
Quartz Job Scheduler
/Apache 라이선스 2.0 -
GStreamer용 Java 바인딩 1.x
/GNU Lesser General Public License v3.0
사용량
이 구성 요소를 구성하고 연동하려면 코어 디바이스와 코어 디바이스가 연결되는 IP 카메라를 나타내는 AWS IoT SiteWise 자산에서 속성을 설정할 수 있습니다. 또한 AWS IoT TwinMaker를 통해 Grafana 대시보드에서 비디오 스트림을 시각화하고 조작할 수 있습니다. 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker video integration을 참조하세요.
로컬 로그 파일
이 구성 요소는 다음 로그 파일을 사용합니다.
/logs/aws.iot.EdgeConnectorForKVS.log
/greengrass/v2
이 구성 요소의 로그를 보려면
-
코어 디바이스에서 다음 명령을 실행하여 실시간으로 이 구성 요소의 로그 파일을 봅니다.
를 AWS IoT Greengrass 루트 폴더의 경로로 바꿉니다./greengrass/v2
sudo tail -f
/logs/aws.iot.EdgeConnectorForKVS.log/greengrass/v2
Changelog
다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.
버전 |
변경 |
---|---|
1.0.5 |
일반적인 버그 수정 및 개선입니다. |
1.0.4 |
|
1.0.3 |
일반적인 버그 수정 및 개선입니다. |
1.0.1 |
일반적인 버그 수정 및 개선입니다. |
1.0.0 |
초기 버전 |
다음 사항도 참조하세요.
-
AWS IoT TwinMaker 사용 설명서의 What is AWS IoT TwinMaker?
-
AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker video integration
-
AWS IoT SiteWise 사용 설명서의 AWS IoT SiteWise란 무엇입니까?
-
AWS IoT SiteWise 사용 설명서의 속성 값 업데이트
-
AWS Secrets Manager 사용 설명서의 AWS Secrets Manager란 무엇입니까?
-
AWS Secrets Manager 사용 설명서의 보안 암호 생성 및 관리