Skip to main content

Troubleshooting Guide

This guide helps you resolve common issues with CICosts.

Connection Issues​

"No organizations found"​

Symptoms:

  • Dashboard shows "No organizations"
  • Org switcher is empty

Solutions:

  1. Check GitHub App installation

    • Go to GitHub → Settings → Applications → Installed GitHub Apps
    • Verify CICosts is installed
    • If not, reinstall from CICosts

  2. Check organization membership

    • Ensure you're a member of the organization
    • Admin access may be required to see org data

  3. Refresh the connection

    • Sign out of CICosts
    • Sign back in
    • Re-authorize if prompted

"GitHub App not installed"​

Symptoms:

  • Prompted to install GitHub App
  • Some repos not showing

Solutions:

  1. Install on missing organizations

    • Click "Add Organization" in CICosts
    • Select the organization
    • Complete installation

  2. Check repository access

    • GitHub → Settings → Applications → CICosts → Configure
    • Ensure correct repos are selected

Data Issues​

No workflow data appearing​

Symptoms:

  • Dashboard shows $0
  • No recent runs listed

Solutions:

  1. Wait for sync

    • Initial sync takes 5-10 minutes
    • Recent runs appear within 2 minutes

  2. Trigger a workflow

    • Push a commit to trigger CI
    • Check CICosts after it completes

  3. Check webhook delivery

    • GitHub → Settings → Apps → CICosts → Advanced
    • View "Recent Deliveries"
    • Look for errors

  4. Verify permissions

    • GitHub App needs "Actions: Read"
    • Reconfigure if needed

Costs showing as $0​

Symptoms:

  • Runs appear but cost is $0

Causes:

  1. Self-hosted runners

    • Self-hosted runners have no GitHub cost
    • This is expected behavior

  2. Runner detection issue

    • Contact support with run ID

  3. Data still processing

    • Wait 2-3 minutes
    • Refresh the page

Historical data missing​

Symptoms:

  • Only seeing recent runs
  • Old data not appearing

Causes:

  1. Free plan limitation

    • Free plan: 30 days of history
    • Upgrade for 1 year history

  2. Initial sync limitations

    • We fetch up to 30 days of history on install
    • Older data isn't available

Alert Issues​

Alerts not triggering​

Symptoms:

  • Threshold exceeded but no alert

Solutions:

  1. Check alert is enabled

    • Go to Alerts
    • Verify status is "Active"

  2. Check threshold

    • View alert configuration
    • Verify threshold value

  3. Check cooldown

    • Alert may be in cooldown
    • View "last triggered" time

  4. Verify notification settings

    • Email configured correctly?
    • Slack connected?

Too many alerts​

Symptoms:

  • Receiving constant alerts
  • Alert fatigue

Solutions:

  1. Increase threshold

    • Set higher limit
    • Use percentage-based instead of fixed

  2. Add cooldown

    • Set 4-24 hour cooldown
    • Prevents repeated triggers

  3. Refine scope

    • Narrow to specific repos/workflows
    • Exclude noisy sources

Not receiving email alerts​

Solutions:

  1. Check spam folder

  2. Verify email

    • Settings → Profile
    • Confirm email is verified

  3. Check preferences

    • Settings → Notifications
    • Ensure email is enabled

Slack notifications not working​

Solutions:

  1. Check connection

    • Settings → Integrations
    • Verify Slack shows "Connected"

  2. Check channel

    • Is CICosts added to the channel?
    • For private channels, invite @CICosts

  3. Reconnect Slack

    • Disconnect and reconnect
    • Re-authorize permissions

Dashboard Issues​

Dashboard not loading​

Solutions:

  1. Clear browser cache

    • Hard refresh (Ctrl+Shift+R / Cmd+Shift+R)
    • Clear cookies for cicosts.dev

  2. Try different browser

    • Test in incognito mode
    • Try Chrome, Firefox, or Safari

  3. Check status page

    • status.cicosts.dev
    • Look for outages

Data seems outdated​

Solutions:

  1. Refresh the page

    • Data auto-updates every 5 minutes
    • Manual refresh for latest

  2. Check date range

    • Ensure correct dates selected
    • Default may not include today

  3. Clear filters

    • Remove any active filters
    • Reset to default view

Charts not displaying​

Solutions:

  1. Enable JavaScript

    • Charts require JavaScript
    • Check browser settings

  2. Update browser

    • Use modern browser
    • Chrome, Firefox, Safari, Edge

  3. Disable ad blockers

    • May block chart libraries
    • Whitelist cicosts.dev

API Issues​

"Unauthorized" errors​

Solutions:

  1. Check API key

    • Verify key is correct
    • Keys shown once at creation

  2. Generate new key

    • Settings → API → Generate Key
    • Update in your code

  3. Check header format

    • Authorization: Bearer YOUR_KEY
    • No extra spaces

"Rate limited" errors​

Solutions:

  1. Wait for reset

    • Check X-RateLimit-Reset header
    • Wait until that timestamp

  2. Reduce requests

    • Cache responses
    • Use webhooks instead of polling

  3. Upgrade plan

    • Higher plans have higher limits

"Invalid request" errors​

Solutions:

  1. Check parameters

    • Verify required params
    • Check date formats (YYYY-MM-DD)

  2. Review API docs

Account Issues​

Can't sign in​

Solutions:

  1. Use GitHub OAuth

    • Sign in via GitHub
    • No separate password

  2. Clear cookies

    • Clear cicosts.dev cookies
    • Try again

  3. Check GitHub status

    • Verify GitHub OAuth is working
    • Try signing into GitHub

Need to change email​

Steps:

  1. Go to Settings → Profile
  2. Enter new email
  3. Click "Update"
  4. Verify new email via link

Want to delete account​

Steps:

  1. Go to Settings → Account
  2. Click "Delete Account"
  3. Confirm deletion

⚠️ This permanently deletes all data.

Getting More Help​

If these solutions don't work:

  1. Email support

  2. Provide details

    • Organization/repo names
    • When issue started
    • Steps to reproduce

  3. Check status

    • status.cicosts.dev
    • @cicosts on Twitter

Response time:

  • Business hours: 4-8 hours
  • Weekends: 24-48 hours