The Tetra SDC Connector (SDCC) v2 is a standalone, containerized application that enables bi-directional communication between the Tetra Data Platform (TDP) and AGU Sm@rtLine Data Cockpit (SDC). SDC is a middleware that captures measurements from sensors and analyzers and exports them through REST API export interfaces. Users can configure the Connector to periodically poll export interfaces for sample and measurement results. The Connector also allows integrating systems to submit measurement order requests to SDC through the TDP Command Service.

Prerequisites

• AGU SDC version 3.0 or higher
• (Optional) Tetra Hub. The SDCC v2 can be deployed as a standalone service on the AWS Cloud or to a Tetra Hub (for on-premises networking requirements). If deployed to a Tetra Hub, internal networking/firewalls rules to allow communication between SDCC and the Hub must be configured. For more information, contact your customer success manager (CSM).

Design Overview

AGU SDC exports measurements and sample results through REST API export interfaces. The Tetra SDC Connector (SDCC) v2 periodically polls these interfaces for available results, and then uploads them to the TDP. Data ingestion capabilities were expanded from SDCC v1 to support the upload of both measurement and sample results. Measurement orders can also now be submitted to SDC programmatically through TDP Command Service.

Architecture

The following diagram shows an example SDCC v2 architecture:

Dataflow Example

The following diagram shows an example SDCC v2 dataflow:

Operational Guide

To set up an SDCC v2, do the following.

Configure the SDC Export Interface

To configure export interface(s) in AGU SDC where the Connector will poll to obtain measurements or sample results, do the following:

1. Sign in to AGU SDC. Then, open the Export Interfaces page by doing the following:
   • In the left navigation menu, choose Settings.
   • Choose Interfaces.
   • Select the Export Interfaces icon.

2. Select the New button. The Create export interface workflow appears.

3. Define the export interface by doing the following:
   • For Description, enter a name for the export interface (for example, Exports-to-TDP)
   • For Export type, select RestServer.
   • For Event type, choose whether the interface exports measurement results (Measurement) or sample results (SampleResult).
   • Choose Save. The Export Interface Exports-to- workflow appears.
4. Edit your export interface to match the following Common configurations:

• For Active, select the check box.

📘

NOTE

Active interfaces add data to the queue. Inactive interfaces do not add data to the queue. However, inactivating a queue doesn't delete results from the queue; it only prevents new results from being added.

• For All parameters, select the check box.

📘

NOTE

Selecting All parameters is required for proper file versioning in the TDP. If the All parameters check box isn't selected , then the exports will create partial files in the TDP, where each file contains a fraction of all results.

• (Optional) For Diagnostics, select the check box. This option isn't required, but is helpful for troubleshooting purposes.

5. Configure your export interface to export data from specific divisions in the Division assignment configurations.

6. Configure your export interface to export data from a specific instrument make and model in the Device type assignment configurations.

🚧

IMPORTANT

AGU SDC can't export data from a specific instrument ID. All instruments of a specific make and model export together.

Create a Tetra SDC Connector v2

To create a Tetra SDC Connector v2, do the following:

1. Sign in to the TDP. Then, in the left navigation menu, choose Data Sources and select Connectors. The Connectors page appears.
2. Follow the instructions in Create a Pluggable Connector. For CONNECTOR TYPE, make sure that you select common AGU SDC.

📘

NOTE

After the Connector is created, the initial MODE status is set to IDLE by default. To activate the Connector, you must configure its settings. For instructions, see the Configure the Connector section.

Configure the Connector

On the Connectors page, select the name of the connector that you created. Then, select the Configuration tab to configure the required settings.

Configuration Parameters

The following tables lists the configuration parameters that are required for the Tetra SDC Connector (SDCC) v2.

Review and Edit the Connector's Information

The Information tab on the Connector Details page displays information about the Connector, the files pending, successfully uploaded, or failed. It also provides functionality to edit a Connector’s information, metadata, and tags.

To edit the Connector's information, select the Edit button on the Connector Details page's Information tab.

For more information, see Review and Edit a Pluggable Connector's Information.

Connector Details

The following table provides the Connector details available on the Information tab on the Connector Details page.

Connector Information That You Can Edit

The following table provides the connector information that can be edited after a Connector is created.

Metrics

After a Connector instance is created and running, you can monitor the Connector’s health by selecting the Metrics tab on the Connector Details page. The Metrics tab displays the Connector's container metrics as well as aggregated states on total files scanned and uploaded as well as files that returned errors or are pending.

Integrate Data

Measurement and sample results that are exported to configured exported interface(s) will be uploaded to TDP. After data is uploaded to the TDP, you can enrich and harmonize the data by using any of the following available scripts, protocols, and intermediate data schemas (IDS):

• Task script: common/sdc-measurement-raw-to-ids:v2.0.0
• Protocol: common/sdc-measurement-raw-to-ids:v2.0.0
• IDS: common/agu-sdc:v2.0.0

Submit Measurement Order

Measurements can be created programmatically in AGU SDC through a TetraScience CreateMeasurementOrder command.

To create a TetraScience TetraScience.SDCConnector.CreateMeasurementOrder command, an API call must be made to the Create Commands API. The Connector passes the payload.measurementOrderRequestBody to the SDC REST API.

Required parameters

• SampleNumber
• SampleType
• DeviceNumber

The following command data can be posted to the Command API to make a measurement in the SDC Sandbox:

{
    "targetId": "7e71ceea-0503-4031-9b56-97c686245e25",
    "action": "TetraScience.SDCConnector.CreateMeasurementOrder",
    "expiresAt": "2025-12-30T23:58:43.749Z",
    "payload": {
        "ttl": 600,
        "measurementOrderRequestBody": {
            "SampleNumber": "Sample987",
            "ExternalId": "LIMS12345",
            "SampleType": "Advanced Instruments OsmoTECH PRO default",
            "DeviceNumber": "AIOsmotechPro123456"
        }
    }
}