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.

Interactivity

The Event Analytics Pie+ supports interactive dashboard features.

• Drilldown: This feature allows you to navigate through multiple configured dimensions.
• Mode: Argument or Series.
• How it works: With multiple arguments (e.g., Region, then City) and Drilldown set to Argument, the chart initially shows slices for Region. Clicking a slice drills down to a new pie showing cities within that region. A Drill Up button appears to navigate back.
• Master Filter: Turn the pie chart into an interactive filter for other symbols.
• Enabled: When checked, clicking a pie slice broadcasts a filter based on that slice's argument value.
• Ignore External: When checked, this pie chart ignores filters broadcast by other symbols.

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.
• 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.