Connect Agent Overview

Connect Agent is a software-based, on-premises version of the flow server designed for deployment behind your firewall. It enables integration flows to run in environments that are not easily accessible from external networks. The Agent is lightweight and purpose-built to run integration flows while securely sending monitoring data to the main Connect cluster.

Connect Agent does not include a local console. It connects securely to the centralized GridOS Connect cluster, forwarding deployment data, logs, and metrics. The GridOS Connect Console provides a unified interface for managing and monitoring flows deployed both in the GridOS Connect cluster and across all Connect Agent deployments.

When to use Connect Agent

Use Connect Agent when:

  • The deployment environment and target systems cannot be exposed externally.

  • A pull-based integration model is sufficient.

  • High availability and advanced reliability are not required.

Connect Agent is suitable for environments where security policies prevent inbound connections. The Agent can move data to an environment where other systems can access it. Integration flows deployed to the Agent can be monitored centrally through the Connect Console, providing visibility into integrations without requiring direct access to the environment.

Limitations

Connect Agent is a lightweight version of the Connect integration service with the following limitations:

  • The Connect flow server runs as a single-node deployment backed by a single-node PostgreSQL instance. High availability and redundancy are not supported.

  • Inbound HTTP endpoints support only Basic and API key authentication schemes.

  • No console or user interface is provided. All logs, metrics, and deployment data are sent to the parent Connect cluster.

  • The Connect Agent does not come with the zero-trust configuration and API gateway that a regular Connect cluster provides. It is not advisable to expose the Connect Agent directly on the internet.