Locust Directory

XML-RPC Load Testing

How to customize LoadForge tests to test XML-RPC servers


By default LoadForge tests plain HTTP/HTTPS sites. However, as you can use python for test definitions it is easy to expand beyond that.

The below example allows you to load test an XML-RPC server. It calls the get_time() function and get_random_number() function - you will of course replace these with your own requirements.


import time
from xmlrpc.client import ServerProxy, Fault

from locust import User, task

class XmlRpcClient(ServerProxy):
    XmlRpcClient is a wrapper around the standard library's ServerProxy.
    It proxies any function calls and fires the *request* event when they finish,
    so that the calls get recorded.

    def __init__(self, host, request_event):
        self._request_event = request_event

    def __getattr__(self, name):
        func = ServerProxy.__getattr__(self, name)

        def wrapper(*args, **kwargs):
            start_time = time.perf_counter()
            request_meta = {
                "request_type": "xmlrpc",
                "name": name,
                "response_length": 0,  
                "response": None,
                "context": {},  # see HttpUser if you actually want to implement contexts
                "exception": None,
                request_meta["response"] = func(*args, **kwargs)
            except Fault as e:
                request_meta["exception"] = e
            request_meta["response_time"] = (time.perf_counter() - start_time) * 1000
  **request_meta)  # This is what makes the request actually get logged
            return request_meta["response"]

        return wrapper

class XmlRpcUser(User):
    abstract = True  # dont instantiate this as an actual user 

    def __init__(self, environment):
        self.client = XmlRpcClient(,

# The real user class that will be instantiated
# This is the only thing that is actually specific to the service that we are testing.
class MyUser(XmlRpcUser):
    def get_time(self):

    def get_random_number(self):
        self.client.get_random_number(0, 100)    

This guide is part of the LoadForge Directory, an index of locustfile's for use with LoadForge website and API load tests. We also provide a wizard to generate tests, and onboarding assistance for clients. Contact us should you have any questions.

LoadForge provides load testing and stress tests for websites, APIs and servers. It uses your cloud account to rapidly scale large numbers of simulated users to load test your website, store, API, or application for cheap - just cents per test!

For more help on Tests please see our official documentation. Logged in users can also use our wizard to generate a locustfile, or you can record your browser steps.

Ready to run your test?
Start your first test within minutes.