Working with Logs

Application Repository has a variety of logs to help you audit and troubleshoot deployments and promotions. The logs have some common features that are explained in the following topics.

Creating a Filter

Some views in Application Repository enable you to define a filter. A filter enables you to limit the results of a search. The filter incorporates search criteria such as strings or a calendar date. You can name the filter to make it easy to retrieve.

Note: Unless you select a filter, all messages are shown in the log.

A filter is visible only to the user who defined it.

To create a filter:

  1. Click the plus icon (+) to create a new filter. The filter rule fields appear.
  2. Click the plus icon (+) to the right of the filter rule fields to create an additional row of filter rule fields, if necessary. A new row is added, and the Match drop-down list appears. This enables you to define whether any or all the rules should be matched.
  3. If you do not need more than one rule, click the minus sign to delete the additional row; otherwise, continue adding rows as needed.
  4. If you do have more than one rule, select the appropriate choice from the Match drop-down list.
  5. Now define each individual rule by selecting the appropriate choice from each list.
  6. When you have completed defining the filter rules, enter a name for the filter in the Save filter as field, and then click Save.
The new filter appears in the User Filters drop-down list.

Deleting a Filter

In views that enable you to define a filter, you also can switch from one filter to another, or you can delete the filter permanently.

To delete a filter:

  1. Identify the filter you want to delete.
  2. Make sure the name of the filter is the currently selected filter in the list of filters.
  3. Click the (X) icon to delete the filter.
The filter is removed from the list, and the next filter in the list becomes the currently selected filter. If there are no more filters in the list, None is displayed.

Searching Logs

If a view in Application Repository enables you to define a filter, you can also perform a search using the filter rules without actually saving the rules as a filter.

To search a log:

  1. Click the plus icon (+) to create a new filter. The filter rule fields appear.
  2. Click the plus icon (+) to the right of the filter rule fields to create an additional row of filter rule fields, if necessary. A new row is added, and the Match drop-down list appears. This enables you to define whether any or all the rules should be matched.
  3. If you do not need more than one rule, click the minus sign to delete the additional row; otherwise, continue adding rows as needed.
  4. If you do have more than one rule, select the appropriate choice from the Match drop-down list.
  5. Now define each individual rule by selecting the appropriate choice from each list.
  6. When you have finished defining the filter rules, click Search.
The results of the search appear.

Deleting and Purging History

The views in Application Repository that list events or activities have a Clear History or Purge History button. This enables you to delete some or all the events or activities from the log. Purging history from the Audit Log and Event Manager Log clears the messages from the log and also deletes the corresponding process app versions from the repository, reclaiming space.

The Clear History option on the Common Log tab includes options for clearing entries before a specific date, and scheduling clear history operations to recur on a regular basis.

Note: This feature is enabled only for global administrators.

For more information, see Logging Tips and Best Practices.