This page summarizes user visible changes to the Preseem UI, API and also includes release notes for the network element software.
UI Update (2020-09-28)
The latest release is the next step in our process of improving the usability, look and underlying infrastructure of the Preseem UI. There are a lot of visual changes in this release but the changes under the hood are even larger and provide the foundation for the new features we are working on.
The search functionality in Preseem has gotten both visual and functionality improvements.
Most notably, the search bar has moved to a central location at the top of all views. This makes search a more central part of Preseem and addresses some consistency problems.
The search itself has gotten smarter with a new subnet aware IPv4 and IPv6 search functionality. This means you can now search for 192.168.0.100/25 and find all the matching IPs including those that don’t match via a simpler text based algorithm. This is accomplished through having a longest prefix match search much like how a routing table works.
Also, the search now maintains a history of recent search strings making it easy to repeat a search or flip between search results.
Preseem consists of several ‘sub-applications’ such as the Wireless Summary and Explore. In previous versions of the UI, each of these had their own modes inside their specific view. This made it impossible to switch directly between the modes without extra clicks and data loads. Also, the visual implementation of mode switching was inconsistent. In this release we’ve moved all navigation to the left menu bar to make it easy to jump directly between these views and aid in discovery of these features.
Date and Time Picker
Selecting the date and time is core to many aspects of the Preseem UI. In this release we’ve worked to improve the date and time picker and made it more consistent throughout the application.
The picker now stores recent time ranges that were used making it easy to jump between different times.
The calendar widget has been improved to show the date range selected.
URLs and Link Sharing
Previously, there was one area in the application which contained user preferences as well as company-wide settings. This has been split into a separate profile area, accessed from the top right and the main settings area accessed from the main menu. This more closely follows the pattern used in many other web applications.
The above are some of the larger and more obvious changes. The total number of changes is too large to list and includes:
- The app now makes many fewer API calls when loading the Explore views which decreases the load time and network traffic
- Many visual interaction elements such as drop down selectors and toggle buttons have been overhauled and made consistent throughout every view in the application
- The Settings and Export views have gotten a visual overhaul and many usability improvements
Preseem Element 1.12.0 (2020-09-28)
The Preseem element software refers to the software that runs on the hardware that is deployed in the network (vs cloud side of Preseem).
Preseem now supports IPv6 for all use cases. This includes the ability to assign subscribers a prefix of arbitrary length.
IPv4 with Prefixes of Arbitrary Length
Previously Preseem modelled subnet assignments to customers as a number of /32 assignments. For example a subscriber who was assigned a /30 would result in four internal /32 mappings. Preseem now supports assigning any prefix length to a subscriber without expanding these into /32 entries internally.
Improvements and Bug Fixes
- Preseem supports several traffic management models which we call policies. These policies require different base system settings including one specific setting called XPS. Previously, switching policies required a system reboot to modify the XPS settings. Although switching policies is a very rare activity for most of our customers, we have now made this automatic and reboots are no longer required.
- A connection keep-alive problem caused some services to disconnect once on initial service start. This caused information between services to be synchronized twice unnecessarily.
- The maximum message size for inter-service messaging was increased to enable preseemctl to extract larger amounts of data for operational inspection purposes.
- Adjust to a behavior change in ethtool 5.8 which caused errors in the system configuration scripts.
- Upgrade several dependencies
Access Point Configuration API (2020-08-17)
The Preseem Model API can now be used to configure Sector Shaping and SNMP polling credentials for access points.
This API allows other systems to configure the maximum downstream and upstream bitrates for all traffic transiting an AP. It also allows other systems to query sector shaping configuration done in the Preseem web interface.
This API also allows other systems to configure the SNMP community and SNMPv2 access credentials that Preseem will use to poll an AP.
UI Update (2020-05-20)
We are currently in the process of major UI refactoring and infrastructure improvements to make the user experience better and support new features that are in the pipeline. The UI released today is the first output of this project and contains many under the hood improvements and a few user facing ones as well.
New Global Navigation
As we continue to improve our user experience we have introduced a new global navigation with improved performance of navigating between views with-in Preseem.
Updated Metric Navigation
We have made several improvements to our Explore view including a new topology picker and a better search experience.
Visual Refresh of User Settings
The settings view now contains company and user settings in one convenient location.
Beta UI Channel
Users are now able to choose if they wish to use the fully released version of the UI or if they wish to opt-in to the beta release where new features are released before becoming available to everyone by default.
Bulk Usage Export (2020-03-04)
Preseem collects key metrics such as byte counts for every IP address that passes through the system. These metrics are then aggregated by subscriber, access point and other dimensions.
Many of our customers have asked for a way to export subscriber usage information for analysis or simple billing purposes. This is now possible with the billing export which supports downloading usage in both JSON and CSV formats. The simple CSV format is particularly useful for pulling data into a spreadsheet for quick analysis.
Bulk Usage API (2020-03-04)
Preseem has supported pushing per-subscriber usage information to billing systems for some time but this information was not available to other external systems. This has now been addressed with the release of our bulk usage API which enables callers to obtain usage information for all subscribers at once. The details of the API can be found on our API docs site.
Access Point Metrics (2020-02-10)
Preseem's core QoE metrics, taken directly from the subscriber traffic, provide a strong picture of the network quality delivered to individual towers, access points and subscribers. While these metrics are great at identifying problems, they don't help in troubleshooting the root cause of QoE problems.
To make it easier to identify the root cause of access point related QoE problems, Preseem now collects and analyzes metrics collected directly from the access point via SNMP and other management interfaces. These metrics are shown along with the core Preseem QoE metrics when looking at an access point.
Each chart has an (i) icon at the top right; you can hover or click on this to see a description of the metric.
The collected metrics range from simple items like the packet rate per interface through to vendor specific wireless metrics. Examples include:
- Cambium 450m: Ethernet Interface Speed, Ethernet Bytes, Ethernet Packets, RF Bytes, RF Packets, RF Packets Dropped, Frequency, RSSI, Connected Stations, Frame Utilization, GPS Sync and Channel Width.
- Ubiquiti Rocket M5: Ethernet Bytes, Ethernet Interface Speed, Ethernet Packets, RF Bytes, Channel Width, Frequency, RF Packets, RF Transmit Power, Connected Stations, AMC, Minimum AMC, AMQ, Minimum AMQ, CCQ and Minimum CCQ.
A list of access points models along with the metrics we collect for them is available at the link below:
New Data Export: IPs with No Metadata (2020-01-08)
Preseem integrates with billing systems and polls network elements to map IP addresses to accounts and network topology. The goal is to have a high percentage of traffic mapped, to maximize the effectiveness of the QoE analysis and improvement functions of Preseem. The System tab of the Explore view shows the percentage of bytes mapped to accounts, and the charts in the Wireless explore view show the amount of traffic mapped to topology. This new data export provides a list of IP addresses that are not mapped to an account or to network topology.
There is a new button on the left sidebar of the Preseem app which provides access to data exports.
Pressing this button displays a configuration panel for the data export. Select a time range, whether or not to include currently mapped IPs in the report, and the minimum traffic threshold. Detailed help on each setting can be seen by hovering over the (i) icon beside each setting.
Clicking on the "Download" button will download a CSV file that should automatically open in your default spreadsheet application.
For more information on troubleshooting IP mapping, see the knowledgebase entry.
Access Point Shaping Rate Display (2019-11-12)
Preseem supports access point (AP) rate shaping to ensure a good subscriber QoE on overloaded APs. This is accomplished by keeping the bandwidth below the link saturation point so that Preseem's AQM techniques can still optimize the subscriber experience.
Now, when the AP shaping rate is set, the shaping rate is plotted on the bandwidth chart for the AP making it more obvious when AP shaping is enabled.
New Data Features (2019-10-10)
Preseem collects billions of metrics per day about network, access point and subscriber quality of experience (QoE). Leveraging this dataset to help our customers understand and diagnose network problems is a big focus for us. Below are a few new features to help you understand the root cause of QoE problems and manage network capacity.
Access Point (AP) Comparisons
Preseem sees data from tens of thousands of access points. Using this dataset we now build a model of the performance for each access point model and use this performance model throughout the system to provide an accurate picture of what the AP should be capable of.
To make it simple to compare an individual AP against the performance model, we now plot key metrics overlaid on each of your individual APs. By looking at these comparisons it is possible to identify under-performing APs and those that have reached the limits for the model and should be split or upgraded.
The Busy Hours metric is designed to tell the operator how many hours in the given day that the AP is operating at or near capacity. Since the network quality of experience is at its worst when the AP is busy, this tells the operator how often subscribers receive the worst case QoE. This metric has been enhanced to make use of the per-AP model information built from all access points that Preseem monitors, making it much more accurate, especially in cases when the AP has a small number of subscribers.
All consumer access networks are oversubscribed. The business model simply doesn't work to give every customer dedicated bandwidth from the edge to the Internet. However, monitoring the oversubscription ratio is an important step to ensuring that the access network doesn't get overloaded and that subscribers get a good QoE. Preseem calculates the oversubscription ratio as:
sum(subscriber plans on AP) / typical performance of the AP
where the typical performance is based on the model built from analyzing the thousands of APs that Preseem monitors.
The next edition of the Preseem Fixed Wireless Report (to be released 2019-10-14) provides an analysis of per-AP oversubscription across the industry.
Daily View of Wireless Summary Metrics
Preseem's Wireless Summary provides a summary of the network QoE when the network is at its busiest based on a combination of active subscribers and throughput. Since an idle network almost always delivers good QoE, measuring QoE at the busiest times of day provides a much more accurate picture of the real subscriber experience.
Previously the daily Wireless Summary metrics for an individual AP were only available in table form. Now, these important metrics can be viewed over time to see longer term trends and better plan upgrades or other changes that are required to maintain a good QoE. This view also provides comparison information for the same AP model and channel width to provide guidance on what one can reasonably expect out of the given AP model.
Wireless Summary has been further enhanced to show:
* The AP vendor and model
* The number of connected stations (previously only active subscribers was present)
Preseem Element 1.10.0 (2019-10-04)
The Preseem element software refers to the software that runs on the hardware that is deployed in the network (vs cloud side of Preseem).
The main focus of this release is a significant performance increase for all platforms that run Preseem. Small change list, lots of work.
- Significantly increase throughput both in terms of bandwidth and packets per second for all hardware platforms. This was accomplished by reducing lock contention and making better use of many CPU cores.
- Improved logging of link state changes to better enable debugging of link level problems
- Reduce the time required to create shaper instances and other state when new IPs are observed. This reduces the time to start publishing metrics for deployments with many thousands of subscribers (smaller deployments won't notice this).
- preseemctl session show now has a --format=csv option to aid in investigating session state
- preseemctl debug ipmap now has a --format=csv option to aid in investigating internal IP counters
- preseemctl debug internal-metrics now exposes internal process metrics
- This release changes system parameters that can only be modified at boot time. Therefore a system reboot is required after the upgrade.
- Preseem appliances are automatically configured (post-reboot) for maximum performance.
Additional, hardware specific configuration is required to get maximum performance from customer provided hardware. Without these changes, the performance will remain roughly the same as previous releases. Please work with Preseem Support when upgrading to make the appropriate changes.
Chart Context Menu (2019-09-10)
Preseem has long supported keyboard shortcuts which enable you to search for or jump to the items in the chart legends. While these keyboard shortcuts made it much faster to navigate and use Preseem, they weren't easy to remember and required users to become 'power users' quickly. We have now added a right click context menu to the chart legend to solve these problems. The context menu both allows you take the available actions (select, drill down, search) and shows the keyboard shortcuts so those users wishing to become power users can do so over time without having to remember the keyboard combinations. Yay!
Search Improvements (2019-09-10)
Previously, the IP search would only match IPs attached to subscribers. The search results now contain IPs that are not currently assigned to subscribers.
The Support search now leverages search improvements introduced on Explore earlier. This makes it more intuitive to find subscribers based on various portions of the subscriber name or identifier.
Billing Admin Improvements (2019-09-10)
The billing page now enables admin users to change the email address that receives invoices and payment receipts.
It is now also possible to view the entire invoice history and download copies of each invoice.
Display Density (2019-07-19)
Some customers have very long identifiers such as the subscriber, access point and other network element names. For these customers the default layout is too small. To address this we added a setting which changes the layout to add more space for those that need it.
Quick Link From AP to Tower (2019-07-02)
When viewing an Access Point the only way to get back to the associated tower was to select it from the tree view again. This was annoying so we added a quick link in the Access Point view.
Latency Chart Normalization (2019-06-28)
The Tower and Sector level latency charts previously graphed the 80th percentile latency for all latency samples tagged to that tower or sector. This had the drawback that specific customer services with a high number of samples could have an unfair influence on the sector's latency chart, and a specific sector with a high number of samples could have an unfair influence on the tower's latency chart.
This change normalizes sectors by customer sessions and towers by sector, so that the latency chart provides a better representation of the overall quality experienced by customers on that tower or sector.
An example of the Explore view for a sector is shown below. The first picture is without normalization, and the second picture is with normalization. Notice that the second chart follows the shape of the majority of customer sessions more closely.
This change takes effect on the Explore application and the Support application.
API for Third Party Integrations (Beta) (2019-06-21)
Preseem has built-in integrations with many of the billing systems commonly used by WISPs which makes it very easy to get up and going when one of the supported billing systems is in place.
However, not all WISPs use one of the supported billing systems so a mechanism to integrate with home grown or other billing systems is required. While our trusty 'Google Sheets' integration is great for trials, a more programmatic approach is desirable. To that end, we have added a new external model API which can be used to build these integrations. At present, we consider this to be beta but there are already customers using it in production.
New Search Backend (2019-06-14)
Both the Explore and Search views in Preseem contain a search feature which enables the user to search all of the information that Preseem contains such as the access points and subscribers.
Previously, the search in Explore had two modes. The first mode would do partial matches based on the entered text. The second mode did an exact match on the entered text when enter was pressed. This behaviour wasn't intuitive as the results changed if enter was pressed or not.
The Explore search now acts like a Google search. That is, any entered text is used for the search whether or not enter is pressed. To make this work we rebuilt the back end to add a scoring system to the search results so that the most relevant results are shown first. The new search also tokenizes the string before performing the search so that "Joe Smith" and "Smith Joe" will return the same search results.
Element Properties (2019-06-14)
The System view in Explore shows information about individual Preseem network elements. Previously the list of elements only showed the element ID and it was not possible to remove decommissioned elements without asking Preseem support. It is now possible to set a pretty name for the element which will be used throughout the UI and it is also possible to remove elements that are no longer live.
The ability to manage elements is one step towards the alerting features we're working on.
Wireless Summary Export Filename
The daily view in Wireless Summary includes the ability to download the current table view as a CSV which is useful for ad-hoc data analysis or building internal KPIs. The filename of the export now contains the current date, so that subsequent downloads won't overwrite previously saved data.
Preseem Element 1.8.2 (2019-05-10)
This release of the Preseem element software contains small improvements and bug fixes.
- preseemctl system show now includes how long each process has been running
- Upload byte and packet counts were double counted for IP fragments
- preseemctl system check now sanity checks the management interface configuration
- preseemctl system check now properly validates the traffic direction
- preseemctl version show now shows the platform package information
- Preseem 10000: Change core assignment to optimize throughput
Wireless Summary Busy Hours (2019-05-10)
The Wireless Summary view contains a daily access point metric called Busy Hours. This metric is designed to provide an indication of how busy the access point is by calculating the amount of time per day that it operates near its maximum capacity.
Previously the Busy Hours metric was represented as a progress bar with the % of the day that the access point was operating near its capacity. This was misleading because low percentages like 25% look OK but in reality an access point that is at capacity for 25% of the day is heavily loaded. To address this problem, the representation has been changed to be the number of hours in the day that the access point is busy. If this is longer than a couple hours, then the access point may be in need of an upgrade or split.
Subscriber Details (2019-05-10)
The Explore view has been extended with a subscriber details panel to save you from having to search or jump to the support view to get subscriber information. Yay for fewer clicks!
Element System Stats (2019-05-10)
The element view has been extended to add a lower level system details view which exposes items like the raw link rate (vs. the traffic Preseem is inspecting) and link CRC errors. This makes it easier to debug system load and physical layer problems.
Element Details (2019-05-10)
The element view has been extended to include useful information about the hardware, OS and Preseem software. This saves you from having to login to the element to get this information and makes it easier to manage networks with multiple Preseem elements.
Search By IP in Support (2019-04-26)
When taking a support call, it is often useful to be able to search by the subscriber's IP address not just their name. This is now possible directly in the support view (this has been available in Explore for a long time).
API Key Management (2019-04-19)
Preseem API keys are used to provide access to the cloud by Preseem network elements and by third party entities like our billing partners. Now you can create, modify and delete your API keys yourself!
Don't worry, I removed that key after creating the screenshot :)
Access Point Details (2019-04-12)
When trying to understand the network QoE it is often useful to know information about the access point of interest. To help make this easier we have added an access point details panel which appears when looking at the QoE metrics associated with an access point. The available information includes:
- Access point vendor
- Access point model
- Firmware version
- Number of connected stations
- Transmission Power
- Channel Width
This new panel also includes a handy link to the AP's management interface so you can jump there quickly!
Wireless Summary Quick AP Summary (2019-04-10)
The main Wireless Summary view shows the number of APs by state (color) over time. We added a little tooltip to show the number of APs in each state to make it easier to use these numbers as an internal KPI.
Preseem Element 1.8.0 (2019-04-05)
The Preseem element software refers to the software that runs on the hardware that lives in the network.
The main focus of this release is improving system level performance and increasing subscriber throughput in the presence of high levels of wireless retransmissions.
- Platform optimizations which decrease latency and increase throughput across all Preseem platforms
- New in-memory metrics cache reduces system load and wear on local SSDs
- New custom platform hooks to enable system level optimizations on custom hardware
- Greatly reduce the network impact of restarting core services. This makes it faster and easier to perform upgrades in large networks.
- Optimized shaping parameters to better balance latency and throughput on less than perfect wireless links
- Added JSON and CSV output formats to preseemctl’s metadata list and session list commands to enable easier processing of this information for debugging and integration purposes
- Added new ‘preseemctl system check’ command which validates both the Preseem and system configuration to quickly identify deployment problems
- Many smaller performance improvements and bug fixes
- Standard Preseem upgrade instructions
- The minimum supported kernel version is 4.20
- Generic hardware (not Preseem appliances) and Preseem 1000 deployments must install the appropriate platform package before upgrading the other Preseem packages (platform packages for the Preseem 5000 and 10000 already exist in previous versions and will be upgraded). One of the following commands are required:
dnf install preseem-platform-1000
dnf install preseem-platform-generic
- A system reboot is required for the platform optimizations to take effect