What is a journey?

Journeys show producers that a user triggers while using the monitored application, listed step-by-step as they are called, with exact timestamp (when the call occurred and how much time it took).

In simple words, a journey is a translation of any user action into a developer's or app admin's language.

When do I need journeys?

Let's suppose a certain user action (login, adding to shopping cart, etc.) is taking too much time. This mean a certain class/method/service takes extra time.

A recorded journey shows how much time is spent on every triggered producer.

This info is a roadmap for further improvement and optimisation.

Record journeys

Instructions to start and finish recording journeys are right at the top of the Journeys tab.

Start recording

You may record journeys in 2 ways:

1. via Journeys tab,
2. with URL parameter (command prefix in browser's address line).

Start recording from Journeys tab:

1. Go to Journeys tab.
2. In the field near the Start button, enter the name for your new journey.
3. Click Start .

After record start, the browser will automatically load the starting page of your web application in a new tab.

Start recording with URL parameter:

1. Go to a page on your website, from which you'd like to start recording a user action (like the homepage).
2. In the address bar of your browser, add the prefix below and press Enter on your keyboard: 

?mskJourney=start&mskJourneyName=JOURNEY_NAME

JOURNEY_NAME = name for new journey.

For example:

http://yourwebsite.com/home.html?mskJourney=start&mskJourneyName=Journey1

This method is convenient because:

• you don't have to go to Journeys tab, 
• you may start recording instantly, from any place on your website. 

  Anchor
  progress progress

Recording in progress

After record start, act like a user: open a page, add items to your shopping cart, whatever.

Know status of journey recording:

1. Go to Journeys tab.
2. Refresh the page.
3. Find your current journey in the list and check the Active column:
   1. true = journey is active = journey recording is in progress,
   2. false = journey is not active = recording is over.

Finish recording

Make sure you stop recording at the right moment, otherwise you will have unneeded steps.

Finish recording from Journeys tab:

1. Go to Journeys tab.
2. Refresh the page.
3. Find your current journey and click the stop link (Active column). 

Finish recording with URL parameter:

 After last user step, in the address bar of your browser, add the prefix below and press Enter on your keyboard: 

?mskJourney=stop&mskJourneyName=JOURNEY_NAME

JOURNEY_NAME = name for your current journey.

For example:

http://yourwebsite.com/order.html?mskJourney=stop&mskJourneyName=Journey1

View recorded journeys

See all recorded journeys:

Go to Journeys tab and see the list.

Journey structure

Traced calls are URL parameters that call methods in the monitored application.

Steps are mostly Java methods, triggered by traced calls.

View traced calls and steps in a journey:

1. Go to Journeys tab.
2. See traced call: select a journey and click its name (Journey column).
3. See steps: select a traced call and click its URL link (URL column)

Traced calls

A page with traced calls displays:

• name,
• overview: 
  • name, 
  • timestamp:
    • started (C),
    • last action (LA),
  • number of calls (NC), 
  • active/non-active (A).
• call list:
  • call's number,
  • URL,
  • timestamp,
  • number of steps in the call.

Calls

A page with calls displays:

• name,
• overview: 
  • ID, 
  • timestamp,
• step list:
  • step's number,
  • call (called method),
  • gross duration (time taken by this step + all of its sub-steps),
  • net duration (time taken by this step only),
  • aborted/non-aborted.

The Aborted column displays a symbol in case an exception occurs with a step. It instantly shows the point of failure.

Expand lines in step list:

• Click the Expand button (expands all steps), or
• click the small triangle near parent steps (expands steps under one parent step) .

Duplicate calls

Journeys detect duplicate calls and display them in a structured way: in groups, with important info:

• name of the duplicate call (Duplicate column),
• how many times the call has been initiated (repeated) (Calls column),
• position (line) of the duplicate call in a call (Positions column),
• time/duration of the duplicate call (Time / Duration column).

SCREENSHOT

See the duplicate call's position:

Click a position link in the duplicate call list (Positions column)

Highlight duplicate call:

 Select the duplicate call's checkbox (column under Reset button).
Deselect the call's checkbox to remove highlighting.

Analyse

Analyse journey:

1. Go to Journeys tab.
2. Select a journey and click its  icon.

The producers, displayed in the Analyse View, are listed in the chart that has the following columns:

• ProducerId,
• Calls (number of calls that triggered/requested this producer),
• Duration (total time, spent for this producer).