Observability

Real-time insights into your API traffic. Nolxy stores logs in ClickHouse with tiered detail levels based on your plan, and supports webhook notifications and external integrations.

Dashboard Analytics

Nolxy tracks high-precision performance metrics for every request. Our target is <1ms gateway overhead for simple proxy routes after JIT warm-up.

Total Requests

Number of HTTP requests proxied, with trend comparison.

Bandwidth

Total data transferred (bytes in + bytes out).

Avg Latency

Broken down into gateway latency (Nolxy overhead) and integration latency (upstream response time).

Latency Distribution

Detailed histogram of response times (P50, P95, P99) calculated server-side for accuracy.

Success Rate

Percentage of 2xx/3xx responses vs 4xx/5xx errors.

Cache Hit Rate

Ratio of cache HITs vs MISSes for cached routes.

Log Storage

All request logs are stored in a high-performance columnar database optimized for analytical queries. Pre-aggregated views power the dashboard with fast load times.

Tiered Logging

Log detail level depends on your plan to optimize storage costs:

Core (Free/Starter)Method, path, status, latency, IP, user agent

Standard (Pro)+ Cache analytics, service/consumer names

Full (Business/Enterprise)+ GeoIP, device detection, bot score, threat score

Log retention is plan-based: Free (7 days), Starter (30 days), Pro (60 days), Business (90 days), Enterprise (365 days).

Request Log Fields

Every proxied request generates a structured log entry with the following fields:

timestamp

method

path

statusCode

latencyMs

gatewayLatencyMs

integrationLatencyMs

bytesIn / bytesOut

ip / ipv4

userAgent

apiKeyId

routeId

cacheHit

planName

Geo Map

Visualize where your traffic originates. Available on Business and Enterprise plans.

GeoIP

Country-level IP geolocation. Processed asynchronously (non-blocking).

Device Info

User agent parsing for device type, browser, OS, and bot detection.

Threat Score

0-100 score based on suspicious patterns (scanner UA, path traversal attempts, unusual headers).

Webhooks & Notifications

Configure webhooks to receive real-time notifications for critical events. Managed via Config → Integrations.

Supported events:

quota.warning 90% usage

quota.exceeded 100% usage

circuit.open Breaker triggered

circuit.closed Breaker recovered

api_key.created New key

api_key.revoked Key revoked

Webhook payloads are signed with HMAC-SHA256 (X-Nolxy-Signature header). Failed deliveries are retried up to 3 times with exponential backoff (5s, 10s, 20s). Delivery logs are available in the dashboard.

External Integrations

Stream your API access logs to external observability platforms. Available on Business and Enterprise plans.

Datadog

Stream logs to Datadog Logs Management (EU or US region). API key encrypted before storage.

Custom Webhook

Send logs as JSON POST requests to any HTTP endpoint. Optional signing secret for verification.

Plan Requirements

Basic analytics and core logging are available on all plans. Log Export and advanced integrations are available on Pro plans and above. Webhooks are available on Starter plans and above.