AWS IoT monitoring integration

Access to this feature depends on your subscription level. Requires Infrastructure Pro.

New Relic Infrastructure offers an integration for reporting your AWS IoT metric data and inventory data so you can view it in the New Relic UI.

AWS IoT is a service that provides communication between Internet-connected devices and the AWS Cloud. It also collects and stores telemetry data. With the AWS IoT Infrastructure integration, you can access these features:

  • View charts and other information about your AWS IoT communication and telemetry data.
  • Create custom queries and charts in New Relic Insights from automatically captured metric data.
  • Set alert conditions on your AWS IoT integration data directly from the New Relic Infrastructure Integrations page.

Activate integration

To enable this integration:

  1. Make sure you have installed the Infrastructure agent before you activate AWS integrations from your Infrastructure account.
  2. Follow standard procedures to Connect AWS services to Infrastructure.

Configuration and polling

By default, New Relic Infrastructure queries your AWS IoT services every 5 minutes. If you want Infrastructure to query your services less often, you can change the polling frequency.

Explore integration data

After connecting the AWS IoT integration to New Relic Infrastructure and waiting a few minutes, you can use integration data in Infrastructure Integrations and in Insights:

View AWS IoT integrations data Do this
Dashboards and alerts Go to infrastructure.newrelic.com > Integrations > Amazon Web Services > IoT.
Metric data on custom dashboards Go to insights.newrelic.com and create queries for IOTBrokerSample, IOTRuleActionSample, and IOTRuleSample events.
Inventory data for AWS IoT entities Go to infrastructure.newrelic.com > Integrations > Inventory and search for or select aws/iot/broker/, aws/iot/rule-action/, or aws/iot/rule.

Metric data

To view metric data for your AWS IoT integration in Insights, create NRQL queries for IOTBrokerSample, IOTRuleActionSample, and IOTRuleSample events and their related attributes. For more information on AWS IoT metrics and dimensions, see the AWS IoT Developer Guide.

IOTBrokerSample events

Query IOTBrokerSample events in Insights to view data for the following attributes:

Attribute Description
connect.AuthError Number of connection requests that the message broker could not authorize.
connect.ClientError Number of connection requests rejected because the MQTT message did not meet the AWS IoT requirements.
connect.ServerError Number of connection requests that failed because of an internal error.
connect.Success Number of successful connections to the message broker.
connect.Throttle Number of connection requests that were throttled because the client exceeded the allowed connect request rate.
ping.Success Number of ping messages that the message broker received.
publishIn.AuthError Number of publish requests that the message broker could not authorize.
publishIn.ClientError Number of publish requests that the message broker rejected because the message did not meet the AWS IoT requirements.
publishIn.ServerError Number of publish requests that the message broker failed to process because of an internal error.
publishIn.Success Number of publish requests that the message broker successfully processed.
publishIn.Throttle Number of publish requests that were throttled because the client exceeded the allowed inbound message rate.
publishOut.AuthError Number of publish requests that the message broker made that could not be authorized by AWS IoT.
publishOut.ClientError Number of publish requests that the message broker made that were rejected because the message did not meet the AWS IoT requirements.
publishOut.Success Number of publish requests that the message broker successfully made.
subscribe.AuthError Number of subscription requests made by a client that could not be authorized.
subscribe.ClientError Number of subscribe requests that were rejected because the SUBSCRIBE message did not meet the AWS IoT requirements.
subscribe.ServerError Number of subscribe requests that were rejected because of an internal error.
subscribe.Success Number of subscribe requests that the message broker successfully processed.
subscribe.Throttle Number of subscribe requests that were throttled because the client exceeded the allowed subscribe request rate.
unsubscribe.ClientError Number of unsubscribe requests that were rejected because the UNSUBSCRIBE message did not meet the AWS IoT requirements.
unsubscribe.ServerError Number of unsubscribe requests that were rejected because of an internal error.
unsubscribe.Success Number of unsubscribe requests that the message broker successfully processed.
unsubscribe.Throttle Number of unsubscribe requests that were rejected because the client exceeded the allowed unsubscribe request rate.
deleteThingShadow.Accepted Number of DeleteThingShadow requests processed successfully.
getThingShadow.Accepted Number of GetThingShadow requests processed successfully.
updateThingShadow.Accepted Number of UpdateThingShadow requests processed successfully.
IOTRuleActionSample events

Query IOTRuleActionSample events in Insights to view data for the following attributes:

Attribute Description
success Number of successful rule action invocations. The RuleName dimension contains the name of the rule that specifies the action that was invoked. The ActionType dimension contains the type of action that was invoked.
failure Number of failed rule action invocations. The RuleName dimension contains the name of the rule that specifies the action that was invoked. The RuleNamedimension contains the name of the rule that specifies the action. The ActionType dimension contains the type of action that was invoked.
IOTRuleSample events

Query IOTRuleSample events in Insights to view data for the following attributes:

Attribute Description
topicMatch The number of incoming messages published on a topic on which a rule is listening. The RuleName dimension contains the name of the rule.
parseError The number of JSON parse errors that occurred in messages published on a topic on which a rule is listening. The RuleName dimension contains the name of the rule.

Inventory data

To view inventory data for AWS IoT, go to infrastructure.newrelic.com > Integrations > Inventory and search for or select the following:

aws/iot/broker/
Inventory data Description
protocol Protocol used by the broker.
aws/iot/rule-action/
Inventory data Description
ruleArn ARN for the rule.
ruleName Name of the rule.
topicPattern Pattern for the topic names.
actionType The action type specified by the rule that triggered the request.
aws/iot/rule
Inventory data Description
ruleArn ARN for the rule.
ruleName Name of the rule.
topicPattern Pattern for the topic names.
createdAt Date and time when you created the rule.
ruleDisabled Boolean that specifies whether or not the rule is disabled.

For more help

Recommendations for learning more: