AWS IoT monitoring integration

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:

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