Detector model analysis and diagnostic information - Amazon IoT Events
Troubleshoot error messages
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Detector model analysis and diagnostic information

Detector model analyses gather the following diagnostic information:

  • Level – The severity level of the analysis result. Based on the severity level, analysis results fall into three general categories:

    • Information (INFO) – An information result tells you about a significant field in your detector model. This type of result usually doesn't require immediate action.

    • Warning (WARNING) – A warning result draws special attention to fields that might cause issues for your detector model. We recommend that you review warnings and take necessary actions before you use your detector model in production environments. Otherwise, the detector model might not work as expected.

    • Error (ERROR) – An error result notifies you about a problem found in your detector model. Amazon IoT Events automatically performs this set of analyses when you try to publish the detector model. You must fix all errors before you can publish the detector model.

  • Location – Contains information that you can use to locate the field in your detector model that the analysis result references. A location typically includes the state name, transition event name, event name, and expression (for example, in state TemperatureCheck in onEnter in event Init in action setVariable).

  • Type – The type of the analysis result. Analysis types fall into the following categories:

    • supported-actions – Amazon IoT Events can invoke actions when a specified event or transition event is detected. You can define built-in actions to use a timer or set a variable, or send data to other Amazon services. You must specify actions that work with other Amazon services in an Amazon Region where the Amazon services are available.

    • service-limits – Service quotas, also known as limits, are the maximum or minimum number of service resources or operations for your Amazon account. Unless otherwise noted, each quota is Region-specific. Depending on your business needs, you can update your detector model to avoid encountering limits or request a quota increase. You can request increases for some quotas, and other quotas can't be increased. For more information, see Quotas.

  • structure – The detector model must have all required components such as states and follow a structure that Amazon IoT Events supports. A detector model must have at least one state and a condition that evaluates the incoming input data to detect significant events. When an event is detected, the detector model transitions to the next state and can invoke actions. These events are known as transition events. A transition event must direct the next state to enter.

  • expression-syntax – Amazon IoT Events provides several ways to specify values when you create and update detector models. You can use literals, operators, functions, references, and substitution templates in the expressions. You can use expressions to specify literal values, or Amazon IoT Events can evaluate the expressions before you specify particular values. Your expression must follow the required syntax. For more information, see Expressions.

    Detector Model expressions in Amazon IoT Events can reference specific data or a resource.

    • data-type – Amazon IoT Events supports integer, decimal, string, and Boolean data types. If Amazon IoT Events can automatically convert the data of one data type to another during expression evaluation, these data types are compatible.

      Note

      • Integer and decimal are the only compatible data types supported by Amazon IoT Events.

      • Amazon IoT Events can't evaluate arithmetic expressions because Amazon IoT Events can't convert an integer to a string.

    • referenced-data – You must define the data referenced in your detector model before you can use the data. For example, if you want to send data to a DynamoDB table, you must define a variable that references the table name before you can use the variable in an expression ($variable.TableName).

    • referenced-resource – Resources that the detector model uses must be available. You must define resources before you can use them. For example, you want to create a detector model to monitor the temperature of a greenhouse. You must define an input ($input.TemperatureInput) to route incoming temperature data to your detector model before you can use the $input.TemperatureInput.sensorData.temperature to reference the temperature.

See the following section to troubleshoot errors and find possible solutions from the analysis of your detector model.

Troubleshoot detector model errors

The types of errors described above provide diagnostic information about a detector model and correspond to messages that you might retrieve. Use these messages and suggested solutions to troubleshoot errors with your detector model.

Location

An analysis result with information about Location, corresponds to the following error message:

  • Message – Contains additional information about the analysis result. This can be an information, warning, or error message.

    You might receive this error message if you specified an action that Amazon IoT Events currently doesn't support. For a list of supported actions, see Supported actions.

supported-actions

An analysis result with information about supported‐actions, corresponds to the following error messages:

  • Message: Invalid action type present in action definition: action-definition.

    You might receive this error message if you specified an action that Amazon IoT Events currently doesn't support. For a list of supported actions, see Supported actions.

  • Message: DetectorModel definition has an aws-service action, but the aws-service service is not supported in the region region-name.

    You might receive this error message if the action that you specified is supported by Amazon IoT Events, but the action isn't available in your current Region. This might occur when you try to send data to an Amazon service that isn't available in the Region. You must also choose the same Region for both Amazon IoT Events and the Amazon services that you're using.

service-limits

An analysis result with information about service‐limits, corresponds to the following error messages:

  • Message: Content Expression allowed in payload exceeded the limit content-expression-size bytes in event event-name in state state-name.

    You might receive this error message if the content expression for your action payload is greater than 1024 bytes. The size of the content expression for a payload can be up to 1024 bytes.

  • Message: Number of states allowed in detector model definition exceeded the limit states-per-detector-model.

    You might receive this error message if your detector model has more than 20 states. A detector model can have up to 20 states.

  • Message: The duration for timer timer-name should be at least minimum-timer-duration seconds long.

    You might receive this error message if the duration of your timer is less than 60 seconds. We recommend that the duration of a timer is between 60 and 31622400 seconds. If you specify an expression for the duration of your timer, the evaluated result of the duration expression is rounded down to the nearest whole number.

  • Message: Number of actions allowed per event exceeded the limit actions-per-event in detector model definition

    You might receive this error message if the event has more than 10 actions. You can have up to 10 actions for each event in your detector model.

  • Message: Number of transition events allowed per state exceeded the limit transition-events-per-state in detector model definition.

    You might receive this error message if the state has more than 20 transition events. You can have up to 20 transition events for each state in your detector model.

  • Message: Number of events allowed per state exceeded the limit events-per-state in detector model definition

    You might receive this error message if the state has more than 20 events. You can have up to 20 events for each state in your detector model.

  • Message: The maximum number of detector models that can be associated with a single input may have reached the limit. Input input-name is used in detector-models-per-input detector model routes.

    You might receive this warning message if you tried to route an input to more than 10 detector models. You can have up to 10 different detector models associated with a single detector model.

structure

An analysis result with information about structure, corresponds to the following error messages:

  • Message: Actions may only have one type defined, but found an action with number-of-types types. Please split into separate Actions.

    You might receive this error message if you specified two or more actions in a single field by using API operations to create or update your detector model. You can define an array of Action objects. Make sure that you define each action as a separate object.

  • Message: The TransitionEvent transition-event-name transitions to a non-existent state state-name.

    You might receive this error message if Amazon IoT Events couldn't find the next state that your transition event referenced. Make sure that the next state is defined and that you entered the correct state name.

  • Message: The DetectorModelDefinition had a shared state name: found state state-name with number-of-states repetitions.

    You might receive this error message if you use the same name for one or more states. Make sure that you give a unique name to each state in your detector model. The state name must have 1-128 characters. Valid characters: a-z, A-Z, 0-9, _ (underscore), and - (hyphen).

  • Message: The Definition's initialStateName initial-state-name did not correspond to a defined State.

    You might receive this error message if the initial state name is incorrect. The detector model remains in the initial (start) state until an input arrives. Once an input arrives, the detector model immediately transitions to the next state. Make sure that the initial state name is the name of a defined state and that you enter the correct name.

  • Message: Detector Model Definition must use at least one Input in a condition.

    You might receive this error if you didn't specify an input in a condition. You must use at least one input in at least one condition. Otherwise, Amazon IoT Events doesn't evaluate incoming data.

  • Message: Only one of seconds and durationExpression can be set in SetTimer.

    You might receive this error message if you used both seconds and durationExpression for your timer. Make sure that you use either seconds or durationExpression as the parameters of SetTimerAction. For more information, see SetTimerAction in the Amazon IoT Events API Reference.

  • Message: An action in your detector model is unreachable. Check the condition that initiates the action.

    If an action in your detector model is unreachable, the event's condition evaluates to false. Check the condition of the event that contains the action, to ensure that it evaluates to true. When the event's condition evaluates to true, the action should become reachable.

  • Message: An input attribute is being read, but this may be caused by a timer expiration.

    An input attribute’s value can be read when either of the following occurs:

    • A new input value has been received.

    • When a timer in the detector has expired.

    To ensure that an input attribute is being evaluated only when the new value for that input is received, include a call to the triggerType(“Message”) function in your condition as follows:

    The original condition being evaluated in the detector model: 

    if ($input.HeartBeat.status == “OFFLINE”)

    would become similar to the following: 

    if ( triggerType("MESSAGE") &&  $input.HeartBeat.status == “OFFLINE”)

    where a call to the triggerType(“Message”) function comes before the initial input provided in the condition. By using this technique, the triggerType("Message") function will evaluate to true and satisfy the condition of receiving a new input value. For more information about the usage of the triggerType function, search for triggerType in the Expressions section in the Amazon IoT Events Developer Guide

  • Message: A state in your detector model is unreachable. Check the condition that will cause a transition to the desired state.

    If a state in your detector model is unreachable, a condition that causes an incoming transition to that state evaluates to false. Check that the conditions of the incoming transitions to that unreachable state in your detector model evaluates to true, so the desired state can become reachable.

  • Message: An expiring timer can cause an unexpected amount of messages to be sent.

    To prevent your detector model from entering into an infinite state of sending an unexpected amount of messages because a timer has expired, consider using a call to the triggerType("Message") function, in the conditions of your detector model as follows:

    The original condition being evaluated in the detector model: 

    if (timeout("awake"))

    would be transformed into a condition that looks similar to the following: 

     if (triggerType("MESSAGE") && timeout("awake"))

    where a call to the triggerType(“Message”) function comes before the initial input provided in the condition.

    This change prevents initiating timer actions in your detector, preventing an infinite loop of messages being sent. For more information about how to use timer actions in your detector, see the Using built-in actions page of the Amazon IoT Events Developer Guide

expression-syntax

An analysis result with information about expression‐syntax, corresponds to the following error messages:

  • Message: Your payload expression {expression} isn't valid. The defined payload type is JSON, so you must specify an expression that Amazon IoT Events would evaluate to a string.

    If the specified payload type is JSON, Amazon IoT Events first checks if the service can evaluate your expression to a string. The evaluated result can't be a Boolean or number. If the validation doesn't succeed, you might receive this error.

  • Message: SetVariableAction.value must be an expression. Failed to parse value 'variable-value'

    You can use SetVariableAction to define a variable with a name and value. The value can be a string, number, or Boolean value. You can also specify an expression for the value. For more information, see SetVariableAction, in the Amazon IoT Events API Reference.

  • Message: We couldn't parse your expression of the attributes (attribute-name) for the DynamoDB action. Enter expression with the correct syntax.

    You must use expressions for all parameters in DynamoDBAction. substitution templates. For more information, see DynamoDBAction in the Amazon IoT Events API Reference.

  • Message: We couldn't parse your expression of the tableName for the DynamoDBv2 action. Enter expression with the correct syntax.

    The tableName in DynamoDBv2Action must be a string. You must use an expression for the tableName. The expressions accept literals, operators, functions, references, and substitution templates. For more information, see DynamoDBv2Action in the Amazon IoT Events API Reference.

  • Message: We couldn't evaluate your expression to valid JSON. The DynamoDBv2 action only supports the JSON payload type.

    The payload type for DynamoDBv2 must be JSON. Make sure that Amazon IoT Events can evaluate your content expression for the payload to valid JSON. For more information, see DynamoDBv2Action, in the Amazon IoT Events API Reference.

  • Message: We couldn't parse your content expression for the payload of action-type. Enter a content expression with the correct syntax.

    The content expression can contain strings ('string'), variables ($variable.variable-name), input values ($input.input-name.path-to-datum), string concatenations, and strings that contain ${}.

  • Message: Customized Payloads must be non-empty.

    You might receive this error message, if you chose Custom payload for your action and didn't enter a content expression in the Amazon IoT Events console. If you choose Custom payload, you must enter a content expression under Custom payload. For more information, see Payload in the Amazon IoT Events API Reference.

  • Message: Failed to parse duration expression 'duration-expression' for timer 'timer-name'.

    The evaluated result of your duration expression for the timer must be a value between 60–31622400. The evaluated result of the duration is rounded down to the nearest whole number.

  • Message: Failed to parse expression 'expression' for action-name

    You might receive this message if the expression for the specified action has incorrect syntax. Make sure that you enter an expression with the correct syntax. For more information, see Syntax.

  • Message: Your fieldName for IotSitewiseAction couldn't be parsed. You must use correct syntax in your expression.

    You might receive this error if Amazon IoT Events couldn't parse your fieldName for IotSitewiseAction. Make sure the fieldName uses an expression that Amazon IoT Events can parse. For more information, see IotSiteWiseAction in the Amazon IoT Events API Reference.

data-type

An analysis result with information about data‐type, corresponds to the following error messages:

  • Message: Duration expression duration-expression for timer timer-name is not valid, it must return a number.

    You might receive this error message if Amazon IoT Events couldn't evaluate the duration expression for your timer to a number. Make sure that your durationExpression can be converted to a number. Other data types, such as Boolean, aren't supported.

  • Message: Expression condition-expression is not a valid condition expression.

    You might receive this error message if Amazon IoT Events couldn't evaluate your condition-expression to a Boolean value. The Boolean value must be either TRUE or FALSE. Make sure that your condition expression can be converted to a Boolean value. If the result isn't a Boolean value, it's equivalent to FALSE and doesn't invoke the actions or transition to the nextState specified in the event.

  • Message: Incompatible data types [inferred-types] found for reference in the following expression: expression

    Solution: All expressions for the same input attribute or variable in the detector model must reference the same data type.

    Use the following information to resolve the issue:

    • When you use a reference as an operand with one or more operators, make sure that all data types that you reference are compatible.

      For example, in the following expression, integer 2 is an operand of both the == and && operators. To ensure that the operands are compatible, $variable.testVariable + 1 and $variable.testVariable must reference an integer or decimal.

      In addition, integer 1 is an operand of the + operator. Therefore, $variable.testVariable must reference an integer or decimal.

      ‘$variable.testVariable + 1 == 2 && $variable.testVariable’

    • When you use a reference as an argument passed to a function, make sure that the function supports the data types that you reference.

      For example, the following timeout("time-name") function requires a string with double quotes as the argument. If you use a reference for the timer-name value, you must reference a string with double quotes.

      timeout("timer-name")
      Note

      For the convert(type, expression) function, if you use a reference for the type value, the evaluated result of your reference must be String, Decimal, or Boolean.

    For more information, see References.

  • Message: Incompatible data types [inferred-types] used with reference. This may lead to a runtime error.

    You might receive this warning message if two expressions for the same input attribute or variable reference two data types. Make sure that your expressions for the same input attribute or variable reference the same data type in the detector model.

referenced-data

An analysis result with information about referenced‐data, corresponds to the following error messages:

  • Message: Detected broken Timer: timer timer-name is used in an expression but is never set.

    You might receive this error message if you use a timer that isn't set. You must set a timer before you use it in an expression. Also, make sure that you enter the correct timer name.

  • Message: Detected broken Variable: variable variable-name is used in an expression but is never set.

    You might receive this error message if you use a variable that isn't set. You must set a variable before you use it in an expression. Also, make sure that you enter the correct variable name.

  • Message: Detected broken Variable: a variable is used in an expression before being set to a value.

    Each variable must be assigned to a value before it can be evaluated in an expression. Set the value of the variable before every use so its value can be retrieved. Also, make sure that you enter the correct variable name.

referenced-resource

An analysis result with information about referenced‐resource, corresponds to the following error messages:

  • Message: Detector Model Definition contains reference to Input that does not exist.

    You might receive this error message if you use expressions to reference an input that doesn't exist. Make sure that your expression references an existing input and enter the correct input name. If you don't have an input, create one first.

  • Message: Detector Model Definition contains invalid InputName: input-name

    You might receive this error message if your detector model contains an invalid input name. Make sure that you enter the correct input name. The input name must have 1-128 characters. Valid characters: a-z, A-Z, 0-9, _ (underscore), and - (hyphen).