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 bar chart with day/week/month granularity
  • Validation error table by gate
  • Approval timeline with decision trends
  • Infrastructure health indicators
  • Per-gate performance table

Workspace vs Project Analytics​

Analytics are organized into two levels:

  • Environment Analytics (/flow/analytics/workspace): Operational metrics for the current environment — run outcomes, throughput, gate health, approval timing, validation errors, and infrastructure health. Organized into Health and Insights tabs.
  • Project Analytics (/flow/analytics/team): Team-level metrics for admins and owners — workspace attribution, cross-workspace health, and billing summary.

Gate Filter​

All workspace analytics support filtering by a specific gate using the gate dropdown. This lets you isolate metrics to a single gate without leaving the analytics dashboard.

Gate Detail Performance Tab​

Each gate's detail page (/flow/gates/:id) includes a Performance tab alongside the Configuration tab. This provides gate-scoped analytics without navigating to the main analytics dashboard.

The Performance tab displays:

Summary Stats​

Four metric cards showing:

  • Total Runs: Number of runs submitted to this gate in the selected period
  • Success Rate: Percentage of runs that completed successfully (color-coded: green ≥95%, amber ≥80%, red below 80%)
  • Failed Runs: Count of runs that failed validation, rendering, or delivery
  • Median Approval: Median time for approval decisions (displayed as seconds, minutes, hours, or days)

Run Outcomes​

Donut chart breaking down run statuses:

  • Completed (green)
  • Validation Failed (red)
  • Render Failed (orange)
  • Delivery Failed (amber)
  • Rejected (gray)

Each status shows its count and percentage of total runs.

Approval Timing​

Detailed approval workflow metrics:

  • Median and P95 decision times — how quickly reviewers respond
  • Total decisions count with approved/rejected breakdown
  • Decision timeline — stacked area chart showing approval and rejection trends over time
  • Warning banner when P95 exceeds 24 hours, indicating the approval step may be a bottleneck
Monitoring Approval Bottlenecks

If your P95 approval time exceeds 24 hours, consider:

  • Adding more approvers to distribute the review load
  • Setting shorter approval timeouts with auto-reject
  • Using the digest notification mode to reduce notification fatigue

Run Throughput​

Stacked bar chart showing daily run volume broken down by completed, failed, and rejected runs. Use this to spot trends and anomalies in submission patterns.

Validation Errors​

Lists the top 5 most common validation error fields for this gate, showing:

  • Field name
  • Error message
  • Failure count

This section only appears when there are validation errors in the selected period.

Period Selection​

All gate analytics support filtering by time period:

  • Last 7 days — recent activity
  • Last 30 days — monthly view (default)
  • Last 90 days — quarterly trends