Versions Compared

Key

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

You can download this log_generator tool for Mac OS X right now and and use it to generate logs for 5 years.

View file
nameShakespeare.txt
View file
namelog_generator.zip

How do you use it?

  • Download both files into a folder

  • Unzip the log_generator by double clicking it

  • From the Iguana X dashboard, double click on the component created in the previous part to bring up its information

    • From the url, copy the part after component=

    • Image Removed

  • Then from the Mac OS X terminal run the following command, replacing <component> with what you copied from the url:

Code Block
./log_generator --months 60 --component <component>

...

The script will tell you the timestamp of the oldest log generated - you will need this later

...

Wait for the script to say Finished

...

The script will generate 5 years worth of logs, with 1000 messages per day each 1 kb in size. So, the command generates about 1.7 gb of log data

...

Iguana X 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 Iguana X can handle gigabytes of log and queue data!

How to use it:

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

In order to use the logging and queuing system, first we’ll need a new component.

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.

Expand
titleSTEP 3: Change your URL to go to http://localhost:7654/#log_generator
  • You will need to edit the URL of your page carefully to replace what ever you see after the # character in your URL with #log_generator in it.

  • This might look like http://localhost:7654/#log_generator depending on how your Iguana is configured. Be very careful to make sure you only have #log_generator - sometimes people make mistakes like appending #log_generator to #dashboard and so on - this will not work.

  1. Type the URL (http://localhost:7654/#log_generator) into the bar like the screenshot below:

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

Image Added
Expand
titleSTEP 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 Added
  • Click the View logs for Source link to navigate to the logs for the Source component.

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

  • Follow these steps:

Image 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.

Expand
titleSTEP 6: Now stop and start Iguana to check startup time
  • Stop and then 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 long as you need them, without a performance degradation.

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