Back to Blog

Vugen: Gracefully Handle Various HTTP Return Codes

There may be times where you want to build in logic for how your Vuser reacts to the various types of HTTP status return codes received throughout a script. For example, as web servers get overloaded, they may start sending 503 return codes. If you wanted to try and resubmit and finish out the transaction, this might be a more graceful way to handle the occasional 503 than just giving up and killing the iteration immediately. Of course, as the load continues to increase, the 503’s will become more frequent and eventually you will need to give up. Giving it a few additional tries might better reflect users who are trying to resubmit their page rather than immediately abandoning the site. The code below is one way to loop a request up to 5 times and handle various HTTP return codes differently depending on what status code is being received.

 // Declare integers

   int HTTP_rc, retry_count;

 *  This section includes the page request statement.
 *  It switches on the
 *  "continue on error" functionality just for this step.

for (retry_count = 0; retry_count < 5; retry_count++)



 // Capture the HTTP return code and store it

   HTTP_rc = web_get_int_property(HTTP_INFO_RETURN_CODE);

// Condition statement: If less than 400,
// end the transaction and carry on with rest of script

if (HTTP_rc < 400)
 lr_end_transaction("Transaction_Name", LR_PASS);
 lr_log_message("Index page displayed after %i attempts",
     retry_count +1);

 * Condition statement: if equals 503 AND retry_count is less than 4,
 * wait for 5 seconds before logging a message
 * confirming that the page
 * is not available and logging what attempt it was on.
 * NOTE: HTTP 503 = Server is busy

else if (HTTP_rc == 503 && retry_count < 4)
 lr_end_transaction("Transaction_Name", LR_STOP);
 lr_log_message("Index page not available,
     retrying attempt %i", retry_count +1);

 * Condition statement: End Transaction. If HTTP error equals 503,
 * log a message confirming that the page is not available
 * and what HTTP error you received, i.e. 404 (Page not found)
 * The last line exits the current iteration and fails this iteration

 lr_end_transaction("Transaction_Name", LR_FAIL);
 if (HTTP_rc == 503)
 lr_log_message ("Index page not available, no retry attempts left");
 lr_error_message("Index page failed, HTTP error %i received", \

There may be other reasons you might want to do other logic based on the HTTP return code. Let me know what they might be in the comments section below.

Back to Blog