2023-01-25 21:27:36 +00:00
|
|
|
# Debug
|
|
|
|
|
|
|
|
## Debug Info Wireguard Coordinator
|
|
|
|
|
|
|
|
### Code samples
|
|
|
|
|
|
|
|
```shell
|
|
|
|
# Example request using curl
|
|
|
|
curl -X GET http://coder-server:8080/api/v2/debug/coordinator \
|
|
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
|
|
```
|
|
|
|
|
|
|
|
`GET /debug/coordinator`
|
|
|
|
|
|
|
|
### Responses
|
|
|
|
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|
|
| ------ | ------------------------------------------------------- | ----------- | ------ |
|
|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | |
|
|
|
|
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
2023-04-03 06:28:42 +00:00
|
|
|
|
|
|
|
## Debug Info Deployment Health
|
|
|
|
|
|
|
|
### Code samples
|
|
|
|
|
|
|
|
```shell
|
|
|
|
# Example request using curl
|
|
|
|
curl -X GET http://coder-server:8080/api/v2/debug/health \
|
|
|
|
-H 'Accept: application/json' \
|
|
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
|
|
```
|
|
|
|
|
|
|
|
`GET /debug/health`
|
|
|
|
|
2023-11-15 15:54:15 +00:00
|
|
|
### Parameters
|
|
|
|
|
|
|
|
| Name | In | Type | Required | Description |
|
|
|
|
| ------- | ----- | ------- | -------- | -------------------------- |
|
|
|
|
| `force` | query | boolean | false | Force a healthcheck to run |
|
|
|
|
|
2023-04-03 06:28:42 +00:00
|
|
|
### Example responses
|
|
|
|
|
|
|
|
> 200 Response
|
|
|
|
|
|
|
|
```json
|
|
|
|
{
|
2023-04-18 20:52:00 +00:00
|
|
|
"access_url": {
|
2023-06-27 19:13:54 +00:00
|
|
|
"access_url": "string",
|
2023-11-29 16:37:40 +00:00
|
|
|
"dismissed": true,
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-04-18 20:52:00 +00:00
|
|
|
"healthy": true,
|
2023-05-31 20:17:33 +00:00
|
|
|
"healthz_response": "string",
|
2023-04-18 20:52:00 +00:00
|
|
|
"reachable": true,
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-11-17 15:00:49 +00:00
|
|
|
"status_code": 0,
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2023-04-18 20:52:00 +00:00
|
|
|
},
|
2023-06-27 19:13:54 +00:00
|
|
|
"coder_version": "string",
|
2023-06-20 15:13:22 +00:00
|
|
|
"database": {
|
2023-11-29 16:37:40 +00:00
|
|
|
"dismissed": true,
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-06-20 15:13:22 +00:00
|
|
|
"healthy": true,
|
2023-08-03 21:20:46 +00:00
|
|
|
"latency": "string",
|
|
|
|
"latency_ms": 0,
|
2023-11-13 14:14:43 +00:00
|
|
|
"reachable": true,
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-11-17 15:00:49 +00:00
|
|
|
"threshold_ms": 0,
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2023-06-20 15:13:22 +00:00
|
|
|
},
|
2023-04-03 06:28:42 +00:00
|
|
|
"derp": {
|
2023-11-29 16:37:40 +00:00
|
|
|
"dismissed": true,
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-04-03 06:28:42 +00:00
|
|
|
"healthy": true,
|
|
|
|
"netcheck": {
|
|
|
|
"captivePortal": "string",
|
|
|
|
"globalV4": "string",
|
|
|
|
"globalV6": "string",
|
|
|
|
"hairPinning": "string",
|
|
|
|
"icmpv4": true,
|
|
|
|
"ipv4": true,
|
|
|
|
"ipv4CanSend": true,
|
|
|
|
"ipv6": true,
|
|
|
|
"ipv6CanSend": true,
|
|
|
|
"mappingVariesByDestIP": "string",
|
|
|
|
"oshasIPv6": true,
|
|
|
|
"pcp": "string",
|
|
|
|
"pmp": "string",
|
|
|
|
"preferredDERP": 0,
|
|
|
|
"regionLatency": {
|
|
|
|
"property1": 0,
|
|
|
|
"property2": 0
|
|
|
|
},
|
|
|
|
"regionV4Latency": {
|
|
|
|
"property1": 0,
|
|
|
|
"property2": 0
|
|
|
|
},
|
|
|
|
"regionV6Latency": {
|
|
|
|
"property1": 0,
|
|
|
|
"property2": 0
|
|
|
|
},
|
|
|
|
"udp": true,
|
|
|
|
"upnP": "string"
|
|
|
|
},
|
2023-06-27 19:13:54 +00:00
|
|
|
"netcheck_err": "string",
|
2023-04-03 06:28:42 +00:00
|
|
|
"netcheck_logs": ["string"],
|
|
|
|
"regions": {
|
|
|
|
"property1": {
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-04-03 06:28:42 +00:00
|
|
|
"healthy": true,
|
|
|
|
"node_reports": [
|
|
|
|
{
|
|
|
|
"can_exchange_messages": true,
|
2023-06-27 19:13:54 +00:00
|
|
|
"client_errs": [["string"]],
|
2023-04-03 06:28:42 +00:00
|
|
|
"client_logs": [["string"]],
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-04-03 06:28:42 +00:00
|
|
|
"healthy": true,
|
|
|
|
"node": {
|
2023-08-09 19:50:26 +00:00
|
|
|
"canPort80": true,
|
2023-04-03 06:28:42 +00:00
|
|
|
"certName": "string",
|
|
|
|
"derpport": 0,
|
|
|
|
"forceHTTP": true,
|
|
|
|
"hostName": "string",
|
|
|
|
"insecureForTests": true,
|
|
|
|
"ipv4": "string",
|
|
|
|
"ipv6": "string",
|
|
|
|
"name": "string",
|
|
|
|
"regionID": 0,
|
|
|
|
"stunonly": true,
|
|
|
|
"stunport": 0,
|
|
|
|
"stuntestIP": "string"
|
|
|
|
},
|
2023-04-20 01:03:05 +00:00
|
|
|
"node_info": {
|
|
|
|
"tokenBucketBytesBurst": 0,
|
|
|
|
"tokenBucketBytesPerSecond": 0
|
|
|
|
},
|
2023-08-03 21:20:46 +00:00
|
|
|
"round_trip_ping": "string",
|
|
|
|
"round_trip_ping_ms": 0,
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-04-03 06:28:42 +00:00
|
|
|
"stun": {
|
|
|
|
"canSTUN": true,
|
|
|
|
"enabled": true,
|
2023-08-03 21:20:46 +00:00
|
|
|
"error": "string"
|
2023-04-03 06:28:42 +00:00
|
|
|
},
|
2023-11-17 15:00:49 +00:00
|
|
|
"uses_websocket": true,
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2023-04-03 06:28:42 +00:00
|
|
|
}
|
|
|
|
],
|
|
|
|
"region": {
|
|
|
|
"avoid": true,
|
|
|
|
"embeddedRelay": true,
|
|
|
|
"nodes": [
|
|
|
|
{
|
2023-08-09 19:50:26 +00:00
|
|
|
"canPort80": true,
|
2023-04-03 06:28:42 +00:00
|
|
|
"certName": "string",
|
|
|
|
"derpport": 0,
|
|
|
|
"forceHTTP": true,
|
|
|
|
"hostName": "string",
|
|
|
|
"insecureForTests": true,
|
|
|
|
"ipv4": "string",
|
|
|
|
"ipv6": "string",
|
|
|
|
"name": "string",
|
|
|
|
"regionID": 0,
|
|
|
|
"stunonly": true,
|
|
|
|
"stunport": 0,
|
|
|
|
"stuntestIP": "string"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"regionCode": "string",
|
|
|
|
"regionID": 0,
|
|
|
|
"regionName": "string"
|
2023-11-17 15:00:49 +00:00
|
|
|
},
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2023-04-03 06:28:42 +00:00
|
|
|
},
|
|
|
|
"property2": {
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-04-03 06:28:42 +00:00
|
|
|
"healthy": true,
|
|
|
|
"node_reports": [
|
|
|
|
{
|
|
|
|
"can_exchange_messages": true,
|
2023-06-27 19:13:54 +00:00
|
|
|
"client_errs": [["string"]],
|
2023-04-03 06:28:42 +00:00
|
|
|
"client_logs": [["string"]],
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-04-03 06:28:42 +00:00
|
|
|
"healthy": true,
|
|
|
|
"node": {
|
2023-08-09 19:50:26 +00:00
|
|
|
"canPort80": true,
|
2023-04-03 06:28:42 +00:00
|
|
|
"certName": "string",
|
|
|
|
"derpport": 0,
|
|
|
|
"forceHTTP": true,
|
|
|
|
"hostName": "string",
|
|
|
|
"insecureForTests": true,
|
|
|
|
"ipv4": "string",
|
|
|
|
"ipv6": "string",
|
|
|
|
"name": "string",
|
|
|
|
"regionID": 0,
|
|
|
|
"stunonly": true,
|
|
|
|
"stunport": 0,
|
|
|
|
"stuntestIP": "string"
|
|
|
|
},
|
2023-04-20 01:03:05 +00:00
|
|
|
"node_info": {
|
|
|
|
"tokenBucketBytesBurst": 0,
|
|
|
|
"tokenBucketBytesPerSecond": 0
|
|
|
|
},
|
2023-08-03 21:20:46 +00:00
|
|
|
"round_trip_ping": "string",
|
|
|
|
"round_trip_ping_ms": 0,
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-04-03 06:28:42 +00:00
|
|
|
"stun": {
|
|
|
|
"canSTUN": true,
|
|
|
|
"enabled": true,
|
2023-08-03 21:20:46 +00:00
|
|
|
"error": "string"
|
2023-04-03 06:28:42 +00:00
|
|
|
},
|
2023-11-17 15:00:49 +00:00
|
|
|
"uses_websocket": true,
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2023-04-03 06:28:42 +00:00
|
|
|
}
|
|
|
|
],
|
|
|
|
"region": {
|
|
|
|
"avoid": true,
|
|
|
|
"embeddedRelay": true,
|
|
|
|
"nodes": [
|
|
|
|
{
|
2023-08-09 19:50:26 +00:00
|
|
|
"canPort80": true,
|
2023-04-03 06:28:42 +00:00
|
|
|
"certName": "string",
|
|
|
|
"derpport": 0,
|
|
|
|
"forceHTTP": true,
|
|
|
|
"hostName": "string",
|
|
|
|
"insecureForTests": true,
|
|
|
|
"ipv4": "string",
|
|
|
|
"ipv6": "string",
|
|
|
|
"name": "string",
|
|
|
|
"regionID": 0,
|
|
|
|
"stunonly": true,
|
|
|
|
"stunport": 0,
|
|
|
|
"stuntestIP": "string"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"regionCode": "string",
|
|
|
|
"regionID": 0,
|
|
|
|
"regionName": "string"
|
2023-11-17 15:00:49 +00:00
|
|
|
},
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2023-04-03 06:28:42 +00:00
|
|
|
}
|
2023-11-17 15:00:49 +00:00
|
|
|
},
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2023-04-03 06:28:42 +00:00
|
|
|
},
|
2023-12-05 20:00:27 +00:00
|
|
|
"failing_sections": ["DERP"],
|
2023-05-31 20:17:33 +00:00
|
|
|
"healthy": true,
|
2024-01-08 09:29:04 +00:00
|
|
|
"provisioner_daemons": {
|
|
|
|
"dismissed": true,
|
|
|
|
"error": "string",
|
2024-01-08 13:55:00 +00:00
|
|
|
"items": [
|
2024-01-08 09:29:04 +00:00
|
|
|
{
|
2024-01-08 13:55:00 +00:00
|
|
|
"provisioner_daemon": {
|
|
|
|
"api_version": "string",
|
|
|
|
"created_at": "2019-08-24T14:15:22Z",
|
|
|
|
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
|
|
|
|
"last_seen_at": "2019-08-24T14:15:22Z",
|
|
|
|
"name": "string",
|
|
|
|
"provisioners": ["string"],
|
|
|
|
"tags": {
|
|
|
|
"property1": "string",
|
|
|
|
"property2": "string"
|
|
|
|
},
|
|
|
|
"version": "string"
|
2024-01-08 09:29:04 +00:00
|
|
|
},
|
2024-01-08 13:55:00 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
2024-01-08 09:29:04 +00:00
|
|
|
}
|
|
|
|
],
|
|
|
|
"severity": "ok",
|
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
]
|
|
|
|
},
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2024-02-23 13:13:28 +00:00
|
|
|
"time": "2019-08-24T14:15:22Z",
|
2023-05-30 19:22:32 +00:00
|
|
|
"websocket": {
|
2023-08-03 21:20:46 +00:00
|
|
|
"body": "string",
|
|
|
|
"code": 0,
|
2023-11-29 16:37:40 +00:00
|
|
|
"dismissed": true,
|
2023-06-27 19:13:54 +00:00
|
|
|
"error": "string",
|
2023-11-17 15:00:49 +00:00
|
|
|
"healthy": true,
|
2023-11-23 15:08:41 +00:00
|
|
|
"severity": "ok",
|
2023-11-17 15:00:49 +00:00
|
|
|
"warnings": ["string"]
|
2023-11-24 15:06:51 +00:00
|
|
|
},
|
|
|
|
"workspace_proxy": {
|
2023-11-29 16:37:40 +00:00
|
|
|
"dismissed": true,
|
2023-11-24 15:06:51 +00:00
|
|
|
"error": "string",
|
|
|
|
"healthy": true,
|
|
|
|
"severity": "ok",
|
2023-11-30 14:49:50 +00:00
|
|
|
"warnings": [
|
|
|
|
{
|
|
|
|
"code": "EUNKNOWN",
|
|
|
|
"message": "string"
|
|
|
|
}
|
|
|
|
],
|
2023-11-24 15:06:51 +00:00
|
|
|
"workspace_proxies": {
|
|
|
|
"regions": [
|
|
|
|
{
|
|
|
|
"created_at": "2019-08-24T14:15:22Z",
|
|
|
|
"deleted": true,
|
|
|
|
"derp_enabled": true,
|
|
|
|
"derp_only": true,
|
|
|
|
"display_name": "string",
|
|
|
|
"healthy": true,
|
|
|
|
"icon_url": "string",
|
|
|
|
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
|
|
|
|
"name": "string",
|
|
|
|
"path_app_url": "string",
|
|
|
|
"status": {
|
|
|
|
"checked_at": "2019-08-24T14:15:22Z",
|
|
|
|
"report": {
|
|
|
|
"errors": ["string"],
|
|
|
|
"warnings": ["string"]
|
|
|
|
},
|
|
|
|
"status": "ok"
|
|
|
|
},
|
|
|
|
"updated_at": "2019-08-24T14:15:22Z",
|
|
|
|
"version": "string",
|
|
|
|
"wildcard_hostname": "string"
|
|
|
|
}
|
|
|
|
]
|
|
|
|
}
|
2023-05-30 19:22:32 +00:00
|
|
|
}
|
2023-04-03 06:28:42 +00:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### Responses
|
|
|
|
|
2024-03-26 17:44:31 +00:00
|
|
|
| Status | Meaning | Description | Schema |
|
|
|
|
| ------ | ------------------------------------------------------- | ----------- | -------------------------------------------------------------------- |
|
|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [healthsdk.HealthcheckReport](schemas.md#healthsdkhealthcheckreport) |
|
2023-04-03 06:28:42 +00:00
|
|
|
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
2023-11-13 23:14:12 +00:00
|
|
|
|
2023-11-28 17:15:17 +00:00
|
|
|
## Get health settings
|
|
|
|
|
|
|
|
### Code samples
|
|
|
|
|
|
|
|
```shell
|
|
|
|
# Example request using curl
|
|
|
|
curl -X GET http://coder-server:8080/api/v2/debug/health/settings \
|
|
|
|
-H 'Accept: application/json' \
|
|
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
|
|
```
|
|
|
|
|
|
|
|
`GET /debug/health/settings`
|
|
|
|
|
|
|
|
### Example responses
|
|
|
|
|
|
|
|
> 200 Response
|
|
|
|
|
|
|
|
```json
|
|
|
|
{
|
2023-12-05 20:00:27 +00:00
|
|
|
"dismissed_healthchecks": ["DERP"]
|
2023-11-28 17:15:17 +00:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### Responses
|
|
|
|
|
2024-03-26 17:44:31 +00:00
|
|
|
| Status | Meaning | Description | Schema |
|
|
|
|
| ------ | ------------------------------------------------------- | ----------- | -------------------------------------------------------------- |
|
|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [healthsdk.HealthSettings](schemas.md#healthsdkhealthsettings) |
|
2023-11-28 17:15:17 +00:00
|
|
|
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
|
|
|
|
## Update health settings
|
|
|
|
|
|
|
|
### Code samples
|
|
|
|
|
|
|
|
```shell
|
|
|
|
# Example request using curl
|
|
|
|
curl -X PUT http://coder-server:8080/api/v2/debug/health/settings \
|
|
|
|
-H 'Content-Type: application/json' \
|
|
|
|
-H 'Accept: application/json' \
|
|
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
|
|
```
|
|
|
|
|
|
|
|
`PUT /debug/health/settings`
|
|
|
|
|
|
|
|
> Body parameter
|
|
|
|
|
|
|
|
```json
|
|
|
|
{
|
2023-12-05 20:00:27 +00:00
|
|
|
"dismissed_healthchecks": ["DERP"]
|
2023-11-28 17:15:17 +00:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
2024-03-26 17:44:31 +00:00
|
|
|
| Name | In | Type | Required | Description |
|
|
|
|
| ------ | ---- | -------------------------------------------------------------------------- | -------- | ---------------------- |
|
|
|
|
| `body` | body | [healthsdk.UpdateHealthSettings](schemas.md#healthsdkupdatehealthsettings) | true | Update health settings |
|
2023-11-28 17:15:17 +00:00
|
|
|
|
|
|
|
### Example responses
|
|
|
|
|
|
|
|
> 200 Response
|
|
|
|
|
|
|
|
```json
|
|
|
|
{
|
2023-12-05 20:00:27 +00:00
|
|
|
"dismissed_healthchecks": ["DERP"]
|
2023-11-28 17:15:17 +00:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### Responses
|
|
|
|
|
2024-03-26 17:44:31 +00:00
|
|
|
| Status | Meaning | Description | Schema |
|
|
|
|
| ------ | ------------------------------------------------------- | ----------- | -------------------------------------------------------------------------- |
|
|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [healthsdk.UpdateHealthSettings](schemas.md#healthsdkupdatehealthsettings) |
|
2023-11-28 17:15:17 +00:00
|
|
|
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
|
2023-11-13 23:14:12 +00:00
|
|
|
## Debug Info Tailnet
|
|
|
|
|
|
|
|
### Code samples
|
|
|
|
|
|
|
|
```shell
|
|
|
|
# Example request using curl
|
|
|
|
curl -X GET http://coder-server:8080/api/v2/debug/tailnet \
|
|
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
|
|
```
|
|
|
|
|
|
|
|
`GET /debug/tailnet`
|
|
|
|
|
|
|
|
### Responses
|
|
|
|
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|
|
| ------ | ------------------------------------------------------- | ----------- | ------ |
|
|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | |
|
|
|
|
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|