Skip to main content

Settings

Settings page showing Agent Info, Connect to Iotistica, and Features sections

The Settings page controls agent-wide behaviour. Changes are applied immediately for most settings; a few require an agent restart and are noted below.

Agent Info

The top section shows read-only information about the running agent: its UUID, firmware/software version, and API endpoint. If you're in standalone mode, the API endpoint and MQTT broker fields will be empty — that's expected.

Features

Toggle individual features on and off:

FeatureWhat It Does
Metrics PublishingSend endpoint data to destinations via subscriptions. Turn this off to stop all data forwarding without deleting your subscriptions.
Anomaly DetectionRun the local anomaly detection engine.
Job EngineEnable scheduled jobs and automation tasks.
Cloud LoggingForward agent logs to a cloud endpoint (only relevant when cloud sync is configured).

Logging

SettingDescription
Log LevelControls verbosity: debug, info, warn, error. Use debug when troubleshooting, info for normal operation.
Log Max AgeHow long to keep log entries (in milliseconds). Older entries are pruned automatically.

Intervals & Timing

These control how often the agent performs background tasks.

SettingDefaultDescription
Report interval60 sHow often the agent sends a status report (relevant with cloud sync)
Metrics interval60 sHow often system metrics (CPU, memory) are sampled
Reconciliation interval30 sHow often the agent checks for configuration changes
Target state poll60 sHow often the agent polls for a new desired state (cloud sync)
Full discovery scan24 hHow often a full network discovery sweep runs automatically
Light discovery scan4 hHow often a lightweight discovery scan runs

Runtime & Memory

SettingDescription
Memory threshold (MB)If the agent's heap grows above this, it logs a warning
Check interval (ms)How often the memory check runs

Schema Drift Detection

This section appears once per protocol pipe (one block per protocol you have endpoints for — e.g. Modbus, OPC-UA, BACnet).

Schema drift monitoring watches for unexpected changes in the fields that devices report. If a device suddenly stops sending a field it always sent, or starts sending a new one, the agent logs a warning.

SettingDefaultDescription
EnabledOnToggle drift detection for this protocol
Warmup batches20How many data batches to observe before establishing a baseline
Missing field threshold10Consecutive batches a field must be absent before it's flagged
Alert cooldown (ms)30 minMinimum time between repeat alerts for the same field
Min field presence ratio0.5A field must appear in at least this fraction of warmup batches to enter the baseline

Tuning tips:

  • If you're seeing false drift alerts on BACnet or OPC-UA (where not every device responds in every poll cycle), increase the missing field threshold to 20–30.
  • If your devices take a while to warm up and report all their fields, increase warmup batches to 50.
  • Changes take effect after the agent restarts (the baseline models are built at startup).

Each protocol has its own Save button — changes to one protocol don't affect others.