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
- Select the agent
- Click Restart
- Confirm the action
The agent will gracefully restart and reconnect.
Telegraf Configuration
FacilFlow generates Telegraf configuration files for each agent automatically:
- Select an agent and open Configuration
- Choose the input plugins to enable (e.g., OPC-UA, Modbus, MQTT)
- FacilFlow generates a valid
telegraf.confwith the correct output plugin pointing to the mapped cluster - 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:
- Open the agent detail page
- Under Cluster Mapping, select the target cluster
- All data collected by this agent routes to the selected cluster
- 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:
- Edit the configuration in the UI
- Click Push Config
- The agent receives the new config and restarts its collectors
- Status updates in real-time to confirm the change took effect