blueplane

What problem does it solve?

Provides concise, actionable operational guidance to manage the Blueplane telemetry processing server so developers can start, stop, restart, monitor, and troubleshoot the service without guesswork or manual log hunting.

Core Features & Use Cases

• Server lifecycle management: Clear commands and options for starting in foreground or daemon mode, stopping gracefully or forcefully, and restarting after code or config changes.
• Monitoring & diagnostics: Log locations, common grep/tail commands, status checks, Redis stream and consumer group inspection, and SQLite queries for validating data ingestion.
• Development and production workflows: Steps to restart after pulls, run tests, verify health, and recover from stale PID or hung processes.
• Use Case: After deploying a code change to the processing logic, restart the server in daemon mode, verify Redis stream lengths and consumer groups, and inspect the last 100 log lines for errors to confirm normal operation.

Quick Start

Restart the Blueplane server as a background daemon, then display the last 50 lines of the server log and check the server status for verbose health details.