Event Analytics Pie+

Overview

Event Analytics Pie+ groups event-frame results into proportional slices using configurable arguments and series.

When to use it

Use this symbol when you need to:

• Compare how event counts, durations, or values are distributed across categories.
• Show one or more proportional summaries from the same event search.

Before you begin

• Prepare an event-frame template and search that returns the intended events.
• Choose categories with a manageable number of distinct values.

Add and set up the symbol

1. Select the symbol in the PI Vision symbol gallery.
2. Add the required data sources or asset context to the display.
3. Right-click the symbol and open its configuration pane.
4. Configure the minimum data, range, and display settings for a useful result.
5. Confirm that the symbol shows the expected data.

Getting started: creating your first analytics pie

Follow these steps to create and configure a new Event Analytics Pie+ symbol.

Step 1: Find and Select Your Event Frames

1. Open the Event Frame Search pane in PI Vision.
2. Define your search criteria (e.g., specific event frame template, time range, asset) to find the set of events you want to analyze.
3. Click Apply.

Step 2: Add the Symbol to the Display

1. Select the Event Analytics Pie+ symbol
2. From the event search results, locate the list of Attributes on the left side. These are the attributes available across the found event frames.
3. Click and hold on any attribute that you plan to use in your chart (it doesn't have to be the final one).
4. Drag the attribute onto your display. A new, unconfigured pie chart symbol will appear.

Use the symbol

Hover over a slice to inspect its category and aggregate. Use enabled selection behavior to filter or navigate.

Time bar

Event Analytics Pie+ supports the shared Time Bar for an independent Event Frame analysis range.

Interactivity

Use Click Action to give one unambiguous meaning to a slice click:

• None leaves slices informational.
• Drilldown navigates through the configured Argument or Series hierarchy.
• Filter selects one slice and publishes it according to Output Mode.

When Click Action is Filter, Output Mode can be None, Master, Linked, or Both. Under Filtering > Input, Linked channels can also restrict this pie's loaded Event Frames. Ignore Master affects only incoming Master filters; it does not disable Linked inputs.

See Filtering dashboards for channel setup and matching behavior. Pie publication remains single-selection.

The chart toolbar

The chart toolbar appears at the top right when the pointer or the keyboard focus enters the chart, and hides shortly after it leaves. Set Toolbar > Reveal to Always to keep it in view; the pies then start below the band the buttons occupy so they are never covered. On a touch device the toolbar is always shown. Turn it off entirely with Toolbar > Show. The toolbar carries two buttons: Fullscreen and Download. A pie has no axes to zoom, so there are no zoom or reset buttons.

• Fullscreen opens the pie in a dialog at the size of the display. The legend visibility you left on the embedded chart is carried into it, the dialog's own toolbar carries Download only, and closing it returns to the embedded display. A click inside the dialog does what a click on the embedded chart does - the drill-down or filter action you configured - and both charts follow it.
• Download offers PNG, SVG and PDF images and CSV, JSON and XLSX data. The data export writes one row for each drawn slice - the pie it belongs to, the slice label, the summarised value and the slice's share of its own pie as a percentage - so the file holds exactly the aggregate the chart shows rather than the underlying Event Frames. When several pies are drawn, each one's percentages add up to 100% on their own. Drill-down level and any active filters are already applied. Your administrator can hide the three data formats.

Configure the symbol

Overview and behavior

The Event Analytics Pie+ symbol visualizes the proportional breakdown of event frame data as pie or doughnut charts. It aggregates data so you can quickly see each category’s relative contribution.

The sections below cover each configuration option.

Step 3: configure the event search (Critical step!)

By default, a new symbol does not inherit the search criteria from the Event Frame Search pane - you must link it manually.

1. Right-click on the new Event Analytics Pie+ symbol you just added to the display.
2. From the context menu, select Search Criteria....
3. Configure your Event Search criteria and Click Apply.

The symbol is now configured to query the event frame data needed for its analysis.

Important: If your chart appears empty or shows "No Data," the most common reason is that the symbol's internal event search criteria (from Step 3) does not match a search that returns events. Always double-check this configuration first.

Step 4: Configure the Chart Dimensions

Configure the chart dimensions to define the analysis.

1. With the symbol selected, open the Configuration pane.
2. Under the Dimensions section, add attributes to the Values, Arguments, and Series fields to build your visualization.
3. Use the Style, Legend, and other sections to adjust the appearance.

How it works: dimensions

The pie chart uses three core dimensions: Values, Arguments, and Series - used differently from a standard bar chart.

• Values: The numerical data that determines the size of each slice.
• Arguments: The categories that become the individual slices of the pie.
• Series: Categories that split the data into multiple distinct pie charts.

Values (The "How much")

The Value determines the quantitative measure represented by slice size. Only the first configured value is used.

Data Type and Summary Type Rules

The available calculations depend on the attribute’s data type:

Arguments (The "Slices")

Arguments define the categories that become the colored slices of the pie. Add one or more arguments to create combined, more detailed slices.

• Attribute: The attribute that defines the categories for the slices (e.g., Severity, Reason Code).
• Caption: A custom name for this dimension.
• Data Type: Specify if the attribute is a String, Number, Boolean, or DateTime.
• Group Interval (for DateTime): Groups DateTime data by intervals such as Year, Month, or Day, creating slices like January and February.
• Top N: Filter the pie chart to show only the top or bottom contributing slices.
• Mode: Top or Bottom.
• Count: Number of slices to display (e.g., 5).
• Show Others: When enabled, remaining slices are aggregated into a single Others slice.

Series (The "Multiple pies")

The Series dimension splits the dataset to generate multiple individual pie charts. For example, with Severity as the argument and Asset as the series, a separate pie renders for each asset showing its severity breakdown.

Series share the same configuration options as Arguments: Attribute, Caption, Data Type, Group Interval, and Top N.

General chart options

These settings control the overall appearance and behavior of the visualization.

• Title: Show, hide, and customize the main title of the symbol.
• Show Pie Titles: When multiple pies are displayed (via the Series dimension), this shows a title above each individual pie chart to identify it.
• Style:
• Chart Type: Donut (a ring with a hole in the middle) or Pie (a solid pie chart).
• Layout (for multiple pies): Control the arrangement of multiple pie charts within the symbol.
• Auto: The symbol calculates the optimal grid layout (e.g., 2×3 or 3×2) to maximize pie size based on the symbol's dimensions.
• Fixed Rows: Specify the number of rows; the symbol calculates the required columns.
• Fixed Columns: Specify the number of columns; the symbol calculates the required rows.
• Legend: Set the position and visibility. The legend always shows Argument categories (the slices) and their colors.
• Toolbar: Controls the small button strip at the top right of the chart.
• Show: Turns the toolbar on or off. Existing displays keep it off; a newly placed symbol has it on.
• Reveal: On hover shows the strip only while the pointer or keyboard focus is in the chart, and costs no chart area. Always keeps it permanently in view and reserves a band at the top for it.
• Data Labels: Configure labels that appear on or next to the pie slices.
• Show: Toggle the visibility of all labels.
• Position: Inside or Outside the pie slices.
• Show Argument / Value / Percent: Choose which information to display in the label (e.g., "Critical: 5 (25%)").
• Show Background: Draws a colored background behind each label to improve readability.
• Coloring:
• Auto: Uses the built-in color palette for slices.
• Custom: Assign a specific color to each unique Argument value. The symbol automatically discovers the arguments in your data and lists them for coloring.

Troubleshooting and limitations

• Check: If slices are missing, check the event search, argument field, value field, and time range.
• Check: Too many categories can make labels and colors difficult to distinguish.