The feed details page displays the configuration settings of your feed and provides several feed management capabilities. These include editing, cloning (making a copy), starting, sharing, and deleting the feed. You can add the feed to a new real-time analytic or open it in a map viewer to visualize the data. Additionally, you can view feed logs and metrics from the associated tabs on the details page.
Edit a feed
To edit a feed, click the Edit button on the feed details page. This opens the feed in the configuration wizard. You can update feed connection properties, resample the incoming data, adjust the schema, update the key fields, and rename the feed.
Editing a feed follows the same steps as defining a new feed, however if you proceed past a step without making changes, the subsequent step(s) will not have to be reconfigured.
When editing a feed, if you change connection properties, Analytics for IoT will automatically re-test the connection and resample for data. If the new samples derive a schema that is different than the one that is currently configured, you can choose to keep the current schema or overwrite it with the new schema.
If you overwrite the current schema, you may have to reapply your settings in the Identify Key Fields step.
View feed details
The configuration of the feed is displayed on the Details tab in three sections:
- Feed Details - The connection properties of the feed based on the underlying feed type.
- Format Details - The data format and data parsing configuration. This includes, for example, the field separator for delimited data or the root node in the case of JSON data.
- Schema Details - The list of attributes that have been defined for the feed. This list reflects any changes that were made in the configuration wizard such as renaming or dropping fields. It also identifies which fields are used to supply START_TIME, END_TIME, or TRACK_ID properties.
View feed logs
The Logs tab of the details page displays logs that have been captured for a running feed. Common logs you may encounter include message parsing errors or warnings when incoming data is missing the expected geometry or date and time information.
Logs can be filtered by level such as INFO or DEBUG and can be viewed over different time ranges such as the past hour or the past day. Logs for a running item such as a feed are available for up to 7 days.
View feed metrics
The Metrics tab of the details page displays metrics including current event rate as well as metrics over time. The current event rate always reflects the number of events or messages per second over the last 5 minutes. Metrics that can be averaged over longer time intervals include events per second, attributes per second, and bytes per second. These metrics can be displayed over the last hour, day, or week.
Currently, metrics averaged over time represent values averaged over that whole period, including any time in which the feed is stopped or if it has not yet be run. For this reason, rates reported might be lower than if the feed had been running for the entire period chosen.