Advanced Log Usage

Deleted Channels

From the Iguana logs screen, you can view all log messages that have been generated for deleted channels. You can also use Iguana’s log export feature to view all log messages generated for a specific channel.

You must be a member of the Administrators Role to access messages that have been generated for deleted channels, see Roles for more information.

To view the log messages that have been generated for a specific deleted channel:

  1. Export the log messages as a CSV file, following the steps outlined in Exporting the Logs.
  2. Open the CSV file and search for rows that have (deleted) in the first column. These rows represent log messages for deleted channels.

For example, the messages with HTTP Receiver (deleted) in the first column are from a deleted channel HTTP Receiver.

Viewing archived messages [top]

If you have archived old log files in a directory other than the log directory that your Iguana server is using, you can use Iguana to browse these archived log files. The steps to follow depend on whether your archived files are on a server on which Iguana is running.

Note: to protect log integrity we strongly recommend using a non-production Iguana server to browse archived logs. This is because the changed (archive) log directory will be used for log writes, so all log entries made while browsing archives will be lost. If you decide to use a production server you must ensure that it cannot process any live data during this period.

If your archived log files are on a server on which Iguana is running, you can configure Iguana to view them:

  1. Stop Iguana.
  2. Use a text editor to edit the Iguana configuration file, IguanaConfiguration.xml.
    Note: By default, this file is located in the Iguana install directory. If this file is not located in this directory, see Set the Configuration File Directory.
  3. In IguanaConfiguration.xml, locate the log_directory value in the <log_config> section and replace it with the directory that contains your archived log files.
    <log_config
          log_purge_time_hour="0"
          log_purge_time_minute="0"
          log_directory="C:/Program Files/iNTERFACEWARE/Iguana/logs/"
          max_log_age_days="60"
          log_sync_type="off"/>
  4. Save IguanaConfiguration.xml.
  5. Restart Iguana.
  6. Log into Iguana, and view the log messages.

If Iguana is not installed on the server on which your archived log files are stored, you have two options:

  • Install Iguana on this server, then configure to view the logs as above
  • Copy the log files to a server where Iguana is installed, then configure as above

Tip: If you are using the Windows installer you can specify the log directory during the install process.

Selecting which Source Channels of a ‘From Channel’ Source Component to display [top]

If your channel has a From Channel source component that specifies multiple source channels, you can select which source messages display.

To select the source channels of a From Channel source component to display:

  1. Click the Logs tab.
  2. In the Search Criteria panel at the right, select a channel from the Channel list box, whose From Channel source component specifies multiple sources.
  3. Select one or more channels from the Source Channels list box:
  4. Select Messages from the Type list box, the messages  from the selected source channel(s) are displayed:
  5. Each message displayed on this screen includes one of the following buttons:
    • PROCESSED: which indicates that the message has been processed by the channel.
    • PENDING: which indicates that the message is contained in the message queue and is waiting to be processed.

For more details on the PROCESSED and PENDING buttons, and how you can use them to reprocess or skip messages, see Repositioning A Channel To Process A Specified Message.

Note: If you get a screen with No matching entries like this, simply select a source channel to display messages:

Displaying The Last Message Processed By A Channel [top]

You can position the logs to display the Last Processed Message for a channel, which is also known as the Source Position of the channel. This is useful if there is a long list of log messages, or when a channel is running.

Note: For more information on the source position of a channel, and on how messages are queued, see Understanding the Queue.

To display the last processed message:

  1. Select a channel from the Channel list box, In the Search Criteria panel of the Logs screen.
  2. Click the  Last Processed Message link:
  3. For channels with a From Channel source component, you must select a source channel before you can go to a source position:

    Note: The reason for this is that a channel with From Channel as its source component has multiple source positions, one for each source channel, see Understanding the Queue for more information.
  4. The Last Processed Message will be displayed:

    Note: If you specify a source channel, then only messages from the source channel are shown.

Viewing Queued Messages [top]

  1. Click the Last Processed Message link to display the last message processed by the Channel
  2. For channels with a From Channel source component, you must select a source channel before you can go to a source position:

    Note: The reason for this is that a channel with From Channel as its source component has multiple source positions, one for each source channel, see Understanding the Queue for more information.
  3. The Last Processed Message will be displayed:

    Note: If you specify a source channel, then only messages from the source channel are shown.
  4. Scroll up to view the queued (pending) messages:
  5. You can also view pending messages by clicking a link in the Queued column of the Dashboard:

    Note: If the channel you choose has a source component of From Channel, then by default the queued messages from the it’s first source are displayed.

    You can change the source in the Search Criteria panel, see Selecting which Source Channels of a ‘From Channel’ Source Component to display.

Leave A Comment?