Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WBRIDGE and version 7.2.0

...

The logged information is categorized as follows:

LogTechnical NameDescription
Standard LogbridgeserverContains logging information logged by the Bridge process that is running the selected xUML service.
Transaction LogtransactionContains transactional logging information logged by the Bridge process that is running the selected xUML service. The logged information is usable for performance measurements or statistical evaluations (how often has the transaction been called, in which context, etc.).
Start LogstartContains information about the selected xUML service, environment variables, and errors logged by the Bridge process at startup.
Stop LogstopContains information about the selected xUML service and errors logged by the Bridge process when stopping it.
A stop log is available, if the service could not be stopped regularly but if errors occurred upon stopping, or if the service had to be killed.
Custom Logs<your name>
Multiexcerpt
MultiExcerptNamecustom_logs

The Bridge can also display custom logfiles. To be able to access this custom logfiles via the Bridge they must meet the following conditions:

  • They must be saved to the /logs folder of the service data directory.

  • Their names must follow this scheme:

    • <custom name part>.log that do not rotate

    • <custom name part>_yyyy-mm-dd.log for logs that rotate per day

    • <custom name part>_yyyy-mm-dd-hh.log for logs that rotate per hour

  • The custom name part of the logfile must not contain underscores and must not be one of the reserved log types mentioned in this table.

Filtering the Log Entries

Logs may contain big amounts of data and in these cases it may be difficult to find the peace of information you are looking for. Therefore, you can filter the logfile entries by log level, date/time and a regular expression.

Filter ElementDescriptionDefault
Search for

Insert a string or a valid regular expression to search the log entries for. Only log entries that match the expression will be displayed.
Refer to Java Regular Expressions for more information on which regular expressions you can use here.

Pressing Enter in this field triggers the search.
Multiexcerpt include
MultiExcerptNamels_search_for
PageWithExcerptINTERNAL:_bridge_excerpts
empty
in type

Select the type of logfile you want to display: bridgeserver, start, stop, transaction, custom log types. See top of this page for more information on the log types.

The log types are displayed in this list in alphabetical order and the first log type of this list will be the default. So, if you added a custom log named aa.log, this log will be displayed on going to the Logging page.
first available log type
with log levelSelect the log level of the log entries you want to inspect. Refer to Log Levels of an xUML Service for more information on log levels and what information they contain.
This filter is
only
available for the xUML service standard log (bridgeserver) and the transaction log.Debug
from

Select the date/time range you want to inspect.

  • From is set to now - 10 minutes upon opening the logging tab.
  • An empty to field displays all log entries from the from date/time until the most recent entries.
    An empty from field triggers a search backwards until the first entries are found.
  • Multiexcerpt include
    MultiExcerptNamedate_search
    PageWithExcerptINTERNAL:_bridge_excerpts
    You can remove the time part of the to field to search until the end of the day, and of the from field to search from the beginning of the day.

    Pressing Enter in these fields triggers the search.
    To enter the dates, you can use a date picker next to the input fields: Image Modified. Refer to section The Date Picker for more information on this.

    actual timestamp - 10 mintoempty

    Click View to update the displayed logging information.
    As per default, for logs with a time stamp the log entries are displayed latest first in the search results. Click the tiny arrow in the table header to change the order to oldest first.

    The date filter settings will be kept as long as your Browser tab is open. They will be reset to default as soon as you open the Logging tab in a new Browser tab.

    Note
    iconfalse

    If you close your Browser with the Logging tab open, and start your Browser again with restoring all recent tabs (session restore), your date filter settings will be reloaded from your previous search.

    The Date Picker

    When filtering the log entries of a service by date, you can use a date picker to select a date from/to. Click the date picker icon Image Removed next to the input fields to open the a tiny calendar to pick the dates from.

    Image Removed

    Some dates within the calendar are colored to help you finding the appropriate date:

    ...

    Info
    iconfalse

    The timestamp must follow one of the following patterns if you want to use this filtering feature for your custom logs:

    • YYYY-MM-DD HH:MI:SS or [YYYY-MM-DD HH:MI:SS
    • HH:MI:SS or [HH:MI:SS

    It is allowed to put the timestamp in square brackets.

    actual timestamp - 10 min
    toempty

    Multiexcerpt include
    MultiExcerptNamels_date_filter_settings
    PageWithExcerptINTERNAL:_bridge_excerpts

    The Date Picker

    Multiexcerpt include
    MultiExcerptNamedate_picker
    PageWithExcerptINTERNAL:_bridge_excerpts
    Select a day, enter a time (if necessary), and click OK to apply the selected date to the search field.

    The Search Results

    The results according to your search conditions are displayed in a paged list.

    ...

    1. You can define how many results should be displayed on one page by selecting on of 20, 50, 100, 250 and 1000 from the Show entries dropdown.
      At the bottom of the log table, you can see how many log entries have been found and how many of them are displayed: Showing 1 to 9 of 9 entries.
    2. You can auto refresh the search results by checking the Auto Refresh checkbox. Specify an interval in seconds, or leave the default (60 seconds).
    3. By clicking Download, you can download the search result (all pages) as a simple flat file that resides in a ZIP archive.
    4. Multi-line log messages are collapsed to not clutter the list of results. You can expand those multipart lines by clicking the plus sign at the end of the visible message part.
    5. Use the buttons Previous and Next to browse through the results, or select a result page by clicking on a page number.

    ...

    Click a log entry with the right mouse button to activate the context menu. Then, make your selections:

    Filter ElementDescriptionDefault
    timestampEnter a timestamp you want to analyze in more detail. As per default, this is prepopulated with the timestamp of the selected log entry.Timestamp of the selected log entry.
    time focus

    To analyze what happened around the selected time stamp, you can choose between:

    • What happened before the selected timestamp?
    • What happened after the selected timestamp?
    • What happened around the selected timestamp?
    What happened before
    time frameSet a time frame in relation to your selected focus: What happened within the specified time frame before/after/around the selected timestamp?1 second
    clear search termRemove a specified search term from the search filter for this refinement to get more search results.false
    clear log levelRemove a specified log level from the search filter for this refinement to get more search results.false