Kinesis Video Streams용 에지 커넥터 - AWS IoT Greengrass

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

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 이를 사용하여 센서, 카메라 및 엔터프라이즈 애플리케이션의 데이터를 시각화하여 실제 공장, 건물 또는 산업 플랜트를 추적할 수 있습니다. 또한 이 데이터를 사용하여 작업을 모니터링하고, 오류를 진단하고, 오류를 수정할 수 있습니다. 자세한 내용은 What is AWS IoT TwinMaker? 를 참조하십시오. AWS IoT TwinMaker 사용 설명서에서.

이 구성 요소는 산업 데이터를 모델링하고 저장하는 AWS IoT SiteWise AWS 서비스인 에 구성을 저장합니다. 에서 AWS IoT SiteWise자산은 장치, 장비 또는 기타 개체 그룹과 같은 개체를 나타냅니다. 이 구성 요소를 구성하고 사용하려면 각 Greengrass 코어 장치 및 각 코어 장치에 연결된 각 IP 카메라에 대한 AWS IoT SiteWise 자산을 생성합니다. 각 자산에는 라이브 스트리밍, 온디맨드 업로드, 로컬 캐싱과 같은 기능을 제어하도록 구성하는 속성이 있습니다. 각 카메라의 URL을 지정하려면 카메라의 URL이 AWS Secrets Manager 포함된 시크릿을 생성해야 합니다. 카메라에 인증이 필요한 경우 URL에 사용자 이름과 암호도 지정합니다. 그런 다음 IP 카메라의 자산 속성에 해당 암호를 지정합니다.

이 구성 요소는 각 카메라의 비디오 스트림을 Kinesis 비디오 스트림에 업로드합니다. 각 카메라의 AWS IoT SiteWise 에셋 구성에서 대상 Kinesis 비디오 스트림의 이름을 지정합니다. Kinesis 비디오 스트림이 없는 경우 이 구성 요소가 자동으로 생성합니다.

AWS IoT TwinMaker 는 이러한 AWS IoT SiteWise 자산과 Secrets Manager 암호를 만들기 위해 실행할 수 있는 스크립트를 제공합니다. 이러한 리소스를 만드는 방법과 이 구성 요소를 설치, 구성 및 사용하는 방법에 대한 자세한 내용은 사용 AWS IoT TwinMaker 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.

참고

Kinesis Video Streams 구성 요소용 에지 커넥터는 다음 AWS 리전제품에서만 사용할 수 있습니다.

  • 미국 동부(버지니아 북부)

  • 미국 서부(오리건)

  • 유럽(프랑크푸르트)

  • 유럽(아일랜드)

  • 아시아 태평양(싱가포르)

버전

이 구성 요소의 버전은 다음과 같습니다.

  • 1.0.x

유형

구성 요소는 일반 구성 요소 () aws.greengrass.generic 입니다. Greengrass 핵은 구성 요소의 라이프사이클 스크립트를 실행합니다.

자세한 정보는 구성 요소 유형을 참조하세요.

운영 체제

이 구성 요소는 Linux 코어 디바이스에만 설치할 수 있습니다.

요구 사항

이 구성 요소의 요구 사항은 다음과 같습니다.

  • 구성 요소 구성이 각 코어 장치마다 고유해야 하므로 이 구성 요소는 단일 코어 장치에만 배포할 수 있습니다. 핵심 장치 그룹에는 이 구성 요소를 배포할 수 없습니다.

  • GStreamer 1.18.4 이상이 코어 기기에 설치되었습니다. 자세한 내용은 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 비디오 통합을 참조하십시오.

  • 각 코어 장치에 연결하는 각 IP 카메라의 AWS IoT SiteWise 자산. 이러한 AWS IoT SiteWise 자산은 비디오를 각 코어 장치로 스트리밍하는 카메라를 나타냅니다. 각 카메라의 자산은 카메라에 연결되는 핵심 장치의 자산과 연결되어야 합니다. 카메라 자산에는 Kinesis 비디오 스트림, 인증 암호 및 비디오 스트리밍 매개변수를 지정하도록 구성할 수 있는 속성이 있습니다. 카메라 자산을 생성하고 구성하는 방법에 대한 자세한 내용은 AWS IoT TwinMaker 사용 설명서의AWS IoT TwinMaker 비디오 통합을 참조하십시오.

  • 각 IP 카메라의 AWS Secrets Manager 비밀. 이 비밀번호는 키-값 쌍을 정의해야 합니다. 여기서 키는 있고 값은 카메라의 URL입니다. RTSPStreamUrl 카메라 인증이 필요한 경우 이 URL에 사용자 이름과 암호를 포함하십시오. 이 컴포넌트에 필요한 리소스를 생성할 때 스크립트를 사용하여 시크릿을 생성할 수 있습니다. 자세한 내용은 AWS IoT TwinMaker 사용 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.

    Secrets Manager 콘솔 및 API를 사용하여 추가 시크릿을 생성할 수도 있습니다. 자세한 내용은 AWS Secrets Manager 사용 설명서의 암호 만들기를 참조하십시오.

  • Greengrass 토큰 교환 역할은 다음 예시 IAM 정책에 표시된 것처럼 다음 AWS Secrets Manager및 Kinesis Video Streams 작업을 허용해야 합니다. AWS IoT SiteWise

    참고

    이 예제 정책은 디바이스가 및 라는 이름의 비밀 값을 가져오도록 허용합니다. 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 작업을 허용해야 합니다.

엔드포인트 및 포트

이 구성 요소는 기본 작업에 필요한 엔드포인트 및 포트 외에도 다음 엔드포인트 및 포트에 대한 아웃바운드 요청을 수행할 수 있어야 합니다. 자세한 정보는 프록시 또는 방화벽을 통한 장치 트래픽 허용을 참조하세요.

엔드포인트 포트 필수 설명

kinesisvideo.region.amazonaws.com

443

Kinesis Video Streams에 데이터를 업로드합니다.

data.iotsitewise.region.amazonaws.com

443

비디오 스트림 메타데이터를 에 AWS IoT SiteWise게시하십시오.

secretsmanager.region.amazonaws.com

443

카메라 URL 시크릿을 코어 디바이스에 다운로드합니다.

의존성

구성 요소를 배포하면 호환되는 버전의 종속 AWS IoT Greengrass 항목도 배포됩니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 해당 종속성에 대한 요구 사항을 모두 충족해야 합니다. 이 섹션에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 시맨틱 버전 제약 조건이 나열되어 있습니다. 콘솔에서 구성 요소의 각 버전에 대한 종속성을 볼 수도 있습니다.AWS IoT Greengrass 구성 요소 세부 정보 페이지에서 종속성 목록을 찾아보십시오.

다음 표에는 이 구성 요소의 버전 1.0.0~1.0.5에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
토큰 교환 서비스 >=2.0.3 하드
스트림 매니저 >=2.0.9 하드

구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하십시오.

구성

이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음과 같은 구성 매개 변수를 제공합니다.

SiteWiseAssetIdForHub

이 코어 디바이스를 나타내는 AWS IoT SiteWise 자산의 ID. 이 자산을 만들고 이를 사용하여 이 구성 요소와 상호 작용하는 방법에 대한 자세한 내용은 사용 AWS IoT TwinMaker 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.

예: 구성 병합 업데이트
{ "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

라이선스

이 구성 요소에는 다음과 같은 타사 소프트웨어/라이선스가 포함됩니다.

사용량

이 구성 요소를 구성하고 상호 작용하기 위해 코어 장치를 나타내는 AWS IoT SiteWise 자산과 해당 장치가 연결되는 IP 카메라에 속성을 설정할 수 있습니다. Grafana 대시보드에서 비디오 스트림을 시각화하고 상호 작용할 수도 있습니다. AWS IoT TwinMaker 자세한 내용은 사용 설명서의 AWS IoT TwinMaker 비디오 통합을 참조하십시오.AWS IoT TwinMaker

로컬 로그 파일

이 구성 요소는 다음 로그 파일을 사용합니다.

/greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log
이 구성 요소의 로그를 보려면
  • 코어 기기에서 다음 명령을 실행하여 이 구성 요소의 로그 파일을 실시간으로 확인합니다. AWS IoT Greengrass 루트 폴더 /greengrass/v2 경로로 바꾸십시오.

    sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log

Changelog

다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.

버전

변경

1.0.5

일반적인 버그 수정 및 개선입니다.

1.0.4

버그 수정 및 개선
  • 실시간 업로드가 중지되는 문제를 수정합니다.

1.0.3

일반적인 버그 수정 및 개선입니다.

1.0.1

일반적인 버그 수정 및 개선입니다.

1.0.0

초기 버전

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