-
Notifications
You must be signed in to change notification settings - Fork 189
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feature flags; 'show performance latency'; up cli
* revise/improve `ais show performance latency` * add metrics * add docs/feature-flags Signed-off-by: Alex Aizman <[email protected]>
- Loading branch information
1 parent
c3bfd04
commit e9e9cdd
Showing
6 changed files
with
115 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,81 @@ | ||
| --- | ||
| layout: post | ||
| title: FEATURE FLAGS | ||
| permalink: /docs/feature-flags | ||
| redirect_from: | ||
| - /feature_flags.md/ | ||
| - /docs/feature_flags.md/ | ||
| --- | ||
|
|
||
| ## Feature Flags | ||
|
|
||
| `Feature flags` is a 64-bit (bit-wise) field in aistore cluster configuration denoting assorted (named) capabilities that can be individually enabled at runtime. | ||
|
|
||
| The features themselves are enumerated below. By default, all features are disabled, and the corresponding 64-bit field is set to zero. | ||
|
|
||
| ## How to see, how to view, how to change | ||
|
|
||
| ```console | ||
| $ ais config cluster features <TAB-TAB> | ||
|
|
||
| Enforce-IntraCluster-Access Provide-S3-API-via-Root Dont-Allow-Passing-FQN-to-ETL none | ||
| Do-not-HEAD-Remote-Bucket Fsync-PUT Ignore-LimitedCoexistence-Conflicts | ||
| Skip-Loading-VersionChecksum-MD LZ4-Block-1MB Dont-Rm-via-Validate-Warm-GET | ||
| Do-not-Auto-Detect-FileShare LZ4-Frame-Checksum Disable-Fast-Cold-GET | ||
| ``` | ||
|
|
||
| For example: | ||
|
|
||
| ```console | ||
| $ ais config cluster features Provide-S3-API-via-Root Dont-Rm-via-Validate-Warm-GET Ignore-LimitedCoexistence-Conflicts | ||
| PROPERTY VALUE | ||
| features Provide-S3-API-via-Root,Ignore-LimitedCoexistence-Conflicts,Dont-Rm-via-Validate-Warm-GET | ||
|
|
||
| Cluster config updated | ||
| ``` | ||
|
|
||
| > **Tip**: to select multiple features, type the first letter (or the few first letters) of the one you select, press `<TAB-TAB>` to complete, and then press `<TAB-TAB>` again to keep going, if need be. | ||
| To view the current (configured) setting, type the same command and hit `Enter`: | ||
|
|
||
| ```console | ||
| $ ais config cluster features | ||
| PROPERTY VALUE | ||
| features Provide-S3-API-via-Root,Ignore-LimitedCoexistence-Conflicts,Dont-Rm-via-Validate-Warm-GET | ||
| ``` | ||
|
|
||
| The same in JSON: | ||
|
|
||
| ```console | ||
| $ ais config cluster features --json | ||
| { | ||
| "features": "1552" | ||
| } | ||
| ``` | ||
|
|
||
| Finally, to reset feature flags back to the system defaults, `<TAB-TAB>` to select `none` from the completion list, or simply run: | ||
|
|
||
| ```console | ||
| $ ais config cluster features none | ||
|
|
||
| PROPERTY VALUE | ||
| features none | ||
|
|
||
| Cluster config updated | ||
| ``` | ||
|
|
||
| ## Names and comments | ||
|
|
||
| | name | comment | | ||
| | ---- | ------- | | ||
| | `Enforce-IntraCluster-Access` | when enabled, aistore targets will make sure _not_ to execute direct (ie., not redirected) API calls | | ||
| | `Provide-S3-API-via-Root` | handle S3 requests via `aistore-hostname/` (whereby the default: `aistore-hostname/s3`) | | ||
| | `Dont-Allow-Passing-FQN-to-ETL` | do not allow passing fully-qualified name of a locally stored object to (local) ETL containers | | ||
| | `Fsync-PUT` | PUT and cold-GET: commit (or sync) the object payload to stable storage | | ||
| | `Ignore-LimitedCoexistence-Conflicts` | run in presence of "limited coexistence" type conflicts | | ||
| | `Skip-Loading-VersionChecksum-MD` | skip loading existing object's metadata, Version and Checksum (VC) in particular | | ||
| | `LZ4-Block-1MB` | .tar.lz4 format, lz4 compression: maximum uncompressed block size=1MB (default: 256K) | | ||
| | `LZ4-Frame-Checksum` | checksum lz4 frames | | ||
| | `Dont-Rm-via-Validate-Warm-GET` | when version validation (`versioning.validate_warm_get`) is enabled GET(object) shall _not_ delete the object if its remote source doesn't exist | | ||
| | `Do-not-Auto-Detect-FileShare` | do not auto-detect file share (NFS, SMB) when _promoting_ shared files to AIS | | ||
| | `Disable-Fast-Cold-GET` | use regular datapath to execute cold-GET operations | |