Pages

This document shows you how to track and troubleshoot site errors in the Frosmo Control Panel.

Introduction to error tracking

The error tracking functionality of the Frosmo Control Panel allows you to track and troubleshoot errors on your sites. You can:

  • Select which sites to monitor for errors.
  • View the summary status of all monitored sites (only latest errors).
  • View the detailed status of each monitored site (all errors and other alerts).

For instructions on how to perform these tasks, see Tracking errors.

Services and service alerts

Error tracking in the Frosmo Control Panel is built around services and service alerts.

A service tracks specific type of data about a site's performance, such as statistics, and uses a specific metric to quantify that data, such as number of displays. A service also has a status indicating the current state of the site with respect to the data the service tracks. A service pools together service alerts matching the service's type, metric, and, if defined, name. A service is always unique to a site.

A service alert is triggered for a site and forwarded to the corresponding service based on the service's type, metric, and, if defined, name. An alert includes a status and optionally a description and a data field that together describe what the alert is about. The status of the latest alert determines the current status of the corresponding service.

The status can be "OK", "Warning", "Critical", or "Unknown". If the status is "Critical" or "Warning", you have an error on your site that needs looking into.

The type can be one of the following:

  • Crontab: The service tracks errors that occur while running specific shell scripts for the site.
  • Statistics: The service tracks specific statistics data gathered from the site.

Service example: Daily placement displays

This service tracks the total number of daily modification displays for all placements on the site. For each placement, the daily display count is compared to the display count for that same day the week before. If the new display count has dropped significantly from the previous week, the selector or trigger of the placement may no longer be valid.

This is the service definition:

  • Type: statistics
  • Name: placements (rendered on the page as "statistics placements displays (daily)")
  • Metric: displays (daily)
  • Status: ok or warning
  • Schedule: 1 alert per day

The service receives an "OK" alert if the display counts have not significantly dropped from the previous week:

The modification displays for all placements are OK.

The service receives a warning if the display count for one or more placements is less than one tenth of the display count for the same day the week before, and if the previous count exceeds 1000 displays:

The modification displays for <number of> placements has dropped significantly.

The service does not warn about placements whose previous count is less than or equal to 1000 displays.

The following figure shows the service defined for a site, with the alert history expanded.

Service for daily placement displays

Figure: Service for daily placement displays

To view detailed information about the status of individual placements, click Data for an alert, and check the warning and ok arrays for previous (prev) and current (curr) display counts per placement.

Detailed information about placement display counts

Figure: Detailed information about placement display counts

Tracking errors

To track errors on your sites:

  1. Start monitoring the sites.
  2. Check the sites for errors by viewing their summary status and detailed status.

Monitoring sites

Monitoring a site means having its summary status shown on the Error Tracking > Overview page of the Frosmo Control Panel. Even if you do not monitor a given site, you can still view its status on the Error Tracking > Site Status page, and you will still receive error notifications for any services you've previously subscribed to.

When you're monitoring one or more sites, and if there alerts on the sites, you will see a warning icon in the upper right corner of the Control Panel. The icon represents the total combined number of active critical alerts and warnings from all your monitored sites.

Warning icon for total number of active critical alerts and warnings

Figure: Warning icon for total number of active critical alerts and warnings

Starting monitoring

To start monitoring a site:

  1. In the Control Panel, open the site you want to start monitoring.
  2. Select Error Tracking > Overview.
  3. Click Add current site to Overview.

The site is added to your monitored sites on the Overview page.

Stopping monitoring

To stop monitoring a site:

  1. In the Control Panel, open the site you want to stop monitoring.
  2. Select Error Tracking > Overview.
  3. Click Remove current site from Overview.

The site is removed from your monitored sites on the Overview page.

You can also stop monitoring a site by clicking the quick menu button for the site on the Overview page and selecting Remove site from Overview.

Viewing the summary status of monitored sites

To view the summary status of all your monitored sites:

  1. In the Control Panel, select Error Tracking > Overview.
  2. Review the sites:
    • For each monitored site, by default, the page shows the summary counts of the latest alerts by status, and the timestamp of the last alert.

      Summary status

    • For each monitored site, the page also shows a graph with the top Frosmo Core errors for the last 24 hours. The graphs are in an automatically rotating carousel that you can also traverse freely.

      Frosmo Core errors

  3. To view detailed information about the latest critical alerts and warnings for a site, click the site row to expand it. For each alert, the detailed information includes:

    • Service name
    • Description
    • Status
    • Timestamp

    If a site has no recent critical alerts or warnings, the row is not expandable, since there's no error information to display.

    Summary status with expanded details

Viewing the detailed status of a monitored site

To view the detailed status of a monitored site:

  1. In the Control Panel, select Error Tracking > Overview.
  2. Click the quick menu button for the site whose detailed status you want to view, and select View site status. The Site Status page opens.

    Viewing site status

  3. Review the site:
    • The page lists all alerts for the site grouped by service.
    • For each service, by default, the page shows the description, status, and timestamp of the last alert. The page also shows the following icons depending on the service state:

      • Error notifications enabled: If you're receiving error notifications for the service.
      • Error notifications disabled: If error notifications for the service are temporarily disabled for all users.

      Services summary

    • At the bottom, the page also shows a graph with the top Frosmo Core errors for the selected time range.

      Frosmo Core errors on a site

  4. To view earlier alerts for a service, if available, click the service row. The row expands to show the 10 newest alerts following the last alert. If there are older alerts, to view them all, click Show all. For each alert, the information includes:

    • Description
    • Data
    • Status
    • Timestamp

    Services summary with expanded details

    To view detailed information about an alert, if available, click Data for the alert.

    Viewing detailed information about an alert

  • No labels