

# Ingest an external alarm state in Amazon IoT SiteWise
<a name="ingest-external-alarm-state"></a>

External alarms are alarms that you evaluate outside of Amazon IoT SiteWise. You can use external alarms when you have a data source that reports alarm state that you want to ingest to Amazon IoT SiteWise.

Alarm state properties require a specific format for alarm state data values. Each data value must be a JSON object serialized to a string. Then, you ingest the serialized string as a string value. For more information, see [Alarm state properties](industrial-alarms.md#alarm-state-properties).

**Example alarm state data value (not serialized)**  

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

**Example alarm state data value (serialized)**  

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

**Note**  
If your data source can't report data in this format, or you can't convert your data to this format before you ingest it, you might choose not to use an alarm property. Instead, you can ingest the data as a measurement property with the string data type, for example. For more information, see [Define data streams from equipment (measurements)](measurements.md) and [Ingest data to Amazon IoT SiteWise](industrial-data-ingestion.md).