캠페인을 통한 데이터 수집 및 전송 - AWS IoT FleetWise

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

캠페인을 통한 데이터 수집 및 전송

캠페인은 데이터 수집 규칙의 오케스트레이션입니다. 캠페인은 Edge Agent for AWS IoT FleetWise 소프트웨어에서 데이터를 선택, 수집 및 클라우드로 전송하는 방법에 대한 지침을 제공합니다.

클라우드에 캠페인을 생성합니다. 사용자 또는 사용자의 팀이 캠페인을 승인하면 AWS IoT FleetWise가 자동으로 캠페인을 차량에 배포합니다. 캠페인을 차량 또는 여러 차량의 플릿에 배포하도록 선택할 수 있습니다. Edge Agent 소프트웨어는 실행 중인 캠페인이 차량에 배포될 때까지 데이터 수집을 시작하지 않습니다.

참고

캠페인은 다음과 같은 상황이 발생하기 전까지는 작동하지 않습니다.

  • Edge Agent 소프트웨어가 차량에서 실행되고 있습니다. Edge Agent 소프트웨어를 개발, 설치 및 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

    1. AWS IoT FleetWise 콘솔로 이동합니다.

    2. 서비스 홈 페이지의 AWS IoT FleetWise 시작하기 섹션에서 Edge Agent 탐색을 선택합니다.

  • 차량 프로비저닝을 위해 AWS IoT Core을(를) 설정했습니다. 자세한 내용은 차량 공급 섹션을 참조하세요.

각 캠페인에는 다음 정보가 포함되어 있습니다.

signalCatalogArn

캠페인과 연결된 신호 카탈로그의 Amazon 리소스 이름(ARN)입니다.

(선택 사항) tags

태그는 캠페인을 관리하는 데 사용할 수 있는 메타데이터입니다. 서로 다른 서비스의 리소스에 동일한 태그를 지정하여 리소스가 서로 연관되어 있음을 나타낼 수 있습니다.

TargetArn

캠페인이 배포되는 차량 또는 플릿의 ARN입니다.

name

캠페인을 식별하는 데 도움이 되는 고유한 이름.

collectionScheme

데이터 수집 체계는 수집할 데이터나 수집 시기에 대한 Edge Agent 소프트웨어 지침을 제공합니다. AWS IoT FleetWise는 현재 조건 기반 수집 체계와 시간 기반 수집 체계를 지원합니다.

conditionBasedCollectionScheme

조건 기반 수집 체계는 수집할 데이터를 인식하기 위한 논리적 표현식을 사용합니다. Edge Agent 소프트웨어는 조건이 충족되는 경우 데이터를 수집합니다.

expression

수집할 데이터를 인식하는 데 사용되는 논리적 표현식입니다. 예를 들어 $variable.`myVehicle.InVehicleTemperature` > 50.0 표현식이 지정된 경우 Edge Agent 소프트웨어는 50.0보다 큰 온도 값을 수집합니다. 표현식을 작성하는 방법에 대한 지침은 캠페인의 논리적 표현식 섹션을 참조하세요.

(선택 사항) triggerMode은(는) 다음 값 중 하나일 수 있습니다.

  • RISING_EDGE— Edge Agent 소프트웨어는 조건이 처음으로 충족되는 경우에만 데이터를 수집합니다. 예: $variable.`myVehicle.AirBagDeployed` == true.

  • ALWAYS— Edge Agent 소프트웨어는 조건이 충족될 때마다 데이터를 수집합니다.

(선택 사항) minimumTriggerIntervalMs

두 데이터 수집 이벤트 사이의 최소 기간(밀리초)입니다. 신호가 자주 바뀌는 경우 더 느린 속도로 데이터를 수집할 수 있습니다.

(선택 사항) conditionLanguageVersion

조건부 표현식 언어의 버전.

timeBasedCollectionScheme

시간 기반 수집 체계를 정의할 때는 기간을 밀리초 단위로 지정합니다. Edge Agent 소프트웨어는 기간을 사용하여 데이터 수집 빈도를 결정합니다. 예를 들어, 기간이 120,000밀리초인 경우, Edge Agent 소프트웨어는 2분에 한 번씩 데이터를 수집합니다.

(선택 사항) compression

무선 대역폭을 절약하고 네트워크 트래픽을 줄이기 위해 SNAPPY를 지정하여 차량의 데이터를 압축할 수 있습니다.

기본적으로(OFF), Edge Agent 소프트웨어는 데이터를 압축하지 않습니다.

dataDestinationConfigs

캠페인에서 차량 데이터를 전송할 목적지를 선택합니다. 데이터를 Amazon S3 또는 Amazon Timestream에 저장하도록 선택할 수 있습니다.

S3는 내구성이 뛰어난 데이터 관리 기능과 다운스트림 데이터 서비스를 제공하는 비용 효율적인 데이터 스토리지 메커니즘입니다. S3를 운전 습관과 관련된 데이터나 장기 유지 관리 분석에 사용할 수 있습니다.

Timestream은 추세와 패턴을 거의 실시간으로 식별하는 데 도움이 되는 데이터 지속성 메커니즘입니다. Timestream을 사용하여 차량 속도 또는 제동의 과거 추세를 분석하는 것과 같은 시계열 데이터에 사용할 수 있습니다.

(선택 사항) dataExtraDimensions

신호에 대한 추가 정보를 제공하기 위한 속성을 하나 이상 추가할 수 있습니다.

(선택 사항) description

캠페인을 식별할 수 있는 설명을 추가할 수 있습니다.

(선택 사항) diagnosticsMode

진단 모드를 사용하도록 SEND_ACTIVE_DTCS을(를) 구성하면 캠페인에서 차량에 어떤 문제가 있는지 식별할 때 도움이 되는 저장된 표준 진단 문제 코드(DTC)를 전송합니다. 예를 들어, P0097 신호는 엔진 제어 모듈(ECM)이 흡기 온도 센서 2(IAT2) 입력이 정상 센서 범위보다 낮다고 판단했음을 나타냅니다.

기본적으로(OFF), Edge Agent 소프트웨어는 진단 코드를 전송하지 않습니다.

(선택 사항) expiryTime

캠페인의 만료일을 정의할 수 있습니다. 캠페인이 만료되면 Edge Agent 소프트웨어는 이 캠페인에 지정된 대로 데이터 수집을 중지합니다. 차량에 여러 캠페인을 배포한 경우 Edge Agent 소프트웨어는 다른 캠페인을 사용하여 데이터를 수집합니다.

기본값: 253402243200 (9999년 12월 31일, 00:00:00 UTC)

(선택 사항) postTriggerCollectionDuration

사후 트리거 수집 기간을 정의하여 스키마가 간접적으로 호출된 후 Edge Agent 소프트웨어가 지정된 기간 동안 데이터를 계속 수집하도록 할 수 있습니다. 예를 들어, 다음 표현식이 포함된 조건 기반 수집 체계가 간접적으로 호출되는 경우: $variable.`myVehicle.Engine.RPM` > 7000.0인 경우, Edge Agent 소프트웨어는 엔진의 분당 회전 수(RPM) 값을 계속 수집합니다. RPM이 7000보다 한 번만 높아지더라도 기계적 문제가 있음을 의미할 수 있습니다. 이 경우 Edge Agent 소프트웨어에서 상태를 모니터링하는 데 도움이 되는 데이터를 계속 수집하는 것이 좋습니다.

기본 값: 0

(선택 사항) priority

캠페인의 우선순위를 나타내는 정수를 지정할 수 있습니다. 수가 적은 캠페인일수록 우선 순위가 높습니다. 차량에 여러 캠페인을 배포하는 경우 우선 순위가 높은 캠페인이 먼저 시작됩니다.

기본 값: 0

(선택 사항) signalsToCollect

데이터 수집 체계를 실행할 때 데이터가 수집되는 신호 목록입니다.

중요

조건 기반 수집 체계의 표현식에 사용되는 신호를 이 필드에 지정해야 합니다.

name

데이터 수집 체계를 호출할 때 데이터가 수집되는 신호의 이름입니다.

(선택 사항) maxSampleCount

데이터 수집 체계를 호출할 때 Edge Agent 소프트웨어가 수집하여 클라우드로 전송하는 최대 데이터 샘플 수입니다.

(선택 사항) minimumSamplingIntervalMs

두 데이터 샘플 수집 이벤트 사이의 최소 기간(밀리초)입니다. 신호가 자주 바뀌는 경우 이 파라미터를 사용하여 더 느린 속도로 데이터를 수집할 수 있습니다.

유효 범위: 0‐4294967295

(선택 사항) spoolingMode

spoolingMode이(가) TO_DISK(으)로 구성된 경우 Edge Agent 소프트웨어는 차량이 클라우드에 연결되어 있지 않을 때 데이터를 로컬에 임시로 저장합니다. 연결이 다시 설정되면 로컬에 저장된 데이터가 클라우드로 자동 전송됩니다.

기본 값: OFF

(선택 사항) startTime

승인된 캠페인은 시작 시 활성화됩니다.

기본 값: 0

캠페인의 상태는 다음 값 중 하나일 수 있습니다.

  • CREATING— AWS IoT FleetWise가 캠페인 생성 요청을 처리하고 있습니다.

  • WAITING_FOR_APPROVAL— 캠페인이 생성되면, WAITING_FOR_APPROVAL 상태가 됩니다. 캠페인을 승인하려면 UpdateCampaign API 작업을 사용하세요. 캠페인이 승인되면 AWS IoT FleetWise는 캠페인을 대상 차량 또는 차량에 자동으로 배포합니다. 자세한 내용은 캠페인 업데이트 (AWS CLI) 섹션을 참조하세요.

  • RUNNING — 캠페인이 활성화되었습니다.

  • SUSPENDED— 캠페인이 일시 중지되었습니다. 캠페인을 재개하려면 UpdateCampaign API 작업을 사용하세요.

AWS IoT FleetWise는 캠페인 생성 및 관리에 사용할 수 있는 다음의 API 작업을 제공합니다.

  • CreateCampaign — 새 캠페인을 생성합니다.

  • UpdateCampaign — 기존 캠페인을 업데이트합니다. 캠페인을 생성한 후에는 이 API 작업을 사용하여 캠페인을 승인해야 합니다.

  • DeleteCampaign — 기존 캠페인을 삭제합니다.

  • ListCampaigns - 모든 캠페인에 대해 페이지별로 구분된 요약 목록을 검색합니다.

  • GetCampaign — 캠페인에 대한 정보를 검색합니다.

튜토리얼