Gateway and connection statuses: what they mean and what to do

Statuses show under Integrations, on the Gateways tab: the gateway has its own row, and so does each connection. A connection shows the last thing the gateway said about it, so it is fixed at the site.

StatusWhat it meansWhat to do
Onlinethe gateway comes online regularlynothing
Offline, last seen …the gateway has been silent too longcheck that the service or container is running, that there is outbound access to 443 and that the proxy does not ask for a sign-in. If the service is running, data piles up on the gateway's disk and arrives later
Status unknownthe cloud cannot read the gateway's state right nowwait and reload the page; nothing to do at the site
Incompatible versionthe cloud no longer accepts this gateway version. The gateway knocks but sends no dataa Windows gateway with automatic updates updates itself once a new build is out. Otherwise install the current build at the site. Meanwhile data piles up on its disk
Update to … did not installthe new version did not come up, and the service went back to the previous onethe gateway keeps running on the previous version. The same version is not offered to it again; the next one will be

Gateway buffer

StatusWhat it meansWhat to do
Waiting to be sent to the cloud, batches: …data has piled up and is not yet accepted by the cloudnothing if the number falls. If it grows, check outbound access and the proxy
Evicted by the buffer, samples: …the buffer ran out of space and the oldest samples were evicted: there is a hole in the historyrestore the link. If outages run long, raise buffer_max_mb in the settings file
Not accepted, batches in quarantine: …the cloud refused these batches; the gateway set them aside and does not send them againwrite to us with the gateway name

Connection

StatusWhat it meansWhat to do
No gatewaythe connection has no gateway assignedchoose a gateway in the connection row
Waiting for connection statusa gateway is assigned but has not reported on the connection yetwait for the gateway to come online
Connectingthe gateway is trying to connect to the equipmentwait. If the status does not change, see the reason below
Connected, no values yetthe link to the equipment is up, no values have arrived yetcheck that tags are set and the source updates them
Reading, tags: …data is flowingnothing
Reading … of …some tags have no valuethe tags and the reason are named under the status: no such address, the device did not answer, not allowed to read and others. Fix the tag address or the rights on the source
Gateway offlinethe connection's gateway is silentsee Gateway link above
Gateway needs an update, Gateway can't read the protocolthis gateway version does not know the protocolupdate the gateway or choose another gateway for the connection
Gateway platform unsupportedthe protocol runs only in a gateway on Windows (OPC DA, Mitsubishi CNC)choose a gateway on Windows for the connection
Closed on a critical infrastructure site, Site closedthe cloud does not read this connection because of the critical infrastructure answersee critical infrastructure
Catalog incomplete: …the source browse hit a limitnarrow the connection to the part of the tree or the topics you need

The reason for Not reading

ReasonWhat to check
System unavailablethe equipment address and port, whether it is reachable from the gateway server, the firewall rules on the plant network
Login rejectedthe credentials in the connection card on the Services tab
Access refusedthe rights of that account on the source
Server certificate not trustedput the OPC UA server certificate into the gateway's trusted list, more in protocols
Protocol errorthat it is this protocol answering at the address, its version and connection mode
Invalid connection settingsthe connection fields. If the settings file has equipment_hosts, the connection address must be in the list
System busythe source answered that it is busy: wait, or lower the poll rate and the number of connections to it
Gateway limit exceededmore values arrive than the gateway can take in: narrow the tag set or widen the deadband

Frequently asked questions

The gateway is Offline. Is the data lost?

No, as long as the gateway service is running: data piles up on its disk and arrives once the link is back. Check that the service is running and that the server has outbound access to 443.

A connection says Not reading. Where do I start?

The reason stands under the status: System unavailable, Login rejected, Server certificate not trusted and others. Act on it; the table is below.

See also

Was this page helpful?

Didn't find an answer? How to reach us