SL1 PowerFlow System Utils SyncPack Release Notes, version 1.1.5

The "SL1 PowerFlow System Utils" SyncPack is a Standard SyncPack that contains applications, configuration objects, and steps used for a variety of PowerFlow utilities.

Version 1.1.5 of the "SL1 PowerFlow System Utils" SyncPack includes new applications and configuration objects to support new features in the PowerFlow Platform version 2.6.0. This version of the SyncPack is included with the PowerFlow Platform version 2.6.0 release.

Features

This SyncPack includes the following new PowerFlow application:

Collect PowerFlow OTEL Metrics. Collects basic PowerFlow OpenTelemetry content metrics, including:
- The number of applications, steps, configuration objects, and Synchronization PowerPacks on the system.
- The number of applications run during the past day.
- Data about all of the content in the current PowerFlow system, including names and versions of all steps, configuration objects, and Synchronization PowerPacks.
- Platform services versions.
You can use this application to send the collected metrics and PowerFlow content to a metrics server in JSON format. You can also use this application to send those metrics to a OTEL collector using a OTEL GRPC endpoint, which is configurable as an application variable. These features are disabled by default.

The following PowerFlow application was updated in this release:

Added the Connection_widget field to the "PowerFlow Check Connections" application in the "System Utils" SyncPack, which is included with this release of PowerFlow. You can use the new "steps" key in the Connection_widget field to filter the data that displays on the Workflow Health and Interconnectivity widget on the PowerFlow Control Tower page:
- When this field is present, the application filters for runs that used the "test" configuration object.
- When this field is blank, the application filters for apps that did not have a configuration object aligned.
- When the field is left out, the application does not filter, and it fetches and processes all runs regardless of the configuration objects (which is how the application worked by default in previous versions).
For example, in the Connection_widget field, you can add the following JSON code to display the latest application run with the "test" configuration object, and the application will only show successful or failed runs with that configuration object:
```
        {
          "name": "Integration Template",
          "steps": [
            {
              "app_name": "integration_template",
              "step_name": "Get REST Test",
              "configuration": "test",
              "syncpack": "base_steps_syncpack"
            }
          ]
        }
```

The following configuration object was updated in this release:

In the "IS - System Backup Configuration Example" configuration object, the default value of the backup_destination field was set to /usr/tmp.

This SyncPack also includes the following new step:

CollectPFOtelMetrics

To view the latest manuals for the SL1 PowerFlow Platform, see the SL1 PowerFlow page. To view the latest release notes for PowerFlow, see SL1 PowerFlow Release Notes.

Known Issues

This version of the SyncPack has the following known issues:

When a step path is not configured correctly because a step, application, or SyncPack does not exist in the PowerFlow system, the "PowerFlow Check Connections" application will ignore that path and keep checking all the step paths that were configured. For more information about configuring the "PowerFlow Check Connections" application, see "Configuring the Workflow Health and Interconnectivity Widget" in the PowerFlow Platform manual. (Case: 00322691. Jira ID: INT-5394)
After restoring a backup that contains installed SyncPacks , the SyncPacks page in the PowerFlow user interface will show that the versions of the restored SyncPacks were installed successfully, but their virtual environments might not be in place. This issue will be addressed in a future release of this SyncPack and the PowerFlow Platform.

To address this issue, perform one of the following actions to make sure that the environments for the SyncPacks are recreated successfully:

Force the syncpacks_steprunner service to restart, using the following command:

docker service update --force syncpacks_steprunner
Execute the following powerflowcontrol (pfctl) cluster or node action:

reinstall_syncpack_venv
Reinstall the SyncPacks in place using the PowerFlow user interface.

Prerequisites for the SyncPack

Version 1.1.5 of this SyncPack requires:

PowerFlow Platform version 2.6.0 or later.
"Base Steps" SyncPack version 1.5.0 or later.

ScienceLogic highly recommends that you disable all firewall session-limiting policies. Firewalls will drop HTTPS requests, which results in data loss.

Installing the SyncPack

A SyncPack file has the .whl file extension type. You can download the SyncPack file from the ScienceLogic Support site.

To locate and download the SyncPack:

Go to the ScienceLogic Support site at https://support.sciencelogic.com/s/.
Click the Product Downloads tab and select PowerPacks & SyncPacks.
In the Search field, type the name of this SyncPack and select it from the search results. The Release Version page appears.
On the Files tab, click the down arrow next to the SyncPack version that you want to install, and select Show File Details. The Release File Details page appears.
Click the Download File button to download the SyncPack.

After you download a SyncPack, you can import it to the PowerFlow platform using the PowerFlow user interface.

To import a SyncPack in the PowerFlow user interface:

On the SyncPacks page, click Import SyncPack. The Import SyncPack page appears.
Click Browse and select the .whl file for the SyncPack you want to install. You can also drag and drop a .whl file to the Import SyncPack page.
Click Import. PowerFlow registers and uploads the SyncPack. The SyncPack is added to the SyncPacks page.

You cannot edit the content package in a SyncPack published by ScienceLogic. You must make a copy of a ScienceLogic SyncPack and save your changes to the new SyncPack to prevent overwriting any information in the original SyncPack when upgrading.

To activate and install a SyncPack in the PowerFlow user interface:

On the SyncPacks page, click the Actions button () for the SyncPack you want to install and select Activate & Install. The Activate & Install SyncPack modal appears.

If you try to activate and install a SyncPack that is already activated and installed, you can choose to "force" installation across all the nodes in the PowerFlow system.

If you do not see the PowerPack that you want to install, click the Filter icon () on the SyncPacks page and select Toggle Inactive SyncPacks to see a list of the imported PowerPacks.

Click Yes to confirm the activation and installation. When the SyncPack is activated, the SyncPacks page displays a green check mark icon for that SyncPack. If the activation or installation failed, then a red exclamation mark icon appears.
For more information about the activation and installation process, click the check mark icon or the exclamation mark icon in the Activated column for that SyncPack. For a successful installation, the "Activate & Install SyncPack" PowerFlow application appears, and you can view the Step Log for the steps. For a failed installation, the Error Logs window appears.
If you have other versions of the same SyncPack on your PowerFlow system, you can click the Actions button () for that SyncPack and select Change active version to activate a different version other than the version that is currently running.