---
title: "Monitor xCluster"
url: "https://docs.yugabyte.com/stable/launch-and-manage/monitor-and-alert/xcluster-monitor/"
---

# Monitor xCluster

Monitoring the health of xCluster replication

Monitoring the state and health of xCluster replication

## Metrics

The list of xCluster metrics is available in the [xCluster metrics](/stable/launch-and-manage/monitor-and-alert/metrics/replication/ "xCluster metrics").

## Console

- [![Server Icon](/icons/database.svg) Yugabyted](#yugabyted)
- [Local](#local)

Use the [xcluster status](/stable/reference/configuration/yugabyted/#status-1 "xcluster status") sub command to display information about the specified xCluster replication. You can run the command on either the source or target cluster.

```sh
./bin/yugabyted xcluster status \
  [--replication_id <replication_id>]
```

Example output:

```output
Outbound xCluster Replications:

+------------------------------------------------------------------------------------------+
|                                        yugabyted                                         |
+------------------------------------------------------------------------------------------+
| Replication 1               :                                                            |
| Replication ID              : rg1                                                        |
| State                       : REPLICATING                                                |
| Target Universe UUID        : 2e3ff9c4-2c5a-4dc6-a6bc-20e2548b9f09                       |
| Databases                   : Following are the databases included in this replication   |
|                             : Database 1:                                                |
|                             : Name: yugabyte                                             |
|                             : State: READY                                               |
+------------------------------------------------------------------------------------------+

No Inbound xCluster replications found for this cluster.
```

To list outgoing groups on the Primary universe, use the [list\_xcluster\_outbound\_replication\_groups](/stable/admin/yb-admin/#list-xcluster-outbound-replication-groups "list_xcluster_outbound_replication_groups") command:

```sh
./bin/yb-admin \
    --master_addresses <primary_master_addresses> \
    list_xcluster_outbound_replication_groups \
    [namespace_id]
```

To list inbound groups on the Standby universe, use the [list\_universe\_replications](/stable/admin/yb-admin/#list-universe-replications "list_universe_replications") command:

```sh
./bin/yb-admin \
    --master_addresses <standby_master_addresses> \
    list_universe_replications \
    [namespace_id]
```

To get the status of the replication group, use [get\_replication\_status](/stable/admin/yb-admin/#get-replication-status "get_replication_status"):

```sh
yb-admin \
    --master_addresses <target-master-addresses> \
    get_replication_status \
    [<replication_id>]
```

## xCluster safe time

In transactional xCluster replication setups, the current xCluster safe time is the safe time as of which consistent reads are performed on the target universe. You can use the following commands to see the current xCluster safe time:

- [![Server Icon](/icons/database.svg) Yugabyted](#yugabyted-safe-time)
- [Local](#local-safe-time)

```sh
./bin/yugabyted xcluster status \
    [--replication_id <replication_id>]
```

Example output:

```output
No Outbound xCluster replications found for this cluster.
Inbound xCluster Replications:

+------------------------------------------------------------------------------------------+
|                                        yugabyted                                         |
+------------------------------------------------------------------------------------------+
| Replication 1               :                                                            |
| Replication ID              : rg1                                                        |
| State                       : ACTIVE                                                     |
| Source cluster nodes        : 127.0.0.1,127.0.0.2,127.0.0.3                              |
| Databases                   : Following are the databases included in this replication   |
|                             : Database 1:                                                |
|                             : Name: yugabyte                                             |
|                             : Safe Time: 2025-03-14 20:43:49.723305                      |
|                             : Safe Time Lag(micro secs): 0.88                            |
|                             : Safe Time Skew(micro secs): 0.81                           |
+------------------------------------------------------------------------------------------+
```

```sh
yb-admin \
    --master_addresses <standby_master_addresses> \
    get_xcluster_safe_time \
    [include_lag_and_skew]
```

Example output:

```output
[
    {
        "namespace_id": "000034cb000030008000000000000000",
        "namespace_name": "yugabyte",
        "safe_time": "2025-03-14 20:51:25.915918",
        "safe_time_epoch": "1742010685915918",
        "safe_time_lag_sec": "0.50",
        "safe_time_skew_sec": "0.02"
    }
]
```

## YB-Master and YB-TServer UI

You can access the YB-Master and YB-TServer UIs to monitor the health of xCluster replication at `/xcluster`.

**YB-Master source**

[http://127.0.0.1:7000/xcluster](http://127.0.0.1:7000/xcluster "http://127.0.0.1:7000/xcluster") ![Source YB-Master outbound](/images/deploy/xcluster/automatic-outbound.jpg "Source YB-Master outbound")

**YB-Master target**

[http://127.0.0.1:7000/xcluster](http://127.0.0.1:7000/xcluster "http://127.0.0.1:7000/xcluster"): ![Target YB-Master inbound](/images/deploy/xcluster/automatic-inbound.jpg "Target YB-Master inbound")

**YB-TServer source**

[http://127.0.0.1:9000/xcluster](http://127.0.0.1:9000/xcluster "http://127.0.0.1:9000/xcluster"): ![Source YB-TServer inbound](/images/deploy/xcluster/tserver-outbound.jpg "Source YB-TServer inbound")

**YB-TServer target**

[http://127.0.0.1:9000/xcluster](http://127.0.0.1:9000/xcluster "http://127.0.0.1:9000/xcluster")

## Advanced troubleshooting

For advanced troubleshooting, refer to the [Troubleshooting xCluster Replication](https://support.yugabyte.com/hc/en-us/articles/29809348650381-How-to-troubleshoot-xCluster-replication-lag-and-errors "Troubleshooting xCluster Replication") guide.