Skip to content

Issues Overview

Issues represent grouped failures from your API tests. When a test fails, Pingward creates or updates an issue to track the problem.

How Issues Work

Issue Creation

When a test fails, Pingward:

  1. Classifies the error (timeout, 5xx, assertion failure, etc.)
  2. Generates an error signature for grouping
  3. Checks for existing open issues with the same signature
  4. Creates a new issue or updates an existing one

Issue Grouping

Related failures are grouped into a single issue:

  • Same test
  • Same error category
  • Same error signature (similar error characteristics)

This prevents alert floods when a service has repeated failures.

Issue States

StateDescription
OpenActive problem, test is still failing
AcknowledgedTeam is aware and working on it
ResolvedProblem is fixed, test is passing

Issue Properties

Severity

Based on error category and test importance:

  • Critical - Immediate attention required
  • High - Important, address soon
  • Medium - Should be addressed
  • Low - Minor issue

See Severity Levels for details.

Error Category

The type of failure:

  • Connection errors (Timeout, DNS, Connection Refused)
  • HTTP errors (5xx, 4xx)
  • Validation errors (Assertion failures)

See Error Categories for the full list.

Occurrence Count

How many times the test has failed while the issue is open. Higher counts indicate persistent problems.

Duration

How long since the issue was first detected. Long-running issues may need escalation.

Working with Issues

Acknowledging

Click Acknowledge to indicate you're aware of the issue:

  • Optionally add a note explaining the situation
  • Acknowledged issues appear differently in the dashboard
  • Routing rules can filter on acknowledgment status

Resolving

Click Resolve when the problem is fixed:

  • Add a resolution note for future reference
  • The issue moves to resolved state
  • A new failure will create a new issue

Activity Log

Each issue has an activity log showing:

  • When the issue was created
  • Test failures and successes
  • Acknowledgments and notes
  • Resolution details

Dashboard

The dashboard shows:

  • Active Issues - Open issues requiring attention
  • Recent Incidents - Recently resolved issues
  • Overall Availability - Aggregate uptime percentage

Next Steps

Pingward - API Monitoring Made Simple