Skip to main content

General

Troubleshooting Overview

Common issues and solutions for Proxus platform.

This section covers common issues and their solutions to help you get the most out of Proxus.

router

Gateway Issues

Connection problems, status updates, and MQTT broker troubleshooting.

settings_ethernet

Protocol & Addresses

Address syntax, data types, and byte ordering problems.

swap_vert

Data Flow Problems

Missing data, delayed values, and store-forward issues.

toggle_on

Rules & Automation

Rules not triggering, expression errors, and action failures.

dashboard

Dashboard Issues

Widget binding, performance, and display problems.

General Diagnostics

Before diving into specific issues, check these common diagnostics. Understanding the Hub & Spoke architecture and data quality metrics helps in troubleshooting:

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 at [email protected] or visit our GitHub Issues.

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