frostfs-s3-gw/docs/playback.md

FrostFS S3 Playback

Playback is a tool to reproduce queries to frostfs-s3-gw in dev environment. Network logs could be gathered from s3-gw via HTTP Logger which could be enabled on build with loghttp build tag and http_logging.enabled option set to true in s3-gw configuration.

Commands

run - reads log file and reproduces send requests from it to specified endpoint

Example

frostfs-s3-playback --config <config_path> run [--endpoint=<endpoint>] [--log=<log_path>]

Configuration

Playback accepts configuration file path in yaml with corresponding options:

endpoint: http://localhost:8084
log: ./request.log
env: .env
credentials:
  access_key: CAtUxDSSFtuVyVCjHTMhwx3eP3YSPo5ffwbPcnKfcdrD06WwUSn72T5EBNe3jcgjL54rmxFM6u3nUAoNBps8qJ1PD
  secret_key: 560027d81c277de7378f71cbf12a32e4f7f541de724be59bcfdbfdc925425f30
http_timeout: 60s
skip_verify_tls: true

Configuration path is passed via required --config flag. If corresponding flag is set, it overrides parameter from config.

Configuration parameters

Global params

#	Config parameter name	Flag name	Type	Default value	Description
1	-	config	string	-	config file path (e.g. ./config/playback.yaml)
2	http_timeout	http-timeout	duration	60s	http request timeout
3	skip_verify_tls	skip-verify-tls	bool	false	skips tls certificate verification for https endpoints
4	credentials.accessKey	-	string	-	AWS access key id
5	credentials.secretKey	-	string	-	AWS secret key

run command parameters

#	Config parameter name	Flag name	Type	Default value	Description
1	endpoint	endpoint	string	-	s3-gw endpoint URL
2	log	log	string	./request.log	path to log file, could be either absolute or relative