Search for events

To find specific events, perform an advanced search by editing your search criteria.

1. In the Events pane, click Edit Search Criteria to open the Edit Search Criteria pane.

   

2. Click the arrows to expand each search criteria and set appropriate values.

   • Database

     Select a single PI AF database that contains the events you want to retrieve.

     Note: The search will not work unless a database is selected.

   • Time Range

     Select the time range of the retrieved events:

     • Timebar Duration: Find events that occurred between the start and end time of your display.

     • Any Time: Find events that occurred at any time.

     • Today: Find events that occurred today.

     • Last 7 Days: Find events that occurred in the last 7 days.

     • Last 30 Days: Find events that occurred in the last 30 days.

     • Custom Time Range: Use the time picker to select the start and end time for your events or enter PI time.

   • Event Severity

     Select the severity of retrieved events. Event severity levels are marked in the Events pane with a color-coded bar.

   • Event Name

     Enter the name of the event you want to retrieve. You can use wildcards such as asterisks (*). For example, enter *downtime* to find Reactor 3 Downtime. Do not use quotation marks.

   • Event Type and Attribute Value

     Specify event types and attribute values of retrieved events:

     • Event Type: Select an event type. Event types correspond to event-frame templates. For more information, see the PI Server topic Event frame templates.

     • Event Attribute: Specify attributes from the selected event type and specify desired values for those attributes. You can specify up to five event attributes. Click the plus (+) sign, select an attribute from the list, select an operator, and enter a value.

       For example, to find downtime events during which the temperature was above 100 degrees, select Downtime from the Event Type list and Temperature from the Event Attribute list, and then select > from the operator list and enter 100 in the value field.

       Note: If the attribute's value type is an enumeration set or a Boolean, you can select the value from the list by clicking the down-arrow. For more information, see the PI Server topic Enumeration sets.

       

   • Asset Name

     Specify the asset associated with retrieved events:

     • Any: Search all assets in the database for associated events.

     • Assets on Display: Search assets on the current display for associated events. You must be connected to PI AF version 2017 R2 or later to use this option.

     • Specify Name: Enter the name of a specific asset that you want to search for associated events. Use wildcards such as question marks (?) and asterisks (*) to stand for single or multiple characters, respectively. Multiple assets are delimited by semicolons.

   • Asset Type

     Select the asset template of assets referenced by retrieved events.

   • Event State

     Select the state of retrieved events:

     • Any: Find events that are in progress or completed.

     • In Progress: Find events that are currently in progress.

     • Completed: Find events that are completed.

   • Event Category

     Select the category of retrieved events. For more information, see the PI Server topic Categorization of objects.

   • Event Acknowledgment

     Select the acknowledgement status of retrieved events:

     • Any: Find events with any acknowledgment status.

     • Acknowledged: Find events that users have acknowledged.

     • Unacknowledged: Find events that no user has acknowledged.

       You can acknowledge events on the event details page.

   • Event Comments

     Select the comment status of retrieved events:

     • Any: Find events with and without comments.

     • Has Comments: Find events that have comments.

     • No Comments: Find events that do not have comments.

       You can insert comments to annotate events on the event detail page.

   • Event Duration

     To retrieve events with a specific duration, select Specify Duration and enter the maximum and minimum duration of the desired event. Duration can be expressed in seconds, minutes, hours, or days.

   • Number of Results

     Specify the number of events to retrieve:

     • All Events: Retrieve any number of matching events.

     • Number of Most Recent Events: Retrieve the specified number of events, starting with the most recent.

     • Number of Earliest Events: Retrieve the specified number of events, starting with the earliest event.

   • Search Mode

     Select when the retrieved events occurred relative to the time range set in the Time Range criteria:

     • Events Active in Range: Find events that were active at any time within the specified time range. These events might have begun before the start of the specified time range and ended after the end of the specified time range.

     • Events Entirely in Range: Find events that began and ended within the specified time range.

     • Events Starting in Range: Find events that began within the specified time range.

     • Events Ending in Range: Find events that ended within the specified time range.

3. Select the Return All Descendants check box to also return all the descendants of the retrieved events, such as child events or grandchild events.

4. Click Apply to search for matching events and close the Edit Search Criteria pane.

   The search results appear inside the Events pane.