← Back to Documentation

Dashboard Pages Guide

Complete guide to all pages and features in the RunWatch dashboard

Dashboard Overview

The main dashboard page provides a high-level view of your organization's pipeline performance with summary statistics and interactive analytics charts.

Summary Cards:

  • Total Runs: Number of pipeline runs within your plan's retention period
  • Success Rate: Percentage of successful runs within your retention period
  • Successful Runs: Count of successful runs within your retention period
  • Failed Runs: Count of failed runs within your retention period

Analytics:

The dashboard includes interactive charts for success rate trends, pipeline status over time, duration analysis, compute time analysis, and pipeline comparisons. See the Charts documentation for detailed explanations.

Insights Page

The Insights page highlights reliability hotspots by identifying which branches, users, and pipeline steps contribute the most risk and wasted compute.

How ranking works:

  • Risk Score: Hotspots are sorted by risk score with the riskiest entities shown first
  • Failure + Instability: Combines failure rate with non-success run rate to detect unstable behavior
  • Waste Impact: Includes wasted compute/job time from failed, cancelled, and timed-out executions

Tables included:

  • Problem Branches: Branches with the highest reliability risk
  • Problem Users: Actors/trigger sources correlated with unstable runs
  • Problem Pipeline Steps: Job steps with elevated failure or waste

Loading state: While data is being analyzed, the page may show an "Inspecting pipeline data" spinner so you know analysis is in progress.

Pipelines Page

The Pipelines page provides a detailed view of all your pipelines with performance metrics and the ability to drill down into individual pipeline runs.

Features:

  • Pipeline List: View all pipelines across all repositories in your organization, paginated 10 per page
  • Performance Metrics: See total runs, success rate, successful/failed counts, average duration, and average compute time for each pipeline
  • Pipeline Details: Click on a pipeline to view all runs, filter by status, and see job-level details

Tip: Use the pipeline list to identify underperforming pipelines (low success rates, high durations, or high compute time) that need optimization. Compute time is especially important for tracking CI/CD costs.

Individual Pipeline Page

Clicking on a pipeline from the Pipelines page takes you to a detailed view of that specific pipeline with all its runs.

Features:

  • Statistics Cards: Overview metrics including total runs, success rate, successful/failed/cancelled/timed out counts, duration totals/averages, compute time totals/averages, and wasted time (total and rate for non-success runs)
  • Run List: Sortable, paginated list of all runs (25 per page) with columns for run ID, branch, status, triggered by, duration, compute time, and start time
  • Sorting: Sort runs by run ID, status, trigger, duration, compute time, or start time in ascending or descending order
  • Run Details: Click on a run to see job-level breakdown, status, duration, and links to CI/CD platform

Individual Run Page

Clicking on a specific run shows detailed information about that pipeline execution, including all jobs and their individual metrics.

Information Shown:

  • Run Header: Pipeline name, run ID, and a rerun badge when the run is a retry (attempt > 1)
  • Status: Current status of the pipeline run
  • Duration: Total execution time of the run
  • Timestamps: When the run started and completed
  • Actor: The user or system that triggered the run
  • External Link: Direct link to view the run in your CI/CD platform
  • Jobs Table: Sortable, paginated list of all jobs (25 per page) with name, status, duration, start/completion time, and link to job logs

Alerts Configuration

The Alerts page allows you to configure automated notifications when pipelines fail or exceed performance thresholds. Alerts are a paid feature available on Starter plans and above.

Alert Metrics:

  • Pipeline Status: Get notified on specific statuses (success, failure, cancelled, skipped, timed_out, running, queued, pending)
  • Duration Threshold: Alert when pipeline duration exceeds a specified time in seconds
  • Success Rate: Alert when success rate drops below a threshold over a configurable time window

Alert Destinations:

  • Email: Send alerts to email addresses
  • Webhook: POST, GET, or PUT alerts to custom webhook URLs
  • Slack: Send alerts to Slack channels via webhook
  • Discord: Send alerts to Discord channels via webhook

Advanced Features:

  • Scope: Set alerts at the organization, repository, or pipeline level
  • Branch Filtering: Use regex patterns to match specific branches
  • Cooldown: Set a cooldown period (in minutes) to prevent duplicate alerts

Note: Only organization owners and admins can configure alerts. Alert limits are based on your billing plan.

Access Keys

Access Keys are API keys used to authenticate your CI/CD pipelines with RunWatch's ingestion API. Each organization can have multiple access keys for different purposes (e.g., different repositories, environments, or teams).

Key Management:

  • Create Keys: Generate new API keys with a required name and optional expiration date
  • View Keys: See all active keys (keys are masked for security after initial creation)
  • Copy Key: Copy the full key to clipboard immediately after creation (only shown once)
  • Delete Keys: Remove keys that are no longer needed or compromised

Security Best Practice: Use separate keys for different repositories, environments, or teams. Rotate keys regularly and delete unused keys.

Note: Only organization owners and admins can manage access keys.

Organization Settings

The Organization page is the central hub for managing your organization's settings, members, and billing.

Organization Settings:

  • Organization Name: Display name for your organization (editable by owners and admins)
  • Billing Plan: View and manage your subscription plan
  • Usage Limits: See your plan's limits for repositories, runs, and alerts

Billing Management:

  • Current Plan: View your active subscription and plan details
  • Upgrade/Downgrade: Change your plan to match your needs
  • Billing Portal: Access Stripe's customer portal for invoices and payment methods
  • Usage Tracking: Monitor your usage against plan limits

Team Management:

  • Members: View all organization members with sortable columns (email, role, joined, last login), paginated 25 per page
  • Invite Members: Send email invitations with a 7-day expiry link and assign a role (member or admin)
  • Pending Invites: View pending invitations with the ability to copy invite links or revoke them
  • Role Management: Assign roles (owner, admin, member) to control access
  • Remove Members: Revoke access for members who no longer need it

Roles: Owners can manage everything including billing. Admins can manage settings and members but not billing. Members have read-only access.

Profile

The Profile page lets you manage your personal account settings. Access it from the user menu in the top-right corner.

Account Information:

  • Display Name: Update your name shown across the dashboard
  • Phone: Add or update your phone number
  • Email: Update your email address (not available for OAuth accounts)
  • Password: Change your password (not available for OAuth accounts)

OAuth-Managed Accounts:

If you signed up with GitHub, Google, or Microsoft, your email and password are managed by that provider and cannot be changed from the profile page.

Account Deletion: You can permanently delete your account from this page. Organization owners should note that deleting your account will also delete the organization and all associated data.

Feedback

The Feedback page allows you to submit feature requests, report bugs, ask questions, or share general feedback about RunWatch. Your feedback helps us improve the platform.

Feedback Types:

  • General Feedback: Share thoughts, suggestions, or other feedback
  • Question: Ask questions about features or usage
  • Feature Request: Suggest new features or improvements
  • Bug Report: Report issues or unexpected behavior

Navigation

The dashboard navigation provides quick access to all major sections:

Main Navigation:

  • Dashboard: Main analytics and overview page
  • Pipelines: Detailed pipeline performance and run history
  • Insights: Ranked hotspots for problem branches, users, and steps
  • Alerts: Configure automated notifications (paid feature)
  • Organization: Manage settings, billing, and team members

User Menu:

Click your name in the top-right corner to access:

  • Profile: Manage your account settings
  • Access Keys: Create and manage API keys for CI/CD integration
  • Documentation: Access user guides and API documentation
  • Feedback: Submit feedback and feature requests
  • Sign Out: Log out of your account