The Afero Console is designed for partners so they can monitor and visualize their device deployments and usage. It offers aggregated, real-time location views of partner devices as well as individual device use history.
The Console is easy to use and self-documenting. A description of the user interface is presented on this page; but first, some useful definitions of terms you’ll encounter when using the Console.
|Active Device||A device that has sent at least one attribute update within the given time period.|
|Activity||The history of events that have affected the state of a device. Events can be attribute value changes, device associations/disassociations, and device available/unavailable status changes.|
|Attribute||A variable used to describe the current state of an IoT device. It is shared between the IoT device, the Cloud, and, if the attribute’s values are exposed to the end-user to control the device, the Afero mobile app. It’s the smallest useful piece of data that can be communicated between the device and the Cloud. Read more in What Is an Attribute?|
|A device is “associated” with an end-user’s account when the user scans or types the device’s QR code (representing the device’s “Association ID”) in the Afero mobile app. (This is also referred to as “onboarding”.) Association will only happen in the context of an end-user’s account, and a device can be associated with only one end-user account at a time. Devices can be “disassociated” from the account using the mobile app Device Settings screen > Remove Device option.|
|A device is “available” when it is powered on and connected to the Afero Cloud. It is “unavailable” when it is either powered off, or powered on but not connected to the Cloud. Connection to the Cloud is via Bluetooth or Wi-Fi.|
|Device||An individual, internet-connected physical object, able to communicate with other connected devices and computer systems.|
|Device ID||The primary, unique identifier for an individual device in the Afero system.|
Defined using the Afero Profile Editor and part of the profile’s “Device Type Definition”. Once you use the Profile Editor to publish a device profile to a device, an ID is associated with the “device type” (also referred to as the project) that remains unchanged as long as that device type/project is active.
Note that you can always rename your device type, but once published, the
|Event||An attribute value change or other operation that affects the state of a device.||Linked Timestamp||The last time the device linked to the Afero Cloud. The linked timestamp is displayed in the Individual Device Data Viewer, labeled as Extended Data.|
Many attributes have associated UI controls, the elements in the mobile app that allow end-users to read, and in some cases change, attribute values. Some attribute controls simply report a numeric value to the end-user, but others are labeled so the end-user understands the value meanings. These labels are referred to as “Value Options”.
For example, a Fan Speed attribute might have four possible values: 0-3. In the mobile app, you'd like to display these values using friendly words, rather than simple digits. To do that you’d use the Afero Profile Editor to define Value Options so that when the attribute value = 0, the control displays the string "Off"; when the value = 1, the display shows "Low”, 2 = “Medium”, and 3 = “High”.
Go to https://console.afero.io then sign in with your Afero partner username (email) and password.
To sign out, click the arrowin the upper-right of the main Console window.
To view any of the windows in the Afero Console, use the left-hand Navigation pane. In addition to the Real-Time Activity window, which opens by default, you’ll find links to Device Listing, Device Type Reports (click to see all your device types), Platform Usage, Platform Status, the Developer Portal, and the Dev Portal page with links for purchasing Afero hardware. The Console windows are described and illustrated below:
Click Real-Time Activity in the left-hand Navigation pane to open a window displaying by location the activity, or lack of activity, taking place on your devices in the field (your fleet) in real-time. Only devices experiencing an event will display. Device indicators are color-coded by event class, or type:
The number of events occurring, by activity type, are displayed in the key below the map.
You can switch between a map of the world (Global Map) or United States (USA Map). Zoom in/out, go full screen, switch among map, satellite, terrain, and street views, or jump to a map location, by using the usual Google Map controls.
To clear the map of all device activity, click the Clear Markers button in the upper-right corner.
Click Device Listing in the left-hand Navigation pane to open a window displaying all your devices, including methods for filtering and finding a specific device or set of devices.
You can package and download the contents of this device listings table (with additional Creation Date, Profile ID, and Location information) into a zipped .csv file. Click the download icon on the far rightthen click the download link that appears. When unzipping the file, you'll be prompted to enter the password provided under the download link (use copy & paste).
To view usage data on an individual device, do any of the following:
On successful search or navigation, the Device Details tab opens. The Attribute Browser tab displays each attribute definition, how this attribute is presented on the mobile UI, and attribute update history (updates that occurred in the last 31 days, up to 200 entries).
Click Device Type Reports in the left-hand Navigation pane to show a list of all your device types, then select a specific device type to view its usage metrics.
Note that metrics are shown in date ranges; click (in the upper-right) From This Week, From This Month, or Select Date Range (to customize the range):
You’ll be able to view your device type usage in the following ways:
At the top are four metrics: number of devices currently associated (attached to an end-user account) and pending association (produced but not yet associated), and total number of devices currently online (available) and offline (unavailable).
This table displays, for a selected device type, each partner-defined attribute’s usage, important information for determining how customers are using a specific type of device. In the example, the attributes compared are EcoMode, Heating Level, and Fan Speed. You can see that Fan Speed has changed more than the others.
To the right of the Attribute Usage table is a donut graph or bar chart showing how end-users have used each of the attributes' values.
To start, click an attribute in the Attribute Usage table, then look right to the graph or chart to see how popular that attribute’s values have been, based on how many times the customers have changed the value in the given timeframe.
To view the popularity of a subset of values, select only the desired values using the View in Chart checkboxes in the table below the graph.
To see the total number of times that an attribute value was selected in the given timeframe, hover over an attribute value in the graph or look in the Total Records column in the table.
Attribute values are identified in this table using their labels, or Value Options. These labels are displayed to the end-user in the mobile app UI, as control options.
Scroll down the page to see the Relative Associated Device Distribution map. Use this map to see at a glance where all your associated devices are located, at this point in time.
You can switch views between United States only or Global by toggling the iconin the upper-right of the window.
Scroll further down the window to see the cumulative rate of device association trend over time.
Scroll down to see a graph displaying the versions running on the associated devices. To report a version number, a device must have been associated and connected to the Afero Cloud. Those reporting an unknown version have not yet connected to the Cloud.
To find out how associated devices have connected to the Afero Cloud, Bluetooth or Wi-Fi, scroll down to the Connection Type Breakdown graph.
Click Platform Usage on the left-hand Navigation pane to display month-to-date details for each device type:
Totals across device types are also provided.
You can view the current status of the Platform by clicking Platform Status in the left-hand Navigation pane or the checkmark iconin the upper-right of the main window.
Status is checked automatically every minute and reported as healthy if all subsystems are operating as expected. A degraded status means some part of the Platform has reported a less than optimal status, and also means the Operations Team has been notified.