Multi-Tag Report Widget
Summary
The multi-tag report widget is used to display count or state information from multiple tags in the form of a table. The tags being analyzed form the rows, and the columns aggregate the data into chunks of time. You are free to specify these time periods as certain hours, days, weeks, or months. Additionally, each cell in the table is capable of showing the aggregated data in one or more formats:
- Number of times a tag transitioned into or out of a state
- Total time in a state, displayed in Hours:Minutes:Seconds
- Percentage of time in a state
Examples at a glance
A simple one-tag report counting the number of daily switch activations, seven days a week.
Common applications
- Identify which production lines or shifts are operating with maximum uptime.
- Count how many times machines activate to instantly report hourly/daily/weekly/monthly output.
- Count how often individual machines enter an error state to identify issues and prioritize maintenance.
Interface Breakdown
Hover over a multi-tag report widget, click the Configure Widget button (
), and select the stacks and tags you wish to analyze. Then, click ‘Next’ to proceed to the options panel below.
- Time Range: Use the dropdown to define the time range to be aggregated in each column of the report: A day, a week, or a month.
- Configured Timeslots: Click the ‘Create New’ button to specify a bucket of time between 0 and 24 hours to include in the report. This determines what data within each day, week, or month should be included in the report. For example, the timeslot below would include only data from 9:00 AM to 5:00 PM Monday through Friday in your report. Add additional timeslots to create more complex reports or comparisons.
- Periods to show: Define the number of horizontal columns to display in the widget. For example, setting Time Range to ‘Week’ and periods to ‘3’ would show three weeks of aggregated data, one week per column.
- Timezone: Set the timezone you’d like the widget to apply when processing the timeslots above. ‘Default to current timezone’ will use your computer’s current settings.
- Reporting: Select whether you would like to analyze your data based on ‘States’ or ‘Counts’
- Use States to interpret continuous/analog data. For example, you can track how long a machine is in ‘Active’, ‘Idle’, and ‘Off’ states each day based on its power consumption. Learn how to define states in our Intro to Properties and States Properties articles.
- Use Counts to interpret discrete/digital data. For example, you might count the number of times a button is pressed.
- States With Intervals: Turn on ‘With Intervals’ to display the total time or percentage of time that a tag is in each selected state. This can help you answers questions like, ‘How many hours does the drill press stand idle each day?’
- States With Transitions: Turn on ‘With Transitions’ to display the number of times that a tag enters and exits each selected state. This can help you answer questions like, ‘How many times does the drill press activate each day?’
Customizing Display Options
Hover over a multi-tag report widget and click the Display Options button (
) to apply colors or icons when a value meets certain conditions. This interface is explained in detail in our tutorial on creating your first dashboard, and is extremely useful for elevating critical datapoints and/or making large quantities of data easy to parse, as in the example below.
