Documentation is now available for the Fall 2020 Update release!

AWS IOT

Leave Feedback

Introduction

AWS IoT provides secure, bi-directional communication between internet-connected devices,
such as:

  • Sensors
  • Actuators
  • Embedded micro-controllers
  • Smart appliances
  • AWS Cloud

This enables the collect of telemetry data from multiple devices as well as the storage and analyzation of the data. You can also create applications can be created to enable user to control these devices from their phones or tablets.

Rules engine

The Rules engine provides message processing and integration with other AWS services. A SQL-based language is available to:

  • Select data from message payloads.
  • Process and send the data to other services (for example, Amazon S3, Amazon DynamoDB, and AWS Lambda).

The message broker can be used to republish messages to other subscribers.

Jobs service

The Jobs service defines a set of remote operations that are sent to and executed on one or more devices connected to AWS IoT.

For example, you can define a job that instructs a set of devices to download and install application or firmware updates, reboot, rotate certificates, or perform remote troubleshooting operations.

To create a job, specify a description of the remote operations to be performed and a list of targets that should perform them. The targets can be individual devices, groups or both.

Setup

To set up the OpsRamp AWS integration and discover the AWS service, go to AWS Integration Discovery Profile and select IOT Rule for Rule and IOT JOB for Job services.

Metrics

IOT job metrics

OpsRamp MetricMetric Display NameUnitAggregation TypeDescription
aws_iot_ServerErrorServer ErrorNoneAverageNumber of server errors generated while executing the job.
aws_iot_ClientErrorClient ErrorNoneAverageNumber of client errors generated while executing the job.
aws_iot_QueuedJobExecutionTotalCountQueued Job Execution Total CountNoneAverageTotal number of job executions whose status is QUEUED for the given job.
aws_iot_InProgressJobExecutionTotalCountIn Progress Job Execution Total CountNoneAverageTotal number of job executions whose status is IN_PROGRESS for the given job.
aws_iot_FailedJobExecutionTotalCountFailed Job Execution Total CountNoneAverageTotal number of job executions whose status is FAILED for the given job.
aws_iot_SuccededJobExecutionTotalCountSucceded Job Execution Total CountNoneAverageTotal number of job executions whose status is SUCCESS for the given job.
aws_iot_CanceledJobExecutionTotalCountCanceled Job Execution Total CountNoneAverageTotal number of job executions whose status is CANCELED for the given job.
aws_iot_RejectedJobExecutionTotalCountRejected Job Execution Total CountNoneAverageTotal number of job executions whose status is REJECTED for the given job.
aws_iot_RemovedJobExecutionTotalCountRemoved Job Execution Total CountNoneAverageTotal number of job executions whose status is REMOVED for the given job.
aws_iot_QueuedJobExecutionCountQueued Job Execution CountNoneAverageNumber of job executions whose status has changed to QUEUED within a time period that is determined by CloudWatch.
aws_iot_InProgressJobExecutionCountIn Progress Job Execution CountNoneAverageNumber of job executions whose status has changed to IN_PROGRESS within a time period that is determined by CloudWatch.
aws_iot_FailedJobExecutionCountFailed JobExecution CountNoneAverageNumber of job executions whose status has changed to FAILED within a time period that is determined by CloudWatch.
aws_iot_SuccededJobExecutionCountSucceded Job Execution CountNoneAverageNumber of job executions whose status has changed to SUCCESS within a time period that is determined by CloudWatch.
aws_iot_CanceledJobExecutionCountCanceled Job Execution CountNoneAverageNumber of job executions whose status has changed to CANCELED within a time period that is determined by CloudWatch.
aws_iot_RejectedJobExecutionCountRejected Job Execution CountNoneAverageNumber of job executions whose status has changed to REJECTED within a time period that is determined by CloudWatch.
aws_iot_RemovedJobExecutionCountRemoved Job Execution CountNoneAverageNumber of job executions whose status has changed to REMOVED within a time period that is determined by CloudWatch.

IOT rule metrics

OpsRamp MetricMetric Display NameUnitAggregation TypeDescription
aws_iot_TopicMatchTopic MatchNoneAverageNumber of incoming messages published on a topic on which a rule is listening.
aws_iot_ParseErrorParse ErrorNoneAverageNumber of JSON parse errors that occurred in messages published on a topic on which a rule is listening.
aws_iot_RuleNotFoundRule Not FoundNoneAverageNumber of JSON parse errors that occurred in messages published on a topic on which a rule is listening.
aws_iot_RuleMessageThrottledRule Message ThrottledNoneAverageNumber of messages throttled by the rules engine because of malicious behavior or because Number of messages exceeds the rules engines throttle limit.

Event support

CloudTrail event support

  • Supported (Rule: CreateTopicRule, DeleteTopicRule and Job: CreateJob, DeleteJob)
  • Configurable in OpsRamp AWS Integration Discovery Profile.

CloudWatch alarm support

  • Supported (Rule and Job)
  • Configurable in OpsRamp AWS Integration Discovery Profile.

External reference