Event Analytics Chart+

Overview

Event Analytics Chart+ aggregates event-frame data into configurable chart dimensions, values, arguments, and series.

When to use it

Use this symbol when you need to:

• Compare event metrics by asset, category, batch, or another event attribute.
• Turn an event-frame search into an aggregated operational chart.

Before you begin

• Prepare an event-frame template and search that returns the intended events.
• Confirm that selected value fields support the required aggregation.

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 chart

Follow these steps to create and configure a new Event Analytics Chart+ 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 Chart+ symbol
2. From the event search results, locate the list of Attributes below. 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 Event Analytics Chart+ symbol will appear.

Use the symbol

Hover over chart items to inspect aggregated values and use enabled selection actions to filter or navigate.

Interactivity

The Event Analytics Chart+ 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., Country, then City) and Drilldown set to Argument, the chart initially groups data by the first argument. Clicking a bar drills down to the next argument level. A Drill Up button appears to navigate back.
• Master Filter: Turn the chart into an interactive filter for other symbols on the display.
• Enabled: When checked, clicking a bar or data point broadcasts a filter to all other symbols on the display that share the same attribute.
• Ignore External: When checked, this chart ignores filters broadcast by other symbols - useful when the chart should act as a filter source only, not a target.

Configure the symbol

Overview and behavior

The Event Analytics Chart+ aggregates and visualizes event frame data in a flexible Cartesian chart - bar, line, or area. Unlike display-only charts, it performs calculations on your data so you can surface trends and insights directly on a PI Vision display.

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 you ran in the Event Frame Search pane - you must link it manually.

1. Right-click on the new Event Analytics Chart+ 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.

Note: If the chart appears empty or shows "No Data," the most likely cause is that the symbol's event search criteria (Step 3) returns no matching events. Check this configuration first.

How it works: dimensions

The chart is built around three core dimensions: Values, Arguments, and Series.

• Values: The numerical data you want to plot on the Y-axis (or X-axis in a horizontal chart).
• Arguments: The categories that will be displayed along the X-axis (or Y-axis in a horizontal chart).
• Series: The way you want to split or group your data into different colored bars or lines within the chart.

Values (The "What")

Values define what is measured and plotted on the chart. You can add one or more attributes; the available calculation methods depend on the attribute's data type.

• Attribute: The event frame attribute containing the data to be analyzed (e.g., Temperature, Status, Reason Code).
• Title: A user-friendly name (e.g., "Max Temperature").

Summary Type

The available summaries depend on the attribute's data type:

• Count: The total number of events that occurred within the category.
• Sum / Average / Min / Max: Statistical calculations applied only to numeric data points.
• Count Distinct: The number of unique values observed within the category (e.g., counting how many unique users logged an event).
• Show: Toggle off to hide the value from the chart while still using it for sorting or filtering.
• Series Type: How this value should be visualized.
• Bar: Displays the data as vertical or horizontal bars.
• Line: Displays the data as a connected line. Can be styled as a Step line.
• Area: A line chart with the area below it filled in.
• Scatter: Displays individual data points as markers.
• Stacking: If you have multiple values or series, this controls how bar/area charts are displayed.
• None: Bars are grouped side-by-side (clustered).
• Stacked: Bars are stacked on top of each other to show a combined total.
• Normalized: Bars are stacked and scaled to 100%, showing the relative contribution of each part.
• Secondary Axis: When enabled, this value is plotted against a separate Y-axis on the right - useful for comparing two values with different scales (e.g., Temperature and Pressure).
• Data Labels: Configure labels that appear directly on data points. Options include showing the value, argument name, or series name, and setting the position (top or inside).
• Lines: Add static reference lines (e.g., targets or limits). Configure the value, color, style, and label for each line.

Arguments (The "Where")

Arguments define the categories used to group values. Add one or more arguments to create combined categories - for example, combining Asset and Severity produces categories such as "Pump 1 - Critical" and "Pump 1 - High".

• Attribute: The attribute that defines the categories (e.g., Severity, Reason Code, Asset).
• Title: A custom name for this argument, used in axis titles.
• Group Interval (for DateTime): If the data type is DateTime, you can group the data by intervals like Year, Month, Day, Day of Week, etc.
• Sort: Control the order of the arguments on the axis.
• Order: Ascending or Descending. Default is alphabetical/chronological.
• Sort By: The configured Value to use for sorting. For example, sort assets by Sum of Downtime rather than by name.
• Top N: Filter the chart to show only the top or bottom contributing arguments.
• Mode: Top or Bottom.
• Count: Number of items to display (e.g., 5).
• Value: Choose which Value to use for ranking.
• Show Others: When enabled, all remaining items are aggregated into a single “Others” category.

Series (The "How")

Series split the data within each argument. For example, with an argument of Month and a series of Reason Code, the chart renders a separate colored bar or line for each reason code within each month.

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

General chart options

These settings control the chart's overall appearance and behavior.

• Title: Show, hide, and customize the main title of the chart.
• Style:
• Orientation: Vertical (standard) or Horizontal (swaps X and Y axes).
• Grid Style: Customize the background grid lines of the chart.
• Legend: Configure the position, alignment, and visibility of the chart legend.
• Axis (X, Primary Y, Secondary Y): Configure each axis individually:
• Show/Hide: Control the visibility of the axis line, labels, and title.
• Title Text: Set a custom title for the axis.
• Scale Range: For value axes (Primary Y, Secondary Y), you can switch from Auto to Custom and set a fixed minimum and maximum range.
• Coloring:
• Auto: Uses the built-in color palette.
• Custom: Assign a specific color to each unique series value. The symbol automatically discovers the series in your data and lists them for coloring.

Troubleshooting and limitations

• Check: If the chart is empty, test the event search and confirm its time range and template.
• Check: High event counts and many dimensions can increase query and rendering time.