Page content
Installing, upgrading, and managing the Qlik™ Cloud Monitoring Apps for user-based subscriptions
Installing, upgrading, and managing the Qlik™ Cloud Monitoring Apps for user-based subscriptions has just gotten a whole lot easier! With two new Qlik™ Application Automation templates coupled with Qlik™ Data Alerts, you can now:
- Install/ update the apps with a fully guided, click-through installer using an out-of-the-box Qlik™ Application Automation
- Programmatically rotate the API key required for the data connection on a schedule using an out-of-the-box Qlik™ Application Automation This ensures the data connection is always operational.
- Get alerted whenever a new version of a monitoring app is available using Qlik™ Data Alerts. Repeat Step 1 to complete the update.
The above allows you to deploy the monitoring apps to your tenant with a hands-off approach. Dive into the individual components below.
Part 1: Qlik™ Cloud Monitoring Apps for user-based subscriptions' template overview
This automation template is a fully guided installer/ updater for the Qlik™ Cloud Monitoring Apps, including but not limited to the App Analyzer, Entitlement Analyzer, Reload Analyzer, and Access Evaluator applications. Leverage this automation template to quickly and easily install and update these or a subset of these applications with all their dependencies. The applications themselves are community-supported; and, they are provided through Qlik™‘s Open-Source Software GitHub and thus are subject to Qlik™‘s open-source guidelines and policies.
Features
- Can install/ upgrade all or select apps.
- Can create or leverage existing spaces.
- Programmatically handles pre-requisite settings, roles, and entitlements.
- Installs latest versions from Qlik™’s OSS GitHub.
- Creates required API key.
- Creates required analytics data connection.
- Can create custom reload schedules.
- Can reload post-install.
- Tags apps appropriately to track which are installed and their respective versions.
Click-through Installer
Flow
Note that if the monitoring applications have been installed manually (i.e., not through this automation) then they will not be detected as existing. The automation will install new copies side-by-side. Any subsequent executions of the automation will detect the newly installed monitoring applications and check their versions, etc. This is due to the fact that the applications are tagged with “QCMA – {appName}” and “QCMA – {version}” during the installation process through the automation. Manually installed applications will not have these tags and therefore will not be detected.
Part 2: 'Qlik™ Cloud Monitoring Apps API Key Rotator' template overview
This template is intended to be used alongside the Qlik™ Cloud Monitoring Apps for user-based subscriptions template. This automation provides the ability to keep the API key and associated data connection used for the Qlik™ Cloud Monitoring Apps up to date on a scheduled basis. Simply input the space Id where the monitoring_apps_REST data connection should reside, and the automation will recreate both the API key and data connection regularly. Ensure that the cadence of the automation’s schedule is less than the expiry of the API key.
Configuration
Enter in the Id of the space where the monitoring_apps_REST data connection should reside.
Ensure that this automation is run off-hours from your scheduled monitoring application reloads so it does not disrupt the reload process.
Part 3: How to setup a Qlik™ Alert to know when an app is out of date
Each Qlik™ Cloud Monitoring Apps has the following two variables:
- vLatestVersion: the latest version of the app released on Qlik™’s OSS GitHub.
- vIsLatestVersion: a Boolean of whether the app’s current version is equal to the latest version of the app released on Qlik™’s OSS GitHub (1 if true, 0 if false).
With these variables, we can create a new Qlik™ Data Alert on a per-app basis.
For each monitoring app that you want to be notified on if it falls out of date:
- Right-click on a chart in the app, select Alerts and then Create new alert.
- Clear out the defaults and provide the alert with a name such as <Monitoring App Name> is Out of Date.
- Select Add measure and select the fx icon to enter a custom expression. Enter the expression ’$(vLatestVersion)’. Ensure it is wrapped in single quotes, then provide the label for the expression Latest Version.
- Select Add measure and select the fx icon to enter a custom expression. Enter the expression $(vIsLatestVersion), then provide the label for the expression Is Latest Version.
- Confirm the Details & data tab resembles the following:
6. Navigate to the next tab, Conditions.
7. Set the Measure to Is Latest Version, the Operator to Equal to, and the Value to 0. This way, if the app is not the latest version (0), it will trigger the alert.
8. Confirm that the Conditions tab resembles the following:
9. Navigate to the Distribution tab and confirm that the alert is evaluated When data is refreshed.
Here is an example of an alert received for the App Analyzer, showing that at this point in time, the latest version of the application is 5.1.3 and that the app is out of date:
Qlik™ Cloud Monitoring Apps Workflow Demo (Video)
Index:
00:00 Introduction
01:47 Template 1: Qlik™ Cloud Monitoring Apps for user-based subscriptions (Install)
06:45 Template 1: Qlik™ Cloud Monitoring Apps for user-based subscriptions (Upgrade)
10:15 Template 2: Qlik™ Cloud Monitoring Apps API Key Rotator
12:20 How to setup a Qlik™ Alert to know when an app is out of date
FAQ
Yes. Run the installer, select which applications should be checked and select the space that they reside in. If any of the selected applications are not installed or are upgradeable, a prompt will appear to continue to install/ upgrade for the relevant applications.
The template scopes the applications install process to a “target” space, i.e., a shared space (if not published) or a managed space. It will scope the API key name to `QCMA – {spaceId}` of that target space. This allows the template to install/ update the monitoring applications across spaces and across users. If one user installs an application to “Space A” and then another user installs a different monitoring application to “Space A”, the template will see that a data connection and associated API key (in this case from another user) exists for that space already and it will install the application leveraging those pre-existing assets.
Yes. The template receives the list of applications dynamically from GitHub. If a new monitoring application is released, it will become available immediately through the template.
As per the article above, the automation templates are not responsible for notifications of whether the applications are out of date. This is achieved using Qlik™ Alerting on a per-application basis as described in Part 3.
The history is preserved in the prior versions of the application’s QVDs so the data is never deleted and can be loaded into the older version. Each upgrade will generate a new set of QVDs as the data models for the applications sometimes change due to bug fixes, updates, new features, etc. If you want to preserve the history when updating, the application can be upgraded with the “Publish side-by-side” method so that the older version of the application will remain as an archival application. However, note that the Qlik™ Alert (from Part 3) will need to be recreated and any community content that was created on the older application will not be transferred to the new application.
For information about Qlik™, please visit this site: qlik.com.
For specific and specialized solutions from QQinfo, please visit this page: QQsolutions.
In order to be in touch with the latest news in the field, unique solutions explained, but also with our personal perspectives regarding the world of management, data and analytics, we recommend the QQblog !