Troubleshooting

When a scoring screen behaves unexpectedly, enabling diagnostic logging helps the AC Team understand what's happening on that specific screen. This page explains how to enable logging, what each option captures, and how to report issues.

For configuration options, see Create and Configure Screens. For live operation, see Controlling Screens.

1. Show Logging

The Show logging option displays diagnostic information directly on the screen. It's mainly used to investigate display or behavior issues by revealing:

  • Screen transitions
  • Incoming data updates
  • Timing and animation events

Important Notes: Enable this only for troubleshooting, typically when requested by the AC Team or when preparing to report an issue.

1.1 How to Enable Logging

  1. Turn on Show logging.
  2. Choose one or more log types from the dropdown menu.

1.2 Logging Options Explained

Each option highlights a different type of diagnostic data:

  • Screen Overrides — Shows any custom configurations applied to the current screen.
  • Relevant Info — Displays the key data expected to appear on the screen.
  • Lifecycle Hooks — Tracks Angular lifecycle events for debugging.
  • Animation Triggers — Logs animation events such as transitions between views.
  • Screen Borders — Adds visual outlines to help debug layout issues (may not be visible for all users).

1.3 Suggested Setup for Debugging

For most issues, enable:

  • Screen Overrides
  • Relevant Info
  • Animation Triggers

This combination usually provides enough detail without overwhelming the screen.

Important Notes: Enable this only for troubleshooting, typically when requested by the AC Team or when preparing to report an issue.

2. How to Report an Issue

When experiencing screen issues:

  1. Enable logging options as described above.
  2. Go to the affected screen.
  3. Open DevTools (usually F12) and wait for the issue to occur again.
  4. Take a screenshot of the Console tab logs.
  5. Submit the issue to the AC Team using the bug reporting manual.

2.1 What the Logs Help You Identify

  • Data flow — How information is being passed to the screen.
  • Rendering issues — Problems with how elements are displayed.
  • Timing problems — Issues with duration and transitions.