Manage Analytic Templates

About Analytics Templates

In this section, you will learn about analytic templates and the analytic catalog. Analytics generate data to help you manage your assets. Application Analytics enables you to build analytic templates and upload analytics to the analytic catalog.

Analytics implement mathematical models to provide intelligence about your assets, helping you manage them more efficiently. For example, you can use analytics to trigger alerts, generate maintenance advisories, and produce performance statistics.

Application Analytics enables you to create an analytic template that you can use in multiple deployments for the specified runtime. By employing a template, you can reuse the same analytic to deploy to different assets using asset applicability, and create unique input-output (I/O) tag mapping per deployment. You can also vary the schedule per deployment. The framework expects unique name per deployment.

The analytic catalog groups the tasks necessary to successfully configure and deploy an analytic.

Add an Analytic Template

Add the analytic packaged implementation to the Application analytic catalog to be deployed to a specific analytic runtime for running the analytic.

Before You Begin

Be sure that the packaged implementation containing the code for your analytic and any supporting files, such as instructions for deployment, are available to upload.

Note: If you are using the Import from file option to ingest analytics, and if your analytics implementation contains more than 200 entries for inputs definitions, constants, and output definitions, make sure that you set the isReadyOnly key to true. This is necessary to avoid latency issues while loading multiple definitions on the UI.

About This Task

The system validates the Name and Analytic File fields before you can proceed. You will need to enter or select values based on the selected runtime type.

Depending on the type of analytic implementation the configuration options vary for adding the template to the catalog. The analytic runtime environments supported for your tenant vary based on the tenant configuration.

Procedure

In the module navigation menu, navigate to Analytics > Analytics Templates.
Select in the page heading.
Add the analytic template using one of the following methods:
- Select the Import from file box. To ingest the complete analytic template, you must have the valid analytics ingestion .zip file ready. Refer to the topic Understand Analytic Ingestion in the reference section.
1. Select the Import from file box.
2. Browse to the location of the analytic ingestion .zip file and select the file.
3. Select Open.
- Use the fields in the New Analytic page to configure the template.
1. In the New Analytic page, select a value in the Runtime Type box.
2. Select a value in the Data Frame Type box.
  The values in the box may vary, depending on the value that you selected in the Runtime Type box. This value determines the way the Application Analytics expects the input.json file format for the analytic algorithm. It also determines the format in which Application Analytics creates the corresponding output.json and PortToField.json files. For example, if you select the Shared Time Stamp option, then the input.json file must give the values for all shared timestamps within the timeseries data. Otherwise, if you select the Per Port Time Stamp option, then the input.json must provide per-port values for inputs and output.json will have per-port values created for outputs.
3. Enter or select values in the Template Details section of the page.
Select Submit.

Results

The template is saved to the catalog. After the analytic logic is successfully uploaded, the status changes to Completed.

What To Do Next

Configure and build the analytic template after adding it to the catalog.

Analytic Template Fields based on Runtime

List of analytic template configuration requirements for different runtimes.

Field Requirements Based On Runtime

Refer to the table below to see the required and optional data entry fields based on the selected analytic runtime for the analytic template. Availability of a specific runtime is dependent on the tenant configuration.

Field Name	Description	Predix	Spark	Predix Edge	SmartSignal	AIR	SOAR	Power Fabric
Data Frame Types	This value determines the way the Application Analytics expects the input.json file format for the analytic algorithm. It also determines the format in which Application Analytics creates the corresponding output.json and PortToField.json files.	Shared Time Stamp Per Port Time Stamp	N/A	N/A	N/A	N/A	N/A	N/A
Name	A unique name for the analytic template.	Required	Required	Required	Required	Required	Required	Required
Owner	The name of the analytic owner, typically the developer of the analytic logic.	Required	Required	Required	Required	Required	Required	Required
Analytic Type	The language used to develop the analytic.	Java Python Matlab	Java Python	Edge Analytic Editor	Smartsignal	Java Python	Java Python Edge Analytic Editor	CCAP (Version: 3.1)
Type Version	The version for the selected language. The type version is updated based on the analytic type selected.	Required	Required	Required	Required	As defined in the runtime configuration	As defined in the runtime configuration	As defined in the runtime configuration
Analytic File	Select to upload the packaged analytic code. Note: The uploaded file must be in .zip or .jar format.	Required	Required	Required	Required	Required	Required	Required
Analytic Version	Version of the uploaded analytic implementation.	Required	Required	Required	Required	Required	Required	Required
Analytic Version Update	The information specific to what is new or changed in this version of the uploaded analytic package.	Optional	Optional	Optional	Optional	Optional	Optional	Optional
Primary Category	The main category tag used for the analytic. This tag allows the analytic to be classified under the designated category for further discovery in the catalog. Enter a value that best matches the type of analytic you are creating. For example, if monitoring a turbine, you can select `Monitoring`.	Required	Required; Must be `Forecasting` for forecasting and What-If analytics.	Required	Required	As defined in the runtime configuration	As defined in the runtime configuration	As defined in the runtime configuration
Secondary Category	The secondary category tag used for the analytic. This tag allows the analytic to be classified under the designated category, allowing you to further refine where the analytic is applied.	Optional	Optional	Optional	As defined in the runtime configuration	As defined in the runtime configuration	As defined in the runtime configuration

Note: You can also define custom runtime, or Bring Your Own Runtime (BYOR), which is a configuration that you define. You must work with the Application Analytics team to define the contract for the runtime and enable it on your tenant. Customization must be done during tenancy setup. This is similar to enabling other default runtime configurations.

Table 1. Analytic Version Support Based On Runtime
Runtime	Multiple Version Support?	Instructions To Upload And Save A New Version
Predix	YES	To save a new version of the analytic (.zip or .jar) file, upload a new file, enter the new Analytic Version number, and then enter the Analytic Version Update description. The latest version of the analytic artifact will be used to run all future deployments. Existing deployments continue to use the currently assigned version unless you explicitly redeploy them to run with the new version.
Spark	NO	Uploading multiple versions of the analytic to an existing template entry in the catalog is not currently supported.
SmartSignal	YES	To save a new version of the analytic (.zip or .jar) file, upload a new file, enter the new Analytic Version number, and then enter the Analytic Version Update description. The latest version of the analytic artifact will be used to run all future deployments. Existing deployments continue to use the currently assigned version unless you explicitly redeploy them to run with the new version.
AIR, SOAR, and Power Datafabric	Varies	Depends on the runtime definition and configuration.

Supported Data Sources

Data Source	Predix	Spark	Edge	SmartSignal	AIR	SOAR	Power Fabric
Predix Essentials Time Series	Yes	Yes	Yes	Yes	Yes	No	Yes
Predix Essentials Asset Attributes	Yes	Yes	Yes	No	No	No	Yes
Constant	Yes	Yes	Yes	Yes	Yes	No	Yes
Blobstore	No	Yes	No	No	No	No	No
Any	No	No	No	No	Yes	Yes	No
Postgres	No	Yes	No	No	No	No	No
Predix Timeseries	No	No	No	No	No	No	Yes

Modify an Analytic Template

Use the modify functionality to modify existing Analytic Catalog entries.

About This Task

You cannot modify the runtime type for an existing analytic template in the catalog. You may be able to modify only some fields for the selected analytic depending on its runtime type. You can see values in disabled fields but cannot modify them.

Make sure you check all existing deployments that use the analytics template before you modify it. If your modified artifact has analytic implementation that is significantly different from the previously uploaded artifact in the catalog, consider creating a new analytic to add to the catalog instead of updating the existing one.

Procedure

In the module navigation menu, navigate to Analytics > Analytics Templates.
In the Search pane, locate and select an analytics to access it.
In the workspace, select to access the analytic template for modification.
In the Analytics Template page, you can modify values in some of the existing boxes.
When you have completed your modifications, select Submit.

Results

After selecting Submit, the page reflects your changes to the analytic.

Delete an Analytic Template

You can delete an analytic template in the analytic catalog.

About This Task

Before you delete an analytic template in the analytic catalog, make sure that it is not being used in orchestrations or deployments. Deleting an analytic deletes its deployments. This cannot be undone.

Procedure

In the module navigation menu, navigate to Analytics > Analytics Templates.
In the Search pane, locate and select an analytics to access it.
In the workspace of the Analytics Template page, select Delete.
In the Delete the Analytic window, select Delete.

Note: This cannot be undone.