Probe Control Objects

## Probe Control Objects |

| The control objects view shows tabular information on the control objects published by the selected probe. For built-in probes, the name of view reflects the name of the control object, for example "Connections" or "Files". Please see the probes overview for more information on the probe-specific control objects.

| The available columns depend on the probe, the following columns are available for all probes: ID The numeric ID of the control object as assigned by JProfiler. This is is also displayed in the time line view and the events view and can be used there to filter for a specific control object. Name The name column contains the description of the control object, which depends on the probe. For built-in probes, the column is named more specifically, for example "File name" or "Command line". Start time This is the time when the control object was opened and corresponds to an "open" event in the events view. In the time line view, this is the beginning of the displayed horizontal bar for the control object. End time This is the time when the control object was closed and corresponds to a "close" event in the events view. In the time line view, this is the end of the displayed horizontal bar for the control object. A probe can determine that certain properties are published in a nested table. This is done to reduce the information overload in the main table and give more space to table columns. If a nested table is present, such as for the file and process probes, each row has an expansion handle at the left side. If you click on is a property-value table will be expanded in-place. All properties in that table are also available in the filter selector described below. If a probe publishes several types of control objects, such as the files and socket probes, a "Type" column is added that shows the type of the control object. Please see the probe overview for the probe-specific types. If a nested table is present, the type will be added to the nested table. Most probes publish summary information on measurements that are available on a per-event basis. For example, the number of bytes that are read or written for a socket event is summed for all events and published as columns in the control objects view. This information is also available if single event recording is disabled. In general, for each available state a count column is added for each summable numeric column in the events view, a corresponding column is added In addition, each probe can publish additional columns that describe the control object and its state, but are not part of its name. Please see the probe overview for more probe-specific information. At the bottom the of the table, there is a special total row that sums all summable columns in the table, such as durations, counts and throughputs. Together with the filter selector described below, you can analyze the collected data for selected subsets of control objects.

| At the top of the view, there is a filter selector. You can use it to restrict the displayed control objects by Status From the combo box you can choose if you wish to display open, closed or both open and closed control objects. Name In the text box you can enter the full name of a control object or only a part of it. Only control objects whose names begin with this fragment are displayed. You can also use wildcards ("*" and "?") to select groups of control objects. Please note that if you use wildcards, you have to manually append a trailing "*" if desired. You can display the union of multiple filters at the same time by separating multiple filter expressions with commas, e.g. `test-, MyTest-*-123`. By default, the filter works on all available columns. In order to be more specific, you can select a particular column from the "Filter by" drop-down list. This is useful, for example, to show a control object with a particular ID without getting spurious matches from other columns.

| When you right-click a control-object row, the context menu contains a "Show events for selected control object" action that allows you to jump to the events view and display all events for the selected control object there. The "Add Selection To Tracker" action creates a tracker graph in the probe tracker view. You can select multiple control objects to create a single tracker graph for the sum of their operations.