{"id":20111523,"url":"https://github.com/openstack/tempest-stress","last_synced_at":"2025-05-06T11:30:46.651Z","repository":{"id":66174869,"uuid":"118363784","full_name":"openstack/tempest-stress","owner":"openstack","description":"Stress Testing of existing cloud using Tempest. Mirror of code maintained at opendev.org.","archived":false,"fork":false,"pushed_at":"2024-05-17T17:42:14.000Z","size":86,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-05-17T18:50:37.903Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://opendev.org/openstack/tempest-stress","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openstack.png","metadata":{"files":{"readme":"README.rst","changelog":"ChangeLog","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-21T18:54:07.000Z","updated_at":"2024-05-17T17:42:18.000Z","dependencies_parsed_at":"2024-01-04T14:42:33.690Z","dependency_job_id":"3ec3b7c8-6657-49ee-907b-9383ab5fbc94","html_url":"https://github.com/openstack/tempest-stress","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Ftempest-stress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Ftempest-stress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Ftempest-stress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Ftempest-stress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openstack","download_url":"https://codeload.github.com/openstack/tempest-stress/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224499851,"owners_count":17321605,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T18:16:25.140Z","updated_at":"2024-11-13T18:16:25.663Z","avatar_url":"https://github.com/openstack.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. _stress_field_guide:\n\nTempest Field Guide to Stress Tests\n===================================\n\nOpenStack is a distributed, asynchronous system that is prone to race condition\nbugs. These bugs will not be easily found during\nfunctional testing but will be encountered by users in large deployments in a\nway that is hard to debug. The stress test tries to cause these bugs to happen\nin a more controlled environment.\n\nStress tests are designed to stress an OpenStack environment by running a high\nworkload against it and seeing what breaks. The stress test framework runs\nseveral test jobs in parallel and can run any existing test in Tempest as a\nstress job.\n\nEnvironment\n-----------\nThis particular framework assumes your working Nova cluster understands Nova\nAPI 2.0. The stress tests can read the logs from the cluster. To enable this\nyou have to provide the hostname to call 'nova-manage' and\nthe private key and user name for ssh to the cluster in the\n[stress] section of tempest.conf. You also need to provide the\nlocation of the log files:\n\n    - target_logfiles = \"regexp to all log files to be checked for errors\"\n    - target_private_key_path = \"private ssh key for controller and log file nodes\"\n    - target_ssh_user = \"username for controller and log file nodes\"\n    - target_controller = \"hostname or ip of controller node (for nova-manage)\n    - log_check_interval = \"time between checking logs for errors (default 60s)\"\n\nTo activate logging on your console please make sure that you activate `use_stderr`\nin tempest.conf or use the default `logging.conf.sample` file.\n\nRunning default stress test set\n-------------------------------\n\nInstallation\n------------\n#. You first need to clone this repo.::\n\n    $ git clone https://github.com/openstack/tempest-stress\n    $ cd  tempest_stress\n\n#. Install::\n\n    $ python setup.py install\n\n#. Install `Tempest`_\n\n.. _Tempest: http://docs.openstack.org/developer/tempest/overview.html#quickstart\n\n\nConfiguration\n*************\n\nTo Run stress tests, two configuration files are needed:\n\n1. tempest.conf - As per Tempest configuration guidelines here: `configuration`_\n\n2. stress_tests.conf - same location as tempest.conf\n\nlater one is being used to define all config options specific to stress tests.\n\n.. _configuration: http://docs.openstack.org/developer/tempest/configuration.html#tempest-configuration\n\n\nRun\n***\n\nRun all tests::\n\n    $ run-tempest-stress -a -d 30\n\nRun specific test::\n\n    $ run-tempest-stress -t ./tempest_stress/etc/server-create-destroy-test.json -d 30\n\nThis sample test tries to create a few VMs and kill a few VMs.\n\nFor more information please refer run-tempest-stress CLI help::\n\n    $ run-tempest-stress -h\n\nAdditional Tools\n----------------\n\nSometimes the tests don't finish, or there are failures. In these\ncases, you may want to clean out the nova cluster. We have provided\nsome scripts to do this in the ``tools`` subdirectory.\nYou can use the following script to destroy any keypairs,\nfloating ips, and servers:\n\ntempest_stress/tools/cleanup.py\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenstack%2Ftempest-stress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenstack%2Ftempest-stress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenstack%2Ftempest-stress/lists"}