{"id":18513188,"url":"https://github.com/vmware/weathervane","last_synced_at":"2025-04-04T11:16:12.253Z","repository":{"id":20022716,"uuid":"85119966","full_name":"vmware/weathervane","owner":"vmware","description":"Virtual-Infrastructure and Cloud Performance Benchmark","archived":false,"fork":false,"pushed_at":"2024-12-20T15:38:46.000Z","size":67173,"stargazers_count":156,"open_issues_count":1,"forks_count":39,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-28T10:09:58.736Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vmware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-15T20:54:26.000Z","updated_at":"2025-01-17T18:16:43.000Z","dependencies_parsed_at":"2023-01-12T02:46:07.803Z","dependency_job_id":"dbb138ec-e695-44e8-a53f-af6433a0f3d8","html_url":"https://github.com/vmware/weathervane","commit_stats":{"total_commits":1758,"total_committers":9,"mean_commits":"195.33333333333334","dds":0.08646188850967007,"last_synced_commit":"1c127b40d78c9de88fc4167afcccc7dabe3905ae"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware%2Fweathervane","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware%2Fweathervane/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware%2Fweathervane/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware%2Fweathervane/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vmware","download_url":"https://codeload.github.com/vmware/weathervane/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247166169,"owners_count":20894654,"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-06T15:36:47.696Z","updated_at":"2025-04-04T11:16:12.224Z","avatar_url":"https://github.com/vmware.png","language":"Java","readme":"![Weathervane](doc/images/VMW-Weathervane-Logo-SML.png)\n\n## Overview\n\nWeathervane 2.1 is an application-level performance benchmark which lets you\ninvestigate the performance characteristics of on-premise and cloud-based\nKubernetes clusters.\n\nWeathervane tests the performance capabilities of a Kubernetes cluster by\ndeploying one or more applications on the cluster and then driving a load\nagainst those applications.  The load is generated by the Weathervane workload\ndriver, which also runs on a Kubernetes cluster. Weathervane can be configured\nto generate a steady load using a fixed number of simulated users, or to\nautomatically vary the number of users to find the maximum number that can be\nsupported on the cluster without violating quality-of-service (QoS)\nrequirements.\n\n![A Weathervane Deployment](doc/images/wv2Deployment.png)\n\nWhen using a fixed load, Weathervane will give a pass/fail result which\nindicates whether the run completed without violating the QoS requirements.\nWhen using the maximum finding feature, the result will be the largest number of\nsimulated users that could interact with the applications without violating the\nQoS requirements.  This number is referred to as the peak WvUsers.\n\nThe application used by Weathervane is a multi-tier web application which\nincludes both stateless and stateful services. You can select from multiple\npre-tuned and tested configurations of this application.  The configurations\nrepresent a range of deployment sizes. This allows you to select a configuration\nbased on the size of the cluster under test, or based on the expected usage of\nthe cluster.  Weathervane 2.1 includes multiple configuration sizes, and additional\nconfigurations may be included in future releases.\n\n## Warning\n\nYou should exercise caution and good judgment about where you deploy\nWeathervane.  Weathervane can place a significant load on system resources that\ncan impact the performance of unrelated workloads.  As a result Weathervane is\nnot intended to be used in active production environments.\n\n## Weathervane 2.1 vs 2.0\n\nUsers should not directly compare Weathervane 2.1 results to Weathervane 2.0 results due to some changes that alter performance.\n\nWeathervane 2.1 changes include the use of pod affinity, enhanced workload driver\ninter-node communication, improvements to data loading, and a number of other smaller updates and fixes.\n\n## Previous Versions\n\nWeathervane 1.x is still available on the \n[1.x branch](https://github.com/vmware/weathervane/tree/1.x).\n\n## Getting Started\n\nYou can get started with Weathervane 2.1 by following the instructions in the \n[Quick Start Guide](doc/userDocs/usersGuide.md#quickstart-guide).\n\n## Documentation\n\nThe [Weathervane User's Guide](doc/userDocs/usersGuide.md) covers all aspects\nof setting up, deploying, and running the Weathervane benchmark.\n\n## Communicating about Weathervane\n\nThe Weathervane project team can be contacted in the following ways:\n\n- [Slack](https://vmwarecode.slack.com/messages/weathervane): This is the\n  primary community channel. If you don't have an @vmware.com or @emc.com email,\n  please sign up at https://code.vmware.com/web/code/join to get a Slack invite.\n\nFeel free to contact us with questions or comments.  \n\nWe also encourage the use of Issues in the GitHub repository for any questions\nor suggestions that may be of general interest.  We may move discussion of\nquestions or issues from Slack to a GitHub Issue if we feel that the question or\nanswer may be of more general interest.  Before creating an Issue, please read\n[ISSUES.md](ISSUES.md).\n\n## Issues\n\nThe Weathervane project encourages liberal use of Issues for bugs, feature\nrequests, documentation shortcoming, or general questions.  Please read the\nissue guideline in [ISSUES.md](ISSUES.md) before filing an Issue.  Be sure to\nfollow the guidelines regarding issue labels to ensure a prompt response.\n\n## Releases \u0026 Major Branches\n\nThe branching and release strategy for Weathervane is discussed in\n[BRANCHING.md](BRANCHING.md).\n\n## Contributing\n\nThe Weathervane project team welcomes contributions from the community. Before\nyou start working with Weathervane, please read our [Developer Certificate of\nOrigin](https://cla.vmware.com/dco). All contributions to this repository must\nbe signed as described on that page. Your signature certifies that you wrote the\npatch or have the right to pass it on as an open-source patch. For more detailed\ninformation, refer to [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nWeathervane is available under the the [BSD 2-clause License](LICENSE.txt).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmware%2Fweathervane","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvmware%2Fweathervane","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmware%2Fweathervane/lists"}