Fleet Manager Log Viewer

When an instance of Iguana is added to the Dashboard the Fleet Manager backend server will copy all the Iguana server logs into the Global Log Archive. Once log files that are stored in the archive they can then be viewed in the Global Log Viewer.

The Global Log Viewer will display all logs that are stored in the archive, on a server by server basis (you cannot view the logs for multiple server at the same time). This includes logs from instances that are no longer being managed in the Fleet Manager, and Iguana instances that have been removed.

Note: If you add an Iguana instance with a large amount of historical logs then Fleet manager can take some time to load all the history. On our test machines we were able to load up to 50GB of data per hour.

Navigating the Logs [top]

  1. Click Global Logs in the menu bar:
    Fleet manager global logs
  2. There are two ways to navigate the logs:
    1. Using the four button Navigation Control:
      • First Record: The left arrow takes you to the latest record
      • Last Record: The right arrow takes you to the oldest record
      • Next Record: The Newer button takes you to the next record
      • Previous Record: The Older button takes you to the previous record
        fleet manager universal log viewer
    2. Using the scroll wheel on your mouse (or a two finger vertical trackpad gesture).
  3. Clicking once on a message will select it and make it the current message (highlighted in blue):
    current message

Viewing log details [top]

  1. Clicking twice on a log message will open the Log Detail pane.

    You can double-click any message to immediately open the Log Detail, or click again on the current message (already highlighted in blue).

  2. In the Log Detail pane you can:
    • View the whole message — useful when only part of it is showing in the log view.
    • View the related messages in the left pane of the Log Detail.
      log detail pane
  3. Click the New Tab button at the top right to open the log message in a new tab:

    This can be useful if you want to view a very large message, or if you want to open several messages at the same time.

    open message in new tab

Searching and Filtering [top]

  1. Choose the server and channel(s) to view logs from:
    • Select the Server from the drop-down list in the Server/Channel(s): box at the top left:
      select server
    • Select the channel(s) from the second drop-down list:
      select channel
  2. Searching the logs:

    The search field supports plain text and REGEX filtering. Plain text is not case sensitive recognizes common dictionary words like “paul”, “east” but not more unusual words like “radiology” or “east_radiology”. REGEX search however is case sensitive will find “RADIOLOGY” or “EAST_RADIOLOGY”, or any other string you specify.

    Note: The search is within your filtered result (see filtering below). In this search we were not interested in unqueued/resubmitted messages, or ACKs so we filtered for messages only.

    filter for messages only

    • Enter word like “East” or “paul” in the search bar at the top of the screen and press find (or wait a few seconds):
      search bar
    • The number of results found is shown on the right, and you can use the arrows to navigate through the results:
      search result
    • If you cannot find a word like “radiology” or string “east_radiology” then you can try REGEX (remember that REGEX is case sensitive):regex search
  3. Filtering the logs:

    In the Filter Logs panel on the bottom left you can choose various ways to filter the logs. The log filtering works in a very similar way to the Iguana log filtering.

    • Keyword(s): This field supports plain text and REGEX filtering (the same as the search field)
    • Time Range: Choose a date/time range to view logs for
    • Show Log Types: Choose which log what types to view
    • This example shows a filter for “east” + messages:

      We intentionally used the same criteria as the text search above — notice how the filter also produces 13 results (the same as the search).

      filter result

    • And when we add a date range filter the number of records found is reduced to 11:
      filter result

Exporting logs [top]

  1. Click twice on a log message to open the Log Detail pane.
  2. You can export the single message using the Download button at the bottom of the pane:
    download log
  3. Choose the export format from the droplist, and click Download:
    download log button

Leave A Comment?