A simple guide to understanding your Guardrails Checker report
After you install Guardrails Checker for Jira, you'll see a report inside Jira. This page shows you what to expect when things are good, when you have warnings, and when you need to take action.
The three states
Each metric (like number of fields or workflows) can be in one of three states:
OK (green) — You're in a safe zone. No action needed.
Warning (yellow) — You're getting close to the limit. Consider cleaning up soon.
Critical (red) — You're at or past the limit. Action is needed to avoid slowdowns.
When everything is good
When all your metrics are in the green zone, you'll see a green message at the top saying your instance is clean. All gauges will be green and stay in the left part of the bar.
Example: All metrics OK
Your instance is clean2 ok / 0 warn / 0 criticalAll checked guardrails are within the safe zones (below the 75th percentile).
Computed: 3/19/2026, 10:30:00 AM (live)
Scan statusProjects: 12 · live
Legend
Gray Expected/clean baseline (the guardrail limit)
75th+ zone 75th to 95th percentile range (yellow)
95th+ zone 95th+ percentile range (red)
Metrics
Priorities (global)ok
Before the 75th percentile
25/100 (25%)
Fields (global)ok
Before the 75th percentile
280/700 (40%)
When you have warnings
When one or more metrics pass the 75% mark (yellow zone), you'll see a yellow warning message. The app will also show you "Where to look" — hints like which fields or workflows to review.
Example: Some metrics in warning zone
Warnings detected1 ok / 1 warn / 0 criticalOne or more guardrails are between the 75th and 95th percentiles. Consider addressing them before performance is impacted.
Computed: 3/19/2026, 10:30:00 AM (live)
Scan statusProjects: 45 · live
Metrics
Priorities (global)ok
Before the 75th percentile
50/100 (50%)
Fields (global)warn
Between the 75th and 95th percentiles
Where to look: Fields sample: Summary, Description, Assignee, Status, Priority… Total fields: 574 (420 custom).
574/700 (82%)
When you need to act
When any metric reaches 95% or more (red zone), you'll see a red message. This means you should fix these items soon to avoid Jira slowing down. The app will point you to the exact areas to focus on.
Example: Critical metrics — action needed
Fix required to protect performance1 ok / 0 warn / 1 criticalOne or more guardrails are at or above the 95th percentile. Fix these items to avoid performance impact.
Computed: 3/19/2026, 10:30:00 AM (live)
Scan statusProjects: 120 · live
Metrics
Fields (global)critical
At/above the 95th percentile
Where to look: Fields sample: Summary, Description, Assignee, Custom Field 1, Custom Field 2… Total fields: 686 (520 custom).
686/700 (98%)
Top projects (highest risk)
PROJ — My Big Project: Fields (global) (98%) - critical
Where to find the app in Jira
Admin report — Go to Jira Settings → Apps → Guardrails Checker for Jira. You'll see the site-wide report with all metrics.
Project report — Open any project, then click "Guardrails Checker for Jira" in the project sidebar. You'll see metrics for that project only.
Refreshing the report
The app saves results to load faster. Use "Refresh site" or "Refresh this project" to get fresh data. Results also refresh automatically every hour.