Related Products:

EMMK-101, EMMK-102, EMMK-103

Related Documents:

ISCM-0380, ISCM-0385




tracepoints, trace logger


This article describes logging important event details.

Logging Important Event Details

A tracepoint is a flag that, when enabled, instructs the server to log messages about when particular events occur. For example, the Storage.MajorOps tracepoint flags events related to file I/O. Review a dynamic list of tracepoints that update as they become available.

  1. Click the Navigational menu » Utilities » Trace Logger.

  2. (Optional) Double-click a tracepoint in the table to enable or disable a specific tracepoint.

  3. (Optional) Create an exception that inverts the status of a tracepoint for a specific device.


    Exceptions work differently depending on whether the tracepoint is enabled or disabled.

    • Enabled tracepoints - An exception prevents the server from generating messages for the exception item.

    • Disabled tracepoints - An exception allows the server to generate messages for only the exception item.

    1. Select a tracepoint whose name begins with Device in the table.


      Exceptions are valid only for tracepoints whose names begin with Device.

    2. Click the Edit button.

    3. Click Add and enter the name of the device you want to create an exception for in the text field that appears.


      Exceptions are case-sensitive.

  4. Download logs of a tracepoint or server-crash information as text files.

    1. Click the Action menu.

    2. Select Download Trace Log or Download Crash Log.

tracepointEnabled tracepointsDisabled tracepoints

Exceptions for Device-Related Tracepoints

Exceptions are useful for storing tracepoint information from a select number of devices instead of all devices.

For example, if you only care about a specific device that is experiencing issues rather than every device in the system, you might disable the Device.SystemEvent.Level1 tracepoint. Additionally, you might create an exception for the one device you are interested in tracking so that the server generates messages for any events that device might have. Exceptions are case-sensitive, so when you add an exception, enter the exact device name.

Notable Tracepoints

Please note that this is not a complete list of all available tracepoints.

Tracepoint Name

Tracepoint Description

Use Case


Reports about operations related to authenticating device credentials.

You are bringing devices online and troubleshooting connection issues.


Each time a device tries to connect, reports specific issues related to the device status, such as the software configuration or application being out of date.


Reports when devices connect, disconnect, or become authorized to connect to the InsightCM Server.


Reports when the device sends data events to the server.

See when a device sends data to the server.


Reports general operations for storing data events.

Monitor the server receiving data events from devices.


Reports whenever InsightCM Server writes a value to the PI software.

You want to monitor activity by historian software.

Do you need more help?

tracepointEnabled tracepointsDisabled tracepoints
Was this article helpful?
0 out of 0 found this helpful