Gateway Tiered Diagnostics

Three-tier gateway health check: runtime endpoints, inbound message flow, and duplicate-service detection

Three CLI checks verify a running gateway from the outside in — HTTP endpoints reachable, inbound messages actually flowing, and no competing gateway fighting for the same tokens.

Quick Start

1. Verify the gateway is reachable

   Probe the runtime endpoints of a running gateway:

   praisonai gateway test --check-runtime

2. Confirm messages are arriving

   Check inbound delivery within a time window using a config file:

   praisonai gateway test --check-inbound --since 10m -c ~/.praisonai/gateway.yaml

3. Detect a competing gateway

   Scan for a second gateway sharing your Slack/Telegram token:

   praisonai gateway test --check-duplicates

How It Works

Each tier answers a different “is my bot healthy?” question.

The inbound tier combines two independent signals: a scan of the gateway log and a Prometheus counter compared against a persisted baseline.

Configuration Options

The diagnostics are entirely CLI-driven — no new YAML keys.

praisonai gateway test flags:

praisonai gateway status flags:

praisonai gateway sessions subcommands:

Environment variable:

/health uses the existing health_config.stale_after (default 120.0s) and startup_grace (default 60.0s).

Common Patterns

Run runtime and duplicate checks together for a fast liveness sweep:

praisonai gateway test --check-runtime --check-duplicates -c gateway.yaml

Inspect stored conversations when a user reports a missing reply:

praisonai gateway sessions list --platform slack --active 3600
praisonai gateway sessions show <session-ref> --tail 20

Call the checks directly from Python for custom health tooling:

from praisonai_bot.gateway.preflight import (
    check_runtime,
    check_inbound,
    check_duplicates,
)

runtime = check_runtime("gateway.yaml")
inbound = check_inbound("gateway.yaml", since="10m")
dupes = check_duplicates("gateway.yaml")

print(runtime.to_dict())
print(inbound.to_dict())
print(dupes.to_dict())

Each function returns a dataclass with a .to_dict() for JSON output:

Related Emissions

The inbound tier reads a counter the gateway increments on every inbound message.

• Metric: messages_inbound_total{channel="..."} — incremented per channel, including the Slack @mention path. handle_mention now fires fire_message_received, so mentions count toward inbound and honour drop / rewritten content decisions.
• /health additions: top-level last_inbound_at; per-channel ok, reason (from the HealthReason enum), last_activity, and optional probe.ok.
• Two doctor checks (category BOTS, both requires_deep=True):

Run them with praisonai doctor --deep.

Best Practices

Related