UI, API and Metrics
UI #
In order to use UI, --port flag has to be provided.
Currently, the /debug/status lists the recent recoveries that VTOrc has performed.
APIs #
VTOrc supports the following APIs which can be used for monitoring and changing the behaviour of VTOrc.
| New API | Additional notes |
|---|---|
/api/problems | This API lists all the instances that have any problems in them. The problems range from replication not running to errant GTIDs. The new API also supports filtering using the keyspace and shard name |
/api/disable-global-recoveries | This API disables the global recoveries in VTOrc. This makes it so that VTOrc doesn't repair any failures it detects. |
/api/enable-global-recoveries | This API enables the global recoveries in VTOrc. |
/debug/health | This API outputs the health of the VTOrc process. |
/debug/liveness | This API outputs the liveness of the VTOrc process. |
/api/replication-analysis | This API shows the replication analysis of VTOrc. Output is in JSON format. |
Metrics #
Metrics are available to be seen on the /debug/vars page. VTOrc exports the following metrics:
| Metric | Usage |
|---|---|
PendingRecoveries | The number of recoveries in progress which haven't completed. |
RecoveriesCount | The number of recoveries run. This is further subdivided for all the different recoveries. |
SuccessfulRecoveries | The number of succesful recoveries run. This is further subdivided for all the different recoveries. |
FailedRecoveries | The number of recoveries that failed. This is further subdivided for all the different recoveries. |
ErrantGtidMap | Metric to track the errant GTIDs detected by VTOrc. |
If there is some information about VTOrc that you would like to see
on the
/debug/status page or support for some API or metrics to be added, please let us know in slack
in the #feat-vtorc channelUI, API and Metrics