Skip to content
  • There are no suggestions because the search field is empty.

Step 4: Set up your connection

Data connections let you automate the collection of instrument measurements by linking Proqio to external data sources.

At Proqio there are multiple ways to connect data:

  • FTP/SFTP: File Transfer Protocol (FTP) or Secure File Transfer Protocol (SFTP) are used to transfer files between a server and Proqio.
  • MQTT: Message Queuing Telemetry Transport (MQTT) is a lightweight messaging protocol for machine-to-machine (M2M) communication.
  • PUSH API: A Push API actively sends data from the third party software to Proqio.
  • PULL API: on a Pull API we request data from a server, with the server responding to each specific request. 
  • Or additionally, upload CSV manually.

All connections are managed in the Monitoring > Connectivity section.

Create a New Connection

To create a new connection:

  1. Navigate to Monitoring and open the Connectivity tab.

  2. Click the "Create Connection" button in the top-right corner.

    Create connection

  3. Select the type of connection you want to create within the modal options.

    Create connection-modal

 


Choose a Connection Type

Proqio supports four types of connections. Each one has its own setup requirements:

1. FTP/SFTP Server

Used to receive and process data files via a Proqio-hosted FTP/SFTP server.

Setup:

  • Name

  • Username and password

  • Folder name

  • Description (Optional)

  • Click Create

Fttp server-modal1

After creating the server, a folder is needed to send the data to.

Fttp server-modal2

✅ Your new FTP/SFTP connection will appear in the table, ready to receive data. You can visualize the FTP credentials by clicking on the "information" button.

You will be able to

2. MQTT Server

Used for real-time messaging via a Proqio-hosted MQTT server.

Setup:

  • Name

  • Username and password

  • Folder name

  • Description (Optional) 

  • Click Create

Mqtt server-modal1

After create the server, at least, a folder is needed to send the data.

Mqtt server-modal2

✅  The connection will now be listed and active.

3. Push API

Use this HTTPS API to push instrument data directly to Proqio.

Setup:

  • Name

  • Username and password

  • Folder name

  • Description (Optional) 

  • Click Create

Push API-modal1

For PUSH API only a folder is needed.

Push API-modal2

✅ The connection will now appear in your table of active connections.

4. Pull API

Proqio will actively pull data from your systems via an API.

Setup:

  • Name

  • Description (Optional) 

  • Link a parser (Optional) 

  • Enable/disable the connection

PULL API-modal1

Configuration Required:

  • Endpoint URL

  • Request interval

  • Request method: GET or POST

  • Authentication type. Depending on the chose, the form inputs can vary:

    • Basic Auth: Username & password

    • Bearer Token: Token

    • API Key: Key & value

    • OIDC:

      • Content type

      • Auth URL

      • Token expiration (minutes)

      • Username & password

      • Grant type

      • Client ID

    • None: No credentials needed

  • Request body (Optional) 

  • Click Create to finish.

✅ Your Pull API connection will now be listed and ready to fetch data.

Once your connection is created, it's ready to start receiving data from your instruments. If you need to manage folders or configure parsing, refer to our dedicated articles on Folder Setup and Parsers.


Update instrument data manually

There is the possibility to manually import and update instrument data.

1. To do this, you must first download the template from Monitoring, in the Instruments section. 

💡 Pro tip
Another option is to export the category of interest and subsequently delete the columns that are not required from the CSV. This way, you would not have to enter the instrument list again.

2. Once you have the CSV with the updated data, you can import it from the same Instruments section in Monitoring. After a few minutes, the data should be updated.