Skip to content

Commit

Permalink
Merge branch 'main' into args-parsing-fixups
Browse files Browse the repository at this point in the history
  • Loading branch information
bpkroth authored Feb 28, 2025
2 parents 989ab86 + ab0ad91 commit 3b01931
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 0 deletions.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -198,6 +198,7 @@ See [mlos_bench/config](./mlos_bench/mlos_bench/config/) and [CONTRIBUTING.md](.

### Publications

- [TUNA: Tuning Unstable and Noisy Cloud Applications](http://aka.ms/mlos/tuna-eurosys-paper) at [EuroSys 2025](https://2025.eurosys.org/accepted-papers.html)
- [MLOS in Action: Bridging the Gap Between Experimentation and Auto-Tuning in the Cloud](https://www.vldb.org/pvldb/vol17/p4269-kroth.pdf) at [VLDB 2024](https://www.vldb.org/2024/?papers-demo)
- [Towards Building Autonomous Data Services on Azure](https://dl.acm.org/doi/abs/10.1145/3555041.3589674) in [SIGMOD Companion 2023](https://dl.acm.org/doi/proceedings/10.1145/3555041)
- [LlamaTune: Sample-efficient DBMS configuration tuning](https://www.microsoft.com/en-us/research/publication/llamatune-sample-efficient-dbms-configuration-tuning) at [VLDB 2022](https://vldb.org/pvldb/volumes/15/)
Expand Down
6 changes: 6 additions & 0 deletions mlos_bench/mlos_bench/config/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ In general the `config` directory layout follows that of the `mlos_bench` module

Full end-to-end examples are provided in the [`cli`](./cli/) directory, and typically and make use of the root [`CompositeEnvironments`](./environments/root/) to combine multiple [`Environments`](./environments/), also referencing [`Services`](./services/), [`Storage`](./storage/), and [`Optimizer`](./optimizers/) configs, into a single [`mlos_bench`](../run.py) run.

## See Also

- [`mlos_bench.config`](https://microsoft.github.io/MLOS/autoapi/mlos_bench/config/index.html) module documentation online for detailed description and additional links to other components and their configuration examples.

## Config parameters

An `Environment` configuration can have two sections, `const_args` and `tunable_params`.
Expand Down Expand Up @@ -44,6 +48,8 @@ The [`schemas`](./schemas/) directory contains the [`jsonschema`](https://json-s

For instance including a `"$schema"` attribute at the top of your `json` config file will enable `json` validation and auto-complete in many editors (e.g. [VSCode](https://code.visualstudio.com/)):

Alternatively, you can simply name the file `*.mlos.json` or `*.mlos.jsonc` and the schema will be automatically applied using an [extension](https://marketplace.visualstudio.com/items?itemName=remcohaszing.schemastore) to resolve the rules from \<https://www.schemastore.org/json/

```jsonc
{
"$schema": "https://raw.githubusercontent.com/microsoft/MLOS/main/mlos_bench/mlos_bench/config/schemas/environments/environment-schema.json",
Expand Down

0 comments on commit 3b01931

Please sign in to comment.