v0.3.0

Edge Agents

Manage FacilEdge agents deployed at plant sites.

Overview

Edge agents run at plant sites to:

  • Collect data from local sources (PLCs, historians, databases)
  • Buffer data locally during network outages
  • Replicate data to the cloud with store-and-forward

Agent List

Navigate to Connect > Edge Agents to see all registered agents:

Column Description
Name Agent identifier
Location Plant site location
Status Online, offline, or error
Last Seen Time of last heartbeat
Version Agent software version
Cluster Mapped InfluxDB cluster

Agent Status

Status Description
Online Agent is connected and healthy
Offline Agent has not reported recently
Warning Agent has issues (check logs)

Agent Operations

View Details

Click an agent to see:

  • Configuration settings
  • Connected data sources
  • Recent activity logs
  • Performance metrics

Restart Agent

  1. Select the agent
  2. Click Restart
  3. Confirm the action

The agent will gracefully restart and reconnect.

Telegraf Configuration

FacilFlow generates Telegraf configuration files for each agent automatically:

  1. Select an agent and open Configuration
  2. Choose the input plugins to enable (e.g., OPC-UA, Modbus, MQTT)
  3. FacilFlow generates a valid telegraf.conf with the correct output plugin pointing to the mapped cluster
  4. Click Push Config to deploy the configuration to the agent remotely

The generated config includes:

  • Input plugin blocks for each selected data source
  • Output plugin configured for the agent’s mapped InfluxDB cluster
  • Processor plugins for any required transformations
  • Agent-level settings (interval, flush interval, buffer size)

Agent-to-Cluster Mapping

Each agent can be mapped to a specific InfluxDB cluster:

  1. Open the agent detail page
  2. Under Cluster Mapping, select the target cluster
  3. All data collected by this agent routes to the selected cluster
  4. Change the mapping at any time — the agent reconnects automatically

Adding Agents

New agents register automatically when deployed with the correct API key and endpoint configuration.

Configuration Push

When you modify an agent’s configuration in the UI, FacilFlow can push the updated config to the running agent:

  1. Edit the configuration in the UI
  2. Click Push Config
  3. The agent receives the new config and restarts its collectors
  4. Status updates in real-time to confirm the change took effect
esc