mc ping
Themc ping command performs a liveness check on a specified target.
The following sends a response request to the target(s) and outputs the minimum, maximum, average, and roundtrip times of the response, as well as the number of errors encountered when processing the request.
mc ping myaistor --count5The command pings the deployment at thealiasmyaistor for five cycles.The output resembles the following:
1: https://myaistor.example.netmin=213.00msmax=213.00msaverage=213.00mserrors=0roundtrip=213.00ms2: https://myaistor.example.netmin=67.15msmax=213.00msaverage=140.07mserrors=0roundtrip=67.15ms3: https://myaistor.example.netmin=67.15msmax=213.00msaverage=115.85mserrors=0roundtrip=67.41ms4: https://myaistor.example.netmin=61.26msmax=213.00msaverage=102.20mserrors=0roundtrip=61.26ms5: https://myaistor.example.netmin=61.26msmax=213.00msaverage=95.03mserrors=0roundtrip=66.36msThe command has the following syntax:
mc[GLOBALFLAGS] ping\ TARGET\[--count, -c value]\[--error-count, -e value]\[--interval, -i value]\[--distributed, -a value]- Brackets
[]indicate optional parameters. - Parameters sharing a line are mutually dependent.
- Parameters separated using the pipe
|operator are mutually exclusive.
Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.
Required
The full path to thealias or prefix where the command should run.
Optional
Specify the number of times to perform the check.
If not specified, the liveness check performs continuously until stopped.
Optional
Specify a number of errors to receive before exiting.
For example, to stop the ping process after receiving five errors, use
mc ping TARGET -e5Optional
Exit after the first successful check.
Optional
The length of time in seconds to wait between requests.
By default, the command waits 1 second between requests.
Optional
Send requests to all servers in the AIStor cluster.
Use this option for distributed deployments where you have direct access to each node or pod.This flag does not work when nodes are placed behind a service, such as a load balancer.
This command supports any of theglobal flags.
The following command sends a liveness check for a deployment with the aliasmyaistor five times, outputs the result of each check, then ends.
mc ping myaistor --count5The following command sends continuous liveness check requests with an interval of 5 minutes (300 seconds) between each request.
mc ping myaistor --interval300The following command sends continuous liveness checks until 20 errors have been encountered:
mc ping myaistor --error-count20