add health metric docs (#14382)

This commit is contained in:
alex 2022-09-19 07:33:24 -07:00 committed by GitHub
parent 0095ca0541
commit 6a70477aec
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 3 deletions

View File

@ -693,14 +693,16 @@ agent. The table below describes the additional metrics exported by the proxy.
**Requirements:** **Requirements:**
- Consul 1.13.0+ - Consul 1.13.0+
[Cluster peering](/docs/connect/cluster-peering) refers to enabling communication between Consul clusters through a peer connection, as opposed to a federated connection. Consul collects metrics that describe the number of services exported to a peered cluster. Peering metrics are only emitted by the leader server. [Cluster peering](/docs/connect/cluster-peering) refers to Consul clusters that communicate through a peer connection, as opposed to a federated connection. Consul collects metrics that describe the number of services exported to a peered cluster. Peering metrics are only emitted by the leader server. These metrics are emitted every 9 seconds.
| Metric | Description | Unit | Type | | Metric | Description | Unit | Type |
| ------------------------------------- | ----------------------------------------------------------------------| ------ | ------- | | ------------------------------------- | ----------------------------------------------------------------------| ------ | ------- |
| `consul.peering.exported_services` | Counts the number of services exported to a peer cluster. | count | gauge | | `consul.peering.exported_services` | Counts the number of services exported to a peer cluster. | count | gauge |
| `consul.peering.healthy` | Tracks the health of a peering connection as reported by the server. If Consul detects errors while sending or receiving from a peer which do not recover within a reasonable time, this metric returns 0. Healthy connections return 1. | health | gauge |
### Labels ### Labels
Consul attaches the following labels to metric values. Consul attaches the following labels to metric values.
| Label Name | Description | Possible values | | Label Name | Description | Possible values |
| ------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------ | | ------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------ |
| `peer_name` | The name of the peering on the reporting cluster or leader. | Any defined peer name in the cluster | | `peer_name` | The name of the peering on the reporting cluster or leader. | Any defined peer name in the cluster |