Concepts

Tasks

Settings

Creating 4D Analytics Connections

A connection specifies the information needed to access the server and Influx database, as well as authentication information. You will typically create a connection for each site that uses 4D indicators.

To Create a 4D Analytics Connection

1.	Open the Enterprise window, select the Integrations view, the 4D Analytics tab, and the Connections tab.

2.	Click New. The 4D Analytics Connection Properties dialog appears:

3.	Fill in the identification properties:

Setting Name

Description

Connection name

Descriptive identifier for the connection.

Server URL

Address of the server that hosts 4D Analytics. The URL must include “engineeringChart.jsp”. https://ServerName/engineeringChart.jsp

Request URL

Address of the 4D web service that writes data (readings). The URL must include “WriteHighVolData.jsp” https://ServerName/WriteHighVolData.jsp

Alarm override request URL

Address of the 4D web service that indicates when APM wants alarm notifications. The URL must reference “WriteHighVolAlarmOverride.jsp”. https://ServerName/WriteHighVolAlarmOverride.jsp

Cached states URL

Address of the web service that sends indicator state alarm information to 4D Analytics. The URL must include “WriteHighVolAlarmLevels.jsp”. https://ServerName/WriteHighVolAlarmLevels.jsp

4.	Cached states last updated shows the date and time when indicator states were last sent from the APM database to the cache. The states cache supplies the 4D Analytics alarm engine with current information for evaluating newly ingested readings.

When you have finished setting up 4D Analytics, clear any values in the “last updated” boxes and click Update Cached States to initially populate the cache. Whenever indicator states change in the future, the cache is updated automatically and the “last updated” date is refreshed.

5.	Fill in the Influx database settings:

Setting Name

Description

Database URL

Address of the InfluxDB server.

Database name

Identifier of the Influx database.

User name

Name used to log in to the Influx database.

Password

Password used to login in to the Influx database.

Measurement name

The “table name” for indicator readings stored in the Influx database.

6.	Fill in the authentication token values for the 4D web service APIs:

Setting Name

Description

Resource ID

OIDC ResourceID that was created for 4D Analytics.

Token resource secret

Secret for the OIDC Resource ID.

Scope

Scope that was created for 4D Analytics.

7.	Select the Description tab to provide more information.

8.	Click OK to save the connection and close the dialog.

Tip: Once a connection has been in use, you can open its properties dialog to view usage and historical information.

Note: You can mark a connection as inactive to prevent it from being used, for example, during development. Select the connection in the table and click Mark as Inactive.When the connection is ready, select it in the table and click Mark as Active.