Skip to main content

Analytics

Flow provides analytics endpoints to monitor gate performance, validation patterns, and infrastructure health.

Overview​

Get a high-level summary of your workspace's Flow usage:

curl "https://api.rynko.dev/api/flow/analytics/overview?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "activeGates": 5,
  "totalRuns": 1247,
  "runsToday": 43,
  "pendingApprovals": 2,
  "creditBalance": 3500,
  "runLimit": 15000,
  "gateLimit": 50
}

A runLimit or gateLimit of -1 means unlimited (Scale plan).

Query Parameters​

Most analytics endpoints accept these common parameters:

ParameterTypeDefaultDescription
periodstring30dTime window: 7d, 30d, or 90d
gateIdstring—Filter to a specific gate
granularitystringdayTime bucket: day, week, or month (throughput/timeline only)

Endpoints​

Run Outcomes​

Distribution of run outcomes with percentages:

curl "https://api.rynko.dev/api/flow/analytics/run-outcomes?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
[
  { "status": "completed", "count": 980, "percentage": 78.59 },
  { "status": "validation_failed", "count": 200, "percentage": 16.04 },
  { "status": "rejected", "count": 42, "percentage": 3.37 },
  { "status": "render_failed", "count": 25, "percentage": 2.00 }
]

Throughput​

Time-series data for run volume:

curl "https://api.rynko.dev/api/flow/analytics/throughput?period=30d&granularity=day" \
  -H "Authorization: Bearer YOUR_API_KEY"
[
  { "date": "2026-03-01", "completed": 45, "failed": 3, "rejected": 1, "total": 49 },
  { "date": "2026-03-02", "completed": 52, "failed": 5, "rejected": 0, "total": 57 }
]

Validation Errors​

Failure rates and most common error fields per gate:

curl "https://api.rynko.dev/api/flow/analytics/validation-errors?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
[
  {
    "gateId": "550e8400-...",
    "gateName": "Order Validation",
    "failureRate": 12.50,
    "topFields": ["email", "amount", "status"]
  }
]

Approval Metrics​

Approval rates, decision times, and timeline:

curl "https://api.rynko.dev/api/flow/analytics/approval-metrics?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "approvedRate": 85.00,
  "rejectedRate": 15.00,
  "medianTimeToDecisionMs": 1800000,
  "p95TimeToDecisionMs": 7200000,
  "timeline": [
    { "date": "2026-03-01", "approved": 8, "rejected": 1 },
    { "date": "2026-03-02", "approved": 12, "rejected": 3 }
  ]
}

Infrastructure Health​

Circuit breaker status and delivery success rates:

curl "https://api.rynko.dev/api/flow/analytics/infra-health?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "circuitBreakerTrips": [
    { "gateId": "...", "tripCount": 2, "lastTrip": "2026-03-02T14:30:00Z" }
  ],
  "deliverySuccessRate": 98.50,
  "deliveryTrend": [
    { "status": "delivered", "count": 950 },
    { "status": "failed", "count": 15 }
  ]
}

Gate Metrics​

Per-gate run counts and success rates:

curl "https://api.rynko.dev/api/flow/analytics/gate-metrics?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
[
  {
    "gateId": "...",
    "gateName": "Order Validation",
    "totalRuns": 500,
    "completedRuns": 450,
    "failedRuns": 50,
    "successRate": 90.00
  }
]

Billing Summary​

Current period usage and limits:

curl "https://api.rynko.dev/api/flow/analytics/billing-summary" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "currentPeriodUsage": 1247,
  "periodLimit": 15000,
  "savingsPercent": 20,
  "savingsAmount": 0,
  "artefactRetentionDays": 5,
  "tier": "growth"
}

Dashboard​

The Flow analytics dashboard in the Rynko webapp visualizes these metrics with interactive charts, including:

  • Run outcome distribution pie chart
  • Throughput line chart with day/week/month granularity
  • Validation error heatmap by gate
  • Approval timeline
  • Infrastructure health indicators
  • Per-gate performance table