Skip to main content

General

Troubleshooting Overview

Start here when something in Proxus is not working as expected.

This section helps you narrow a problem to the right layer: gateway, protocol, data flow, rules, or dashboards.

router

Gateway Issues

Start here when a gateway is disconnected or keeps reconnecting.

settings_ethernet

Protocol & Addresses

Use this when values look wrong or addresses do not match.

swap_vert

Data Flow Problems

Use this when data is missing, delayed, or buffered.

toggle_on

Rules & Automation

Use this when rules do not trigger or actions fail.

dashboard

Dashboard Issues

Use this when widgets are empty, slow, or stale.

General Diagnostics

Before diving into a specific issue, check these common diagnostics. The Hub & Spoke architecture and data quality metrics help you quickly narrow the cause:

System Logs

Navigate to Administration > System Logs to view real-time platform logs. Use filters to narrow down:

  • Level: Error or Warning for problems
  • Category: Filter by component (e.g., Proxus.ProtocolDrivers)

Gateway Status

Check Data Management > Gateways to verify all gateways show a green Connected status.

Service Health

Open Grafana at http://localhost:3000 and check the Proxus Health dashboard for:

  • CPU and memory usage
  • Message throughput
  • Error rates
lightbulb
Need More Help?

If you cannot find a solution here, contact support.

rocket_launch

Quick Start Guide

First-time setup and basic configuration.

memory

System Requirements

Hardware and software prerequisites.

settings

Configuration Reference

Proxus-config.toml settings explained.

description

System Logs

How to use the logging system effectively.

← Previous
AI Agent Integration (MCP Server)
Next →
Gateway Issues