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

# 에서 외부 경보 상태 수집 AWS IoT SiteWise
<a name="ingest-external-alarm-state"></a>

외부 경보는 외부에서 평가하는 경보입니다 AWS IoT SiteWise. AWS IoT SiteWise에 수집하려는 경보 상태를 보고하는 데이터 소스가 있는 경우 외부 경보를 사용할 수 있습니다.

경보 상태 속성에는 경보 상태 데이터 값에 대한 특정 형식이 필요합니다. 각 데이터 값은 문자열로 직렬화된 JSON 객체여야 합니다. 그런 다음 직렬화된 문자열을 문자열 값으로 수집합니다. 자세한 내용은 [경보 상태 속성](industrial-alarms.md#alarm-state-properties) 단원을 참조하십시오.

**Example 경보 상태 데이터 값 예시(직렬화되지 않음)**  

```
{
  "stateName": "Active"
}
```

**Example 경보 상태 데이터 값 예시(직렬화)**  

```
{\"stateName\":\"Active\"}
```

**참고**  
데이터 소스에서 이 형식의 데이터를 보고할 수 없거나 데이터를 수집하기 전에 이 형식으로 변환할 수 없는 경우, 경보 속성을 사용하지 않도록 선택할 수 있습니다. 대신, 문자열 데이터 유형을 사용하여 측정 속성으로 데이터를 수집 수 있습니다. 자세한 내용은 [장비의 데이터 스트림 정의(측정값)](measurements.md) 및 [에 데이터 수집 AWS IoT SiteWise](industrial-data-ingestion.md) 섹션을 참조하세요.

# 에서 외부 경보 상태 스트림 매핑 AWS IoT SiteWise
<a name="connect-alarm-data-streams"></a>

속성 별칭을 정의하여 데이터 스트림을 경보 상태 속성에 매핑할 수 있습니다. 이를 통해 데이터를 수집하거나 검색할 때 경보 상태 속성을 쉽게 식별할 수 있습니다. 속성 별칭에 대한 자세한 내용은 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md)을 참조하세요.

**Topics**
+ [외부 경보 상태 스트림 매핑(콘솔)](#connect-alarm-data-stream-console)
+ [외부 경보 상태 스트림 매핑(AWS CLI)](#connect-alarm-data-stream-cli)

## 외부 경보 상태 스트림 매핑(콘솔)
<a name="connect-alarm-data-stream-console"></a>

속성 별칭을 정의하여 데이터 스트림을 경보 상태 속성에 매핑할 수 있습니다. 이를 통해 데이터를 수집하거나 검색할 때 경보 상태 속성을 쉽게 식별할 수 있습니다. 속성 별칭에 대한 자세한 내용은 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md)을 참조하세요.

 AWS IoT SiteWise 콘솔을 사용하여 경보 상태 속성에 대한 별칭을 설정할 수 있습니다.

**경보 상태 속성에 속성 별칭을 설정하려면(콘솔) 다음을 수행하세요.**

1. <a name="sitewise-open-console"></a>[AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.

1. <a name="sitewise-choose-assets"></a>탐색 창에서 **자산**을 선택합니다.

1. 속성 별칭을 설정할 자산을 선택합니다.
**작은 정보**  <a name="sitewise-expand-asset-hierarchy"></a>
화살표 아이콘을 선택하여 자산 계층 구조를 확장하고 자산을 찾을 수 있습니다.

1. **편집**을 선택합니다.

1. **경보**로 스크롤하고 섹션을 확장합니다.

1. **외부 경보 ** 아래의 **속성 별칭 – *선택 사항***에 별칭을 입력합니다.

1. **저장**을 선택합니다.

## 외부 경보 상태 스트림 매핑(AWS CLI)
<a name="connect-alarm-data-stream-cli"></a>

속성 별칭을 정의하여 데이터 스트림을 경보 상태 속성에 매핑할 수 있습니다. 이를 통해 데이터를 수집하거나 검색할 때 경보 상태 속성을 쉽게 식별할 수 있습니다. 속성 별칭에 대한 자세한 내용은 [에 대한 데이터 스트림 관리 AWS IoT SiteWise](manage-data-streams.md)을 참조하세요.

 AWS Command Line Interface (AWS CLI)를 사용하여 경보 상태 속성에 대한 별칭을 설정할 수 있습니다.

이 절차를 완료하려면 자산의 `assetId` 및 속성의 `propertyId`를 알고 있어야 합니다. 외부 ID를 사용할 수도 있습니다. 자산을 생성했지만 해당 `assetId`를 모르고 있는 경우에는 [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) API를 사용하여 특정 모델에 대한 모든 자산을 표시합니다. [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) 작업을 사용하여 속성 ID를 포함한 해당 자산의 속성을 봅니다.

**참고**  
[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) 응답에는 해당 자산의 복합 자산 모델 목록이 포함됩니다. 각 경보는 복합 모델입니다. `propertyId`를 찾으려면 경보의 복합 모델을 찾은 다음 해당 복합 모델에서 `AWS/ALARM_STATE` 속성을 찾습니다.

속성 별칭을 설정하여 그렇게 하는 방법에 대한 자세한 내용은 [자산 속성 별칭 업데이트](update-data-streams-method.md)을 참조하세요.

# 에서 경보 상태 데이터 수집 AWS IoT SiteWise
<a name="ingest-alarm-state-data"></a>

경보 상태 속성은 경보 상태를 직렬화된 JSON 문자열로 예상합니다. 에서 외부 경보에 경보 상태를 수집하려면이 직렬화된 문자열을 타임스탬프 문자열 값으로 AWS IoT SiteWise수집합니다. 다음 예제는 활성 경보의 상태 데이터 값을 보여줍니다.

```
{\"stateName\":\"Active\"}
```

경보 자산 속성을 식별하려면 다음 중 하나를 지정합니다.
+ 데이터를 보낼 경보 자산 속성의 `assetId` 및 `propertyId`.
+ 데이터 스트림 별칭(예: `/company/windfarm/3/turbine/7/temperature/high`)인 `propertyAlias`. 이 옵션을 사용하려면 먼저 경보 속성의 별칭을 설정해야 합니다. 경보 상태 속성의 속성 별칭을 설정하는 방법을 알아보려면 [에서 외부 경보 상태 스트림 매핑 AWS IoT SiteWise](connect-alarm-data-streams.md) 섹션을 참조합니다.

다음 예제 [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) API 페이로드는 외부 경보의 상태를 포맷하는 방법을 보여줍니다. 이 외부 경보는 풍력 터빈의 분당 회전수(RPM)측정값이 너무 높을 때 보고합니다.

**Example 경보 상태 데이터에 대한 BatchPutAssetPropertyValue 페이로드 예시**  

```
{
    "entries": [
      {
        "entryId": "unique entry ID",
        "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
        "propertyValues": [
          {
            "value": {
              "stringValue": "{\"stateName\":\"Active\"}"
            },
            "timestamp": {
              "timeInSeconds": 1607550262
            }
          }
        ]
      }
    ]
  }
```
`BatchPutAssetPropertyValue` API를 사용하여 데이터를 수집하는 방법에 대한 자세한 내용은 [AWS IoT SiteWise APIs로 데이터 수집](ingest-api.md) 섹션을 참조하세요.  
데이터를 수집하는 다른 방법에 대한 자세한 내용은 [에 데이터 수집 AWS IoT SiteWise](industrial-data-ingestion.md) 섹션을 참조하세요.