martel/ngsi-load-tester repository overview

⁠NGSI Load Tester

This repository provides a simple Docker image that execute load test on a Orion Context Broker⁠ instance (without any authentication mechanism enabled).

The load tester is based on artillery.io⁠, an easy-to-use load testing toolkit. Should you need to customize it, is should not be too difficult ;)

⁠Image Build

To create the image from the repository, simply execute:

docker build -t martel/ngsi-load-tester .

⁠Run the Container

To run the container, simply execute:

docker run -e ART_TARGET=orion_context_broker:port martel/ngsi-load-tester

Where orion_context_broker is the ip of the Context Broker instance you want to test and port is the active port of the Context Broker.

If you want to test an Orion Context Running in a container, execute:

docker run --link container_name:orion martel/ngsi-load-tester

Where container_name is the name of the container where your context broker runs.

⁠Configurable variables

#### Example

docker run --link ngsiloadtester_orion_1:orion \
    -e ART_DEBUG='' \
    -e ART_ARRIVALRATE=10  \
    -e ART_DURATION=50 martel/ngsi-load-tester

⁠Example adopted

The NGSI Load Tester use the data model of the NGSI API Walkthrough⁠. Entities created are of the type Room and contain temperature and pressure attributes.

  "id": "Room1",
  "type": "Room",
  "temperature": {
    "value": 23,
    "type": "Float"
  },
  "pressure": {
    "value": 720,
    "type": "Integer"
  }
}```

Test the container locally
--------------------------

You can run a simple test by launching the example Orion Context Broker compose
file,  and linking to it.

From the main directory run:

```bash
docker-compose up -d
docker run --link ngsiloadtester_orion_1:orion martel/ngsi-load-tester

⁠HOW TO CONTRIBUTE

Make pull requests :)

⁠TODO

1. Better divide test in write / read / delete & read and write.
2. Provide instructions on how to export results.
3. Graph generation would be nice.
4. Explore statsd integration⁠.