Définissez des alarmes sur les modèles d'actifs

Les modèles d'actifs favorisent la standardisation de vos données industrielles et de vos alarmes. Vous pouvez définir des définitions d'alarmes sur les modèles d'actifs afin de standardiser les alarmes pour tous les actifs en fonction d'un modèle d'actif.

Vous utilisez des modèles d'actifs composites pour définir des alarmes sur les modèles d'actifs. Les modèles d'actifs composites sont des modèles d'actifs qui normalisent un ensemble spécifique de propriétés sur un autre modèle d'actif. Les modèles d'actifs composites garantissent la présence de certaines propriétés sur un modèle d'actif. Les alarmes ont des propriétés de type, d'état et (facultatives) de source, de sorte que le modèle composite d'alarme garantit l'existence de ces propriétés.

Chaque modèle d'actif composite possède un type qui définit les propriétés de ce modèle composite. Les modèles composites d'alarme définissent les propriétés du type d'alarme, de l'état de l'alarme et de la source d'alarme (en option). Lorsque vous créez un actif à partir d'un modèle d'actif avec des modèles composites, l'actif inclut les propriétés du modèle composite ainsi que les propriétés que vous spécifiez dans le modèle d'actif.

Chaque propriété d'un modèle composite doit porter le nom qui l'identifie pour son type de modèle composite. Les propriétés du modèle composite prennent en charge les propriétés contenant des types de données complexes. Ces propriétés ont le type de STRUCT données et un dataTypeSpec trait qui spécifie le type de données complexe de la propriété. Les propriétés de type de données complexes contiennent des JSON données sérialisées sous forme de chaînes.

Les modèles composites d'alarme présentent les propriétés suivantes. Chaque propriété doit porter le nom qui l'identifie pour ce type de modèle composite.

Type d'alarme

Type d'alarme. Spécifiez l’un des éléments suivants :

• IOT_EVENTS— Une AWS IoT Events alarme. AWS IoT SiteWise envoie des données AWS IoT Events à pour évaluer l'état de cette alarme. Vous devez spécifier la propriété de la source d'alarme pour définir le modèle AWS IoT Events d'alarme pour cette définition d'alarme.

• EXTERNAL— Une alarme externe. Vous ingérez l'état de l'alarme sous forme de mesure.

Nom de la propriété : AWS/ALARM_TYPE

Type de propriété : attribut

Type de données : STRING

État de l'alarme

Les données chronologiques relatives à l'état de l'alarme. Il s'agit d'un objet sérialisé sous forme de chaîne contenant l'état et d'autres informations relatives à l'alarme. Pour de plus amples informations, veuillez consulter Propriétés de l'état de l'alarme.

Nom de la propriété : AWS/ALARM_STATE

Type de propriété : mesure

Type de données : STRUCT

Type de structure de données : AWS/ALARM_STATE

Source d'alarme

(Facultatif) Le nom de la ressource Amazon (ARN) de la ressource qui évalue l'état de l'alarme. Pour les AWS IoT Events alarmes, il s'agit ARN du modèle d'alarme.

Nom de la propriété : AWS/ALARM_SOURCE

Type de propriété : attribut

Type de données : STRING

Exemple de modèle composite d'alarme

Le modèle d'actif suivant représente une chaudière dotée d'une alarme pour surveiller sa température. AWS IoT SiteWise envoie les données de température AWS IoT Events pour détecter l'alarme.

{
  "assetModelName": "Boiler",
  "assetModelDescription": "A boiler that alarms when its temperature exceeds its limit.",
  "assetModelProperties": [
    {
      "name": "Temperature",
      "dataType": "DOUBLE",
      "unit": "Celsius",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "High Temperature",
      "dataType": "DOUBLE",
      "unit": "Celsius",
      "type": {
        "attribute": {
          "defaultValue": "105.0"
        }
      }
    }
  ],
  "assetModelCompositeModels": [
    {
      "name": "BoilerTemperatureHighAlarm",
      "type": "AWS/ALARM",
      "properties": [
        {
          "name": "AWS/ALARM_TYPE",
          "dataType": "STRING",
          "type": {
            "attribute": {
              "defaultValue": "IOT_EVENTS"
            }
          }
        },
        {
          "name": "AWS/ALARM_STATE",
          "dataType": "STRUCT",
          "dataTypeSpec": "AWS/ALARM_STATE",
          "type": {
            "measurement": {}
          }
        },
        {
          "name": "AWS/ALARM_SOURCE",
          "dataType": "STRING",
          "type": {
            "attribute": {}
          }
        }
      ]
    }
  ]
}

Rubriques

• Exigences relatives aux notifications d'alarme
• Définir les AWS IoT Events alarmes
• Définissez les alarmes externes