New Relic offers an integration for reporting your AWS IoT metric data and inventory data.
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 from automatically captured metric data.
- Set alert conditions on your AWS IoT integration data directly from the New Relic Integrations page.
Activate integration
To enable this integration follow standard procedures to Connect AWS services to New Relic.
Configuration and polling
By default, New Relic queries your AWS IoT services every 5 minutes. If you want New Relic to query your services less often, you can change the polling frequency.
Explore integration data
After connecting the AWS IoT integration to New Relic and waiting a few minutes, you can use integration data:
View AWS IoT integrations data | Do this |
---|---|
Dashboards and alerts | Go to one.newrelic.com > Infrastructure > AWS > IoT. |
Metric data on custom dashboards | Go to the query builder and create queries for IOTBrokerSample , IOTRuleActionSample , and IOTRuleSample events. |
Inventory data for AWS IoT entities | Go to one.newrelic.com > Infrastructure > 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, 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 to view data for the following attributes:Name 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 to view data for the following attributes:Name Description success
Number of successful rule action invocations. The RuleName
dimension contains the name of the rule that specifies the action that was invoked. TheActionType
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. TheRuleName
dimension contains the name of the rule that specifies the action. TheActionType
dimension contains the type of action that was invoked. - IOTRuleSample events
-
Query
IOTRuleSample
events to view data for the following attributes:Name 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 one.newrelic.com > Infrastructure > Inventory and search for or select the following:
- aws/iot/broker/
-
Name Description protocol
Protocol used by the broker. - aws/iot/rule-action/
-
Name 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
-
Name 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.