Download the PHP package ezsystems/profiler-bundle without Composer
On this page you can find all versions of the php package ezsystems/profiler-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package profiler-bundle
Profiler Bundle
Bundle to profile eZ Platform installations and setup scenarios to be able to continuously test to keep track of performance regressions of repository and underlying storage engines(s)
This bundle contains two means of profiling your eZ Publish stack.
-
API Profiler
The API profiler executes tests against the Public API or directly against the SPI. It is capable of executing different scenarios.
-
jMeter Tests
The jMeter tests run tests against the HTTP frontend. Currently just a random browser is implement. This is most useful together with some profiling done in the background to detect the actual bottlenecks.
API Profiler
Warning
Running the performance tests / profiling will chnage the contents of your
database. Use with care.
Usage
Install the bundle inside of an existing ez-platform installation::
composer.phar require ezsystems/profiler-bundle dev-master
Enable Bundle in kernel by adding:
Then you can run the performance tests using::
php app/console profiler:run papi vendor/ezsystems/profiler-bundle/docs/profile_example.php
The provided file specifies the performance test you want to run. The file
mentioned here is an example file provided with the bundle. You can run the
tests either against the Public API (papi
) or directly against the SPI
(spi
).
Configuration
To model different scenarios then the on provided in the example file is a little more complex.
Types
First we define multiple content types. The content type definitions are simpler then in the APIs to test, but are mapped accordingly::
First we define the name of the type and then its fields. Each field should have a data provider assigned, which provides random test data.
Optionally we can define multiple languages in which content will be created. Also optionally an average number of versions can be defined to "age" content. You can define as many types as sensible.
Actors
Actors actually do something with the defined types. There are currently three different actors, but you could define more:
-
Actor\Create
Creates content structures. You can stack multiple
Create
actors to create deep content structures::This example will create a structure of folder types, which, in the end, will contain articles, which will contain comments. The specified numbers are the average number of children which are created.
You may optionally specify an object store, if you want to reference some of the created content objects in a different actor, like the next one.
-
Actor\SubtreeView
This actors simulates an eZ Platform view operation of a content object by executing similar queries to the content repository::
You should provide the actor with an object store so it can pick from a number of existing content objects which would be viewed by users of an application.
-
Actor\Search
This actor just executes a search. Searches are specified as in the Public API or the SPI using a common
Query
object.
Execution
Finally we want to execute our configured scenario consisting of types and actors. For this an executor is used::
The executor will be provided with an array of Constraint
objects each
associated with a task. In this case Constraint\Ratio
objects are used,
which will only execute a task according to the given probability.
The Aborter defines when the execution will be halted. It could also check for
the amount of create content objects or just abort after a given time span. The
Count
aborter just aborts after the given number of iterations.
You might, like done in the example, define multiple executors which then will be executed subsequently.
jMeter Tests
Usage
The jMeter test can be run by just executing ant
in the root directory. In
the first run jMeter will be downloaded. In subsequent runs the already
downloaded files will be used. Ant 1.8 is required to run the example.
The test hits the configured host and will create files providing you with statistics about the run:
-
build/result.jtl
jMeter log file for further analysis
-
build/result.csv
Simple grouping of response times by URL
Configuration
You can configure the run by creating a file jmeter.properties.local
to
overwrite the variables in the jmeter.properties
file. You definitely want
to adapt the jmeter.server
in there to point to the website you want to put
under test. All options are documented in the jmeter.properties
file.
The implemented "Random Browser" only executes GET
requests accessing
random links starting at the configured start page. It will not log in or
submit any forms (searches).
There are two options defining the behaviour of the random surfer:
-
crawler.usertype.a.breadth
On average, how many links are clicked on the same page. Causes the user to click more links on the start page and the subsequent pages. (Default: 2)
-
crawler.usertype.a.depth
On average, how deep a user will click through the website. Causes the user to follow links deeper into the website structure. (Default: 3)
Another important configuration is the jmeter.users
value. It defines how
many users will access / surf the website in parallel. The default of 5 means
that 5 users will simultaneously surf on the website. With the configured
timings that means something between 1 Req/s and 2 Req/s.
All versions of profiler-bundle with dependencies
ezsystems/ezpublish-kernel Version ~5.3.5@dev || ~5.4.2@dev || ^6.0@dev
fzaninotto/faker Version ~1.4
jdorn/sql-formatter Version ~1.2