Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Us
  • Website
  • Partner
English (US)
IT Italian
US English (US)
ES Spanish
  • Home
  • TimeView
  • Work with the chart

Sag & Swell Events

Spot short voltage dips and spikes on a PAN-42 device's TimeView chart, at the moment they happened.

Written by Shir Goldstein

Updated at November 17th, 2026

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Getting Started
  • Dashboard
  • TimeView
    Get started Work with the chart Understand your data Time & comparison Save & share Advanced
  • Energy Apps
  • Alerts & Notifications
  • Reports
  • Administration & Settings
  • Partners
  • Import & Exports
  • Mobile App
    Getting Started & Signing In Navigating the App The Site Dashboard and Its Widgets TimeView Lite Events (Optimize + Event Management) Notifications, alerts & push Preferences, Support & App Behavior
  • Plans & Packages
  • Security & Certification
  • Deployment
  • Hardware Manuals
  • Datasheets & Specs
  • Frequently Asked Questions (FAQ)
    Bridge FAQs PAN-10/PAN-12/PAN-14 Sensors FAQs PAN-42 Sensor FAQs Software Platform FAQs Package FAQs
  • Legal
  • What’s New
  • Bidirectional-Power
  • Energy Star Portfolio Manager
  • Panoramic AI
+ More

Table of Contents

What Are Sag & Swell Events? Before You Start Where to Find It Reading Events on the Chart Comparing Periods Exporting Sag & Swell Data How Reliable Is This Data? Troubleshooting Related Articles

What Are Sag & Swell Events?

What is it?

A sag is a short drop in voltage. A swell is a short rise in voltage. Both are brief events. They aren't a change in the site's normal voltage level, but a quick dip or spike.

Why use it?

  • Sags are a common cause of equipment trips, shutdowns and process interruptions.
  • Swells can damage sensitive electronics.
  • You see events on the same chart as your voltage data, so you can line up an equipment trip with a real voltage event instead of guessing.

Before You Start

What you'll need:

  • A PAN-42 meter. The PAN-42 meter detects these events itself. Other Panoramic Power sensors don't report them.
  • Firmware version 2. Only PAN-42 meters on firmware version 2 (shown as 2.04, 2.05 and so on) report Sag & Swell events. To check, go to Inventory → Panoramic Sensors and look at the Firmware version column. If it starts with 0 or 1, the meter doesn't report events. You can still turn Sag & Swell events on, but the chart stays empty.
  • A Voltage chart. Sag & Swell events are available only when the chart's Show By is set to Voltage.

If you need Sag & Swell events on an older meter, contact your Panoramic Power contact, or submit a ticket to the PowerRadar team and we'll get back to you.


Where to Find It

Sag & Swell events are a per-device add-on. They aren't in the toolbar Add-ons menu.

  1. Add a PAN-42 circuit or device to your chart.
  2. Set the chart's Show By measurement type to Voltage.
  3. In the Legend on the right, hover over the device row and click the add-ons icon.
  4. In the Chart series add-ons panel, open the Quality category and check Sag & Swell events.

Notes:

  • Voltage only. If the Sag & Swell events row is greyed out, switch Show By to Voltage first.
  • Up to one year. Events show for date ranges of up to one year.
  • One device at a time. Each device needs its own add-on. A device shows events only if you turned the add-on on for it.

For a device, events show once for the whole device, even if you expanded it into its phases. The tooltip tells you which phase each event affected.

First-time explanation

The first time you turn on Sag & Swell events (or THD), a window called About PAN-42 power quality explains what the data is and its limits. It appears once per user. Closing it doesn't turn the add-on off.


Reading Events on the Chart

When an event falls inside your selected time range, TimeView shows it in three ways:

  • A marker over the period the event lasted. Sags are red and swells are blue. Longer events show as a shaded band. Very short events, lasting less than a second, show as a thin dashed vertical line.
  • A short label above the chart with the total duration and count, for example 0.6s · 8x.
  • A row at the bottom of the hover tooltip with the event type, the affected phases, the count and the total duration, for example Sag L1, L2, L3 · 4x · 0.3s (four sags on all three phases, lasting 0.3 seconds in total).

Phase names follow your site's setup, for example L1, L2, L3 or R, S, T.

The Sag & Swell events row in the Legend shows both colours, red for sag and blue for swell.

Longer time ranges

TimeView groups events into time intervals. The interval gets bigger as your date range gets longer. Back-to-back intervals with events merge into one marker, and the label shows the total count and duration.

Date range Interval size
Up to 1 day From 1 minute
Up to 7 days From 5 minutes
Up to about a month 1 hour
Up to a year 1 day or 1 month

To see events separately, zoom in to a shorter range.

Notes:

  • No marker means no events were recorded. PowerRadar stores only the times when an event happened. So an empty chart can mean the power was clean. It can also mean the meter was offline, runs older firmware, or an event message was lost. Don't read an empty chart as proof that no sags or swells happened.
  • No voltage value. The marker, label and tooltip show the event type, phase, count and duration. They don't show the voltage level reached during the event.

Comparing Periods

  • Split view: events show for both periods, each in its own chart.
  • Overlay view: events aren't shown, because the markers from two periods would cover each other. The add-on shows: "Not available while Compare is overlaid. Switch Compare to split view to see Sag & Swell for both periods."

Exporting Sag & Swell Data

Manual Export

Choose Sag & Swell events as the measurement type. The file has a timestamp column, then four columns per device:

  • Sag Count
  • Swell Count
  • Sag Duration (ms)
  • Swell Duration (ms)

The three phases are added together. Intervals with no events are left blank.

Scheduled exports (Auto-export)

In a Pan-42 Measurements export job, check Include power quality columns. Each row then includes sag_count, swell_count, sag_duration(ms) and swell_duration(ms), along with the THD columns. The column names are the same in CSV and JSON.

Note: A row can show a duration above 0 with a count of 0. This is normal meter output, not an error.


How Reliable Is This Data?

The PAN-42 meter flags an event when voltage moves about ±20% away from its normal level. "Normal" is a slowly moving average of the voltage the meter measures, not a fixed value such as 230 V. The meter reports events once a minute, so they reach PowerRadar with a short delay.

Notes:

  • Large events are captured well. Very short or shallow dips and spikes may not be captured. Read a marker as "an event happened", not as a full record of every fluctuation.
  • Counts are approximate. Treat the count as a guide, not an exact tally.
  • Fixed threshold. You can't change the threshold, and there's no threshold line on the chart.

Troubleshooting

  • Symptom: Sag & Swell events are on, but the chart never shows any events. Fix: Check the meter's firmware under Inventory → Panoramic Sensors. If the Firmware version starts with 0 or 1, the meter doesn't report events. Contact your Panoramic Power contact, or submit a ticket to the PowerRadar team. If the firmware starts with 2, the site may have had no events in that period.
  • Symptom: The Sag & Swell events row is greyed out. Fix: Select a PAN-42 circuit or device and set Show By to Voltage.
  • Symptom: Events disappeared when you turned on Compare. Fix: Switch Compare to split view. Events aren't shown in overlay view.

Related Articles

  • THD (Total Harmonic Distortion)
  • Chart Series Add-ons & PAN-42 Metrics
  • Why PAN-42?
  • Export Jobs: Pan-42 Measurements Interface
timeview sag swell sag and swell quality add-ons pan-42 voltage sag voltage swell legend

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Understanding the Electrical Hierarchy
  • How TimeView calculates hierarchy totals
  • What is power factor?
Expand