Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Iguana X IguanaX has a log generator tool built into it which will import and replicate a lot of log data by using the works of Shakespeare. (yes we know you didn’t buy Iguana for Shakespeare but it makes more interesting reading than HL7 or hex data.)

It’s a useful tool to demonstrate how IguanaX can handle gigabytes of log and queue data!

How

...

to use it:

Expand
titleSTEP 1: From the dashboard of IguanaX, click on + Component

In order to use the logging and

...

queuing system, first we’ll need a new component.

...

Expand
titleFrom the dashboard of Iguana X, click on +Component
Image Removed

Image Added

Expand
titleSTEP 2: In Add Components create a Custom component call Source
  • In the Add Components dialog that pops up, select Custom

  • Change the name of the component to Source

  • Click Add in the bottom right of the dialog.

  • You should see a new component appear in the dashboard.

You will need to edit the URL of your page carefully to have the #log_generator in it.

This might look like
Expand
titleSTEP 3: Change your URL to go to have http://localhost:7654/#log_generator at the end of it
depending on how your Iguana is configured.

In Chrome this looks like:

Image Removed

In Safari it might look different:

Image Removed
  • ) into the bar like the screenshot below:

Image Added
  • Press Return and a page like the screenshot below should appear!

Image Added
Expand
titleGenerate the logsSTEP 4: Generate 60 months of logs for your component
  • On this new page, use the dropdown to select the Source component created in the earlier part

  • Also change the number of months of logs to generate to 60:

Image Added
  • Note that we are generating approximately 2GB worth of logs for this exercise.

  • Click Run and wait for the log generation to finish

    • When finished, the output looks like this:

      Image Removed
Expand
titleGo to the logs section and select your component
This screen shot shows how Image Added
  • Click the View logs for Source link to navigate to the logs

and view the data you have generated.Image Removed
  • for the Source component.

Expand
titleSTEP 5: Now search for the magic string"magicString" and try log browser features to check performance
  • Copy: magicString

  • Follow these steps:

Image RemovedImage Added
  • The logs displayed will jump to the first result and highlight the match, and the search will continue to run and find more results which is what the white expanding region in the control bar is about.

The progress of the search can be seen in two places:

  • Below the search field where it shows how far back in time the search has gone.

  • The up and down arrows show how many hits the search got and can navigate to the next and previous result.

  • The scroll bar on the right will fill up with white as an indication of how far along the search is

The previous and next arrows to the right of the search field can be used to jump between results:

Image Removed
  • .

Go to the dashboard
Expand
titleSTEP 6: Now stop and start Iguana
to check startup time
stop and start Iguana
  • start iguana and see how quickly it starts up.

  • Iguana will start quickly even though you have a lot of log data. We’ve engineered Iguana to handle logs for as

log
  • long as you need them, without a performance degradation.

Log resubmission

Often when a new system is brought into an existing integration the messages for the last few months or years are replayed to bring the system up to speed. Iguana X provides a solution for this in the form of log resubmission.

Expand
titleSTEP 1 : Add a destination component

From the previous parts, we have a component set up with 5 years of log data. In order to try this out, we will need another component.

  • From Iguana X’s dashboard, click + Component

  • In the Add Components dialog that pops up, select Custom, which should be the first option

    • It is recommended to change the name of the component. This guide proceeds assuming you renamed it Destination

  • Then click Add in the bottom right of the dialog

  • You should see a new component appear on the dashboard

Image Removed

Expand
titleSTEP 2 : Link the components together

Now we will need to link the two components together so that messages can be pushed from one component to another . Assuming Source is the component with the logs and Destination is the component created above, do this by:

  • From Iguana X’s dashboard, click Edit Connections

  • First click Source, then click Destination

  • A link should appear connecting the two, with the arrow on the link pointing from Source to Destination

  • Click on Edit Connections again to exit this mode

Image Removed

Expand
titleSTEP 3 : Reposition the queue

Now that the components are linked, we can reposition the queue.

  • From Iguana X’s dashboard, double click on Source to bring up the component card

  • In the Queue Position row click reposition

    • Image Removed
  • Use the date picker to go back in time 5 years

    • An Error can appear:

      Image Removed

      Fix: If you see that, then just increment the day by 1 until the error is gone.

  • Once you have a valid start reposition time, click reposition to reposition the queue

    • Image Removed
  • Exit out of the reposition dialog and then exit out of the component card. This can take a few seconds.

...

titleSTEP 4: Turn on the Destination Component to begin the reposition
  • For Destination the QUE column on the dashboard should read some large number of days depending on how far back the queue was repositioned

  • Going to the Logs tab and selecting Destination as the component, you should see a log message showing that a new queue position was accepted

    • Image Removed
  • Going back to the dashboard and running the Destination component by toggling the switch, the component will begin to process messages from its queue and the QUE value will start to decrease

    • Image Removed

...

titleNow see if you can understand from the Logs screen how to resubmit a specific message

...

Let's test transferring logs to another component, please continue to our next page Reposition the queue to replay messages.