

AWS IoT FleetWise는 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. 기존 AWS IoT FleetWise 고객은 서비스를 계속 사용할 수 있습니다. [의 Connected Mobility 지침은 AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) AWS IoT FleetWise와 동등한 기능을 달성하는 데 사용할 수 있는 커넥티드 모빌리티 솔루션을 위한 모듈식 서비스를 개발하고 배포하는 방법에 대한 지침을 제공합니다.

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

# 캠페인을 사용한 Collect AWS IoT FleetWise 데이터
<a name="campaigns"></a>

**중요**  
특정 AWS IoT FleetWise 기능에 대한 액세스는 현재 게이트됩니다. 자세한 내용은 [AWS AWS IoT FleetWise의 리전 및 기능 가용성](fleetwise-regions.md) 단원을 참조하십시오.

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

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

**중요**  
캠페인은 다음과 같은 상황이 발생하기 전까지는 작동하지 않습니다.  
Edge Agent 소프트웨어가 차량에서 실행되고 있습니다. Edge Agent 소프트웨어를 개발, 설치 및 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.  
[AWS IoT FleetWise 콘솔](https://console.aws.amazon.com/iotfleetwise)을 엽니다.
서비스 홈 페이지의 ** AWS IoT FleetWise 시작하기** 섹션에서 **엣지 에이전트 탐색**을 선택합니다.
차량을 프로비저닝 AWS IoT Core 하도록를 설정했습니다. 자세한 내용은 [Provision AWS IoT FleetWise 차량](provision-vehicles.md) 단원을 참조하십시오.

**참고**  
"변경 시" 또는 "정기" 업데이트 전략을 사용하여 원격 측정 데이터를 스트리밍할 수 있는 상태 템플릿을 사용하여 거의 실시간으로 [차량의 마지막으로 알려진 상태 모니터링](last-known-state.md) (플릿이 아닌) 할 수도 있습니다. 또한이 기능은 이전에 배포된 템플릿을 활성화 또는 비활성화하거나 현재 차량 상태를 일회성으로 요청(가져오기)하는 "온디맨드" 기능을 제공합니다.  
마지막으로 알려진 상태에 대한 액세스는 현재 게이트됩니다. 자세한 내용은 [AWS AWS IoT FleetWise의 리전 및 기능 가용성](fleetwise-regions.md) 단원을 참조하십시오.

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

`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보다 큰 온도 값을 수집합니다. 표현식을 작성하는 방법에 대한 지침은 [AWS IoT FleetWise 캠페인의 논리적 표현식](logical-expression.md) 섹션을 참조하세요.
  + (선택 사항) `conditionLanguageVersion`- 조건식 언어의 버전입니다.
  + (선택 사항) `minimumTriggerIntervalMs`- 두 데이터 수집 이벤트 사이의 최소 지속 시간을 밀리초 단위로 표시합니다. 신호가 자주 바뀌는 경우 더 느린 속도로 데이터를 수집할 수 있습니다.
  + (선택 사항) `triggerMode` - 다음 값 중 하나일 수 있습니다.
    + `RISING_EDGE` - Edge Agent 소프트웨어는 조건이 처음 충족될 때만 데이터를 수집합니다. 예를 들어 `$variable.`myVehicle.AirBagDeployed` == true`입니다.
    + `ALWAYS`— Edge Agent 소프트웨어는 조건이 충족될 때마다 데이터를 수집합니다.
+ `timeBasedCollectionScheme` - 시간 기반 수집 체계를 정의할 때 기간을 밀리초 단위로 지정합니다. Edge Agent 소프트웨어는 기간을 사용하여 데이터 수집 빈도를 결정합니다. 예를 들어, 기간이 120,000밀리초인 경우, Edge Agent 소프트웨어는 2분에 한 번씩 데이터를 수집합니다.
  + `periodMs` - 데이터 수집 빈도를 결정하는 기간(밀리초)입니다.

(선택 사항) `compression`  
무선 대역폭을 절약하고 네트워크 트래픽을 줄이기 위해 [SNAPPY](https://opensource.google/projects/snappy)를 지정하여 차량의 데이터를 압축할 수 있습니다.  
기본적으로(`OFF`), Edge Agent 소프트웨어는 데이터를 압축하지 않습니다.

`dataDestinationConfigs`  
캠페인이 차량 데이터를 전송할 단일 대상을 선택합니다. 데이터를 [MQTT 주제](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html)로 보내거나 Amazon S3 또는 Amazon Timestream에 저장할 수 있습니다.  
MQTT(Message Queuing Telemetry Transport)는 가볍고 널리 채택된 메시징 프로토콜입니다. AWS IoT 규칙을 사용하여 MQTT 주제에 데이터를 게시하여 자체 이벤트 기반 아키텍처를 구축할 수 있습니다. MQTT에 대한 AWS IoT 지원은 [ MQTT v3.1.1 사양](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html)과 [MQTT v5.0 사양을](http://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html) 기반으로 하며 몇 가지 차이점이 있습니다. 자세한 내용은 [MQTT 차이를](https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html#mqtt-differences.html) 참조하세요.  
S3는 내구성 있는 데이터 관리 기능과 다운스트림 데이터 서비스를 제공하는 비용 효율적인 데이터 스토리지 메커니즘일 수 있습니다. S3를 운전 습관과 관련된 데이터나 장기 유지 관리 분석에 사용할 수 있습니다.  
Timestream은 추세와 패턴을 거의 실시간으로 식별하는 데 도움이 되는 데이터 지속성 메커니즘입니다. Timestream을 사용하여 차량 속도 또는 제동의 과거 추세를 분석하는 것과 같은 시계열 데이터에 사용할 수 있습니다.  
아시아 태평양(뭄바이) 리전에서는 Amazon Timestream을 사용할 수 없습니다.

(선택 사항) `dataExtraDimensions`  
신호에 대한 추가 정보를 제공하기 위한 속성을 하나 이상 추가할 수 있습니다.

(선택 사항) `dataPartitions`  
데이터 파티션을 생성하여 신호 데이터를 차량에 임시로 저장합니다. 데이터를 클라우드로 전달하는 시기와 방법을 구성합니다.  
+ 최대 스토리지 크기, 최소 수명 및 스토리지 위치를 정의하여 AWS IoT FleetWise가 차량 또는 플릿에 데이터를 저장하는 방법을 지정합니다.
+ 캠페인은 여야 `spoolingMode` 합니다`TO_DISK`.
+ 업로드 구성에는 조건 언어의 버전과 논리적 표현식 정의가 포함됩니다.

(선택 사항) `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` - 데이터 수집 체계가 호출될 때 데이터가 수집되는 신호의 이름입니다.
+ `dataPartitionId` - 신호에 사용할 데이터 파티션의 ID입니다. ID는에 제공된 IDs 중 하나와 일치해야 합니다`dataPartitions`. 신호를 데이터 파티션의 조건으로 업로드하는 경우 동일한 신호가에 포함되어야 합니다`signalsToCollect`.
+ (선택 사항) `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 IoT FleetWise 캠페인 업데이트](update-campaign-cli.md) 단원을 참조하십시오.
+ `RUNNING `— 캠페인이 활성화되었습니다.
+ `SUSPENDED`— 캠페인이 일시 중지되었습니다. 캠페인을 재개하려면 `UpdateCampaign` API 작업을 사용하세요.

AWS IoT FleetWise는 캠페인을 생성하고 관리하는 데 사용할 수 있는 다음과 같은 API 작업을 제공합니다.
+ [CreateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateCampaign.html) — 새 캠페인을 생성합니다.
+ [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html) — 기존 캠페인을 업데이트합니다. 캠페인을 생성한 후에는 이 API 작업을 사용하여 캠페인을 승인해야 합니다.
+ [DeleteCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteCampaign.html) — 기존 캠페인을 삭제합니다.
+ [ListCampaigns](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListCampaigns.html) - 모든 캠페인에 대해 페이지별로 구분된 요약 목록을 검색합니다.
+ [GetCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetCampaign.html) — 캠페인에 대한 정보를 검색합니다.

**Topics**
+ [AWS IoT FleetWise 캠페인 생성](create-campaign.md)
+ [AWS IoT FleetWise 캠페인 업데이트](update-campaign-cli.md)
+ [AWS IoT FleetWise 캠페인 삭제](delete-campaign.md)
+ [Get AWS IoT FleetWise 캠페인 정보](get-campaign-information-cli.md)
+ [캠페인 데이터 저장 및 전달](store-and-forward.md)
+ [AWS IoT FleetWise를 사용하여 진단 문제 코드 데이터 수집](diagnostic-trouble-codes.md)
+ [Visualize AWS IoT FleetWise 차량 데이터](process-visualize-data.md)