A tag is a special identifier for the type of snapshot, which indicates where and how it was captured within the code.

Tags can be classified as:
  • System—Produced at the predetermined event established by the system within the ABL application. This tag begins with an underscore ( _ ). The following system-generated tags are available:
    Table 1. System tags
    Tag Description
    _Auto Specifies the snapshots that were generated automatically. The cadence property in the configuration file states how often to create a snapshot automatically.

    For more information on the cadence property, see Enable the AVM for memory profiling.

    _EndOfRequest Specifies the snapshots that were generated upon completion of a PAS for OpenEdge request.
    _Exit Specifies the final snapshot that was generated before the ABL Session ended.
    _PreCleanup Specifies the snapshots created shortly before the ABL Session was cleaned up before exiting. This is where leaks at the end of the profiling session are most noticeable.
  • User-defined—Produced programmatically from within the ABL application by using the MemoryProfiler:TakeSnapshot() function in your application logic. You can assign these user-defined tags to programmatic snapshots, making it easier to connect the snapshot data to specific locations in your application code. The tag can be any string, however OpenEdge Memory Profiler reserves tags that begin with the underscore character ( _ ).

    For more information, see Take a memory snapshot programmatically.

The Tags section displays a table, which groups snapshots by the tag name. The table contains the following information:
Table 2. Tag table display columns
Column Description
Tag Specifies the name of the tag.
Count Specifies the count of snapshots captured with that tag.
Type Specifies the type of tag. The value shown is:
  • System
  • User
You can customize the table view by selecting or deselecting the Type column using the column picker, available through the Primary Column Selection menu. Additionally, you can sort the table by a specific column by clicking the corresponding column header.
You can click on each of the tag hyperlinks to view a paginated list of snapshots captured with that tag. The Snapshot Tag:Tagname dialog box opens, which displays a list of snapshots associated with the selected tag. Each snapshot entry includes the following details:
Table 3. Snapshot Tag:Tagname dialog box
Column Description
Id Specifies the snapshot identifier at a particular time of memory use within the recording.
Time Specifies the timestamp of the snapshot within the recording, without a timezone.
Application Memory (MB) Specifies the application memory consumed by the ABL application at the time of the snapshot.
Platform Memory (MB) Specifies the platform memory consumed by the ABL application at the time of the snapshot.
Request Id Specifies the request identifier of the request that is currently being handled by the ABL session for Progress Application Server (PAS) for OpenEdge. This field is blank for an ABL client process.
Request API Specifies the name of the top-level API called for the current request, applicable only for PAS for OpenEdge. This field is blank for an ABL client process.

Not all columns are displayed by default. You can customize the table view by selecting or deselecting the Platform Memory (MB) column using the column picker, available through the Primary Column Selection menu. Additionally, you can sort the table by a specific column by clicking the corresponding column header.

To view more detailed information about the memory consumed by a particular snapshot within that list, click the hyperlinked snapshot Id. The Snapshot page launches. For more information about the Snapshot page, see Snapshot.