Loadtest: documentation.

This commit is contained in:
aforge
2021-03-11 00:15:53 +03:00
parent d6e39c5c22
commit 307c06b1f4
3 changed files with 50 additions and 9 deletions

View File

@ -19,4 +19,47 @@ Run it with (after [installing Gatling](https://gatling.io/docs/current/installa
gatling.sh -sf . -rsf . -rd "na" -s tinode.Loadtest
```
Currently, three tests are available:
* `tinode.Loadtest`: after connecting to server, retrieves user's subscriptions, and publishes a few messages to them one by one.
* `tinode.MeLoadtest`: attempts to max out `me` topic connections.
* `tinode.SingleTopicLoadtest`: connects to and publishes messages to the specified topic (typically, a group topic).
The script supports passing params via the `JAVA_OPTS` envvar.
Parameter name | Description
-------------- | -------------
`num_sessions` | Total number of sessions to connect to the server
`ramp` | Time period in seconds over which to ramp up the load (`0` to `num_sessions`).
`publish_count` | Number of messages that a user will publish to a topic it subscribes to.
`publish_interval` | Maximum period of time a user will wait between publishing subsequent messages to a topic.
`accounts` | `tinode.Loadtest` and `tinode.SingleTopicLoadtest` only: Path to CSV file containing user accounts to use in loadtest (in format `username,password[,token]` (`token` field is optional).
`topic` | `tinode.SingleTopicLoadtest` only: topic name to send load to.
`username` | `tinode.MeLoadtest` only: user to subscribe to `me` topic.
`password` | `tinode.MeLoadtest` only: user password.
Examples:
```shell
JAVA_OPTS="-Daccounts=users.csv -Dnum_sessions=100 -Dramp=10" gatling.sh -sf . -rsf . -rd "na" -s tinode.Loadtest
```
Ramps up load to 100 sessions listed in `users.csv` file over 10 seconds.
```shell
JAVA_OPTS="-Dusername=user1 -Dpassword=user1123 -Dnum_sessions=10000 -Dramp=600" gatling.sh -sf . -rsf . -rd "na" -s tinode.MeLoadtest
```
Connects 10000 sessions to `me` topic for `user1` with password `user1123` over 600 seconds.
```shell
JAVA_OPTS="-Dtopic=grpYOrcDwORhPg -Daccounts=users.csv -Dnum_sessions=10000 -Dramp=1000 -Dpublish_count=2 -Dpublish_interval=300" gatling.sh -sf . -rsf . -rd "na" -s tinode.SingleTopicLoadtest
```
Connects 10000 users (specified in `users.csv` file) to `grpYOrcDwORhPg` topic over 1000 seconds. Each user will publish 2 messages with interval up to 300 seconds.
This will be eventually packaged into a docker container.
### Experiments
We have tested our single-server Tinode synthetic setup with 10000 accounts on a 2 CPU box.
As the load increases, before starting to drop:
* The server can easily sustain 10000 concurrently connected sessions.
* An individual group topic was able to sustain 1500 concurrent sessions.

View File

@ -58,9 +58,7 @@ class Loadtest extends TinodeBase {
}
.exec(ws("close-ws").close)
val numUsers = Integer.getInteger("num_users", 10000)
val rampPeriod = java.lang.Long.getLong("ramp", 300L)
setUp(scn.inject(rampUsers(numUsers) during (rampPeriod.seconds))).protocols(httpProtocol)
setUp(scn.inject(rampUsers(numSessions) during (rampPeriod.seconds))).protocols(httpProtocol)
}
class MeLoadtest extends TinodeBase {
@ -88,9 +86,7 @@ class MeLoadtest extends TinodeBase {
.pause(1000)
.exec(ws("close-ws").close)
val numUsers = Integer.getInteger("num_users", 10000)
val rampPeriod = java.lang.Long.getLong("ramp", 300L)
setUp(scn.inject(rampUsers(numUsers) during (rampPeriod.seconds))).protocols(httpProtocol)
setUp(scn.inject(rampUsers(numSessions) during (rampPeriod.seconds))).protocols(httpProtocol)
}
class SingleTopicLoadtest extends TinodeBase {
@ -133,7 +129,5 @@ class SingleTopicLoadtest extends TinodeBase {
}
.exec(ws("close-ws").close)
val numUsers = Integer.getInteger("num_users", 10000)
val rampPeriod = java.lang.Long.getLong("ramp", 300L)
setUp(scn.inject(rampUsers(numUsers) during (rampPeriod.seconds))).protocols(httpProtocol)
setUp(scn.inject(rampUsers(numSessions) during (rampPeriod.seconds))).protocols(httpProtocol)
}

View File

@ -21,6 +21,10 @@ class TinodeBase extends Simulation {
val publishCount = Integer.getInteger("publish_count", 10).toInt
// Maximum interval between publishing messages to a topic.
val publishInterval = Integer.getInteger("publish_interval", 100).toInt
// Total number of sessions.
val numSessions = Integer.getInteger("num_sessions", 10000)
// Ramp up period (0 to numSessions) in seconds.
val rampPeriod = java.lang.Long.getLong("ramp", 300L)
val hello = exitBlockOnFail {
exec {