consul/website/source/docs/commands/rtt.html.markdown

61 lines
2.0 KiB
Markdown
Raw Normal View History

2015-10-16 07:03:16 +00:00
---
layout: "docs"
page_title: "Commands: RTT"
sidebar_current: "docs-commands-rtt"
description: >
The rtt command estimates the network round trip time between two nodes.
2015-10-16 07:03:16 +00:00
---
# Consul RTT
Command: `consul rtt`
2015-10-22 00:29:43 +00:00
The `rtt` command estimates the network round trip time between two nodes using
Consul's network coordinate model of the cluster.
See the [Network Coordinates](/docs/internals/coordinates.html) internals guide
for more information on how these coordinates are computed.
2015-10-16 07:03:16 +00:00
## Usage
Usage: `consul rtt [options] node1 [node2]`
2015-10-16 07:03:16 +00:00
At least one node name is required. If the second node name isn't given, it
is set to the agent's node name. Note that these are node names as known to
2015-10-16 07:03:16 +00:00
Consul as `consul members` would show, not IP addresses.
The list of available flags are:
* `-wan` - Instructs the command to use WAN coordinates instead of LAN
coordinates. By default, the two nodes are assumed to be nodes in the local
datacenter and the LAN coordinates are used. If the -wan option is given,
then the WAN coordinates are used, and the node names must be suffixed by a period
2015-10-22 00:29:43 +00:00
and the datacenter (eg. "myserver.dc1"). It is not possible to measure between
LAN coordinates and WAN coordinates, so both nodes must be in the same pool.
2015-10-16 07:03:16 +00:00
* `-http-addr` - Address to the HTTP server of the agent you want to contact
to send this command. If this isn't specified, the command will contact
"127.0.0.1:8500" which is the default HTTP address of a Consul agent.
To use https, you need to set environment variables:
* `CONSUL_HTTP_SSL` to enabled SSL
* `CONSUL_HTTP_SSL_VERIFY` to disabled https certificate
2015-10-16 07:03:16 +00:00
## Output
If coordinates are available, the command will print the estimated round trip
time between the given nodes:
2015-10-16 07:03:16 +00:00
```
$ consul rtt n1 n2
Estimated n1 <-> n2 rtt: 0.610 ms (using LAN coordinates)
2015-10-16 07:03:16 +00:00
$ consul rtt n2 # Running from n1
Estimated n1 <-> n2 rtt: 0.610 ms (using LAN coordinates)
$ consul rtt -wan n1.dc1 n2.dc2
Estimated n1.dc1 <-> n2.dc2 rtt: 1.275 ms (using WAN coordinates)
2015-10-16 07:03:16 +00:00
```