selfhosted
/
coder
mirror of https://github.com/coder/coder.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

fix(site/src/api/typesGenerated): generate HealthSection enums (#11049) 

Relates to #8971

- Introduces a codersdk.HealthSection enum type
- Refactors existing references using strings to use new HealthSection type
This commit is contained in:
Cian Johnston 2023-12-05 20:00:27 +00:00 committed by GitHub
parent f66e802fae
commit feaa9894a4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
13 changed files with 149 additions and 73 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
coderd/apidoc/docs.go generated
View File

@ -8973,13 +8973,30 @@ const docTemplate = `{
"GroupSourceOIDC" "GroupSourceOIDC"
] ]
}, },
"codersdk.HealthSection": {
"type": "string",
"enum": [
"DERP",
"AccessURL",
"Websocket",
"Database",
"WorkspaceProxy"
],
"x-enum-varnames": [
"HealthSectionDERP",
"HealthSectionAccessURL",
"HealthSectionWebsocket",
"HealthSectionDatabase",
"HealthSectionWorkspaceProxy"
]
},
"codersdk.HealthSettings": { "codersdk.HealthSettings": {
"type": "object", "type": "object",
"properties": { "properties": {
"dismissed_healthchecks": { "dismissed_healthchecks": {
"type": "array", "type": "array",
"items": { "items": {
"type": "string" "$ref": "#/definitions/codersdk.HealthSection"
} }
} }
} }
@ -10862,7 +10879,7 @@ const docTemplate = `{
"dismissed_healthchecks": { "dismissed_healthchecks": {
"type": "array", "type": "array",
"items": { "items": {
"type": "string" "$ref": "#/definitions/codersdk.HealthSection"
} }
} }
} }
@ -12550,7 +12567,7 @@ const docTemplate = `{
"description": "FailingSections is a list of sections that have failed their healthcheck.", "description": "FailingSections is a list of sections that have failed their healthcheck.",
"type": "array", "type": "array",
"items": { "items": {
"type": "string" "$ref": "#/definitions/codersdk.HealthSection"
} }
}, },
"healthy": { "healthy": {

17
coderd/apidoc/swagger.json generated
View File

@ -8059,13 +8059,24 @@
"enum": ["user", "oidc"], "enum": ["user", "oidc"],
"x-enum-varnames": ["GroupSourceUser", "GroupSourceOIDC"] "x-enum-varnames": ["GroupSourceUser", "GroupSourceOIDC"]
}, },
"codersdk.HealthSection": {
"type": "string",
"enum": ["DERP", "AccessURL", "Websocket", "Database", "WorkspaceProxy"],
"x-enum-varnames": [
"HealthSectionDERP",
"HealthSectionAccessURL",
"HealthSectionWebsocket",
"HealthSectionDatabase",
"HealthSectionWorkspaceProxy"
]
},
"codersdk.HealthSettings": { "codersdk.HealthSettings": {
"type": "object", "type": "object",
"properties": { "properties": {
"dismissed_healthchecks": { "dismissed_healthchecks": {
"type": "array", "type": "array",
"items": { "items": {
"type": "string" "$ref": "#/definitions/codersdk.HealthSection"
} }
} }
} }
@ -9835,7 +9846,7 @@
"dismissed_healthchecks": { "dismissed_healthchecks": {
"type": "array", "type": "array",
"items": { "items": {
"type": "string" "$ref": "#/definitions/codersdk.HealthSection"
} }
} }
} }
@ -11431,7 +11442,7 @@
"description": "FailingSections is a list of sections that have failed their healthcheck.", "description": "FailingSections is a list of sections that have failed their healthcheck.",
"type": "array", "type": "array",
"items": { "items": {
"type": "string" "$ref": "#/definitions/codersdk.HealthSection"
} }
}, },
"healthy": { "healthy": {

10
coderd/coderd.go
View File

@ -413,25 +413,25 @@ func New(options *Options) *API {
Database: healthcheck.DatabaseReportOptions{ Database: healthcheck.DatabaseReportOptions{
DB: options.Database, DB: options.Database,
Threshold: options.DeploymentValues.Healthcheck.ThresholdDatabase.Value(), Threshold: options.DeploymentValues.Healthcheck.ThresholdDatabase.Value(),
Dismissed: slices.Contains(dismissedHealthchecks, healthcheck.SectionDatabase), Dismissed: slices.Contains(dismissedHealthchecks, codersdk.HealthSectionDatabase),
}, },
Websocket: healthcheck.WebsocketReportOptions{ Websocket: healthcheck.WebsocketReportOptions{
AccessURL: options.AccessURL, AccessURL: options.AccessURL,
APIKey: apiKey, APIKey: apiKey,
Dismissed: slices.Contains(dismissedHealthchecks, healthcheck.SectionWebsocket), Dismissed: slices.Contains(dismissedHealthchecks, codersdk.HealthSectionWebsocket),
}, },
AccessURL: healthcheck.AccessURLReportOptions{ AccessURL: healthcheck.AccessURLReportOptions{
AccessURL: options.AccessURL, AccessURL: options.AccessURL,
Dismissed: slices.Contains(dismissedHealthchecks, healthcheck.SectionAccessURL), Dismissed: slices.Contains(dismissedHealthchecks, codersdk.HealthSectionAccessURL),
}, },
DerpHealth: derphealth.ReportOptions{ DerpHealth: derphealth.ReportOptions{
DERPMap: api.DERPMap(), DERPMap: api.DERPMap(),
Dismissed: slices.Contains(dismissedHealthchecks, healthcheck.SectionDERP), Dismissed: slices.Contains(dismissedHealthchecks, codersdk.HealthSectionDERP),
}, },
WorkspaceProxy: healthcheck.WorkspaceProxyReportOptions{ WorkspaceProxy: healthcheck.WorkspaceProxyReportOptions{
CurrentVersion: buildinfo.Version(), CurrentVersion: buildinfo.Version(),
WorkspaceProxiesFetchUpdater: *(options.WorkspaceProxiesFetchUpdater).Load(), WorkspaceProxiesFetchUpdater: *(options.WorkspaceProxiesFetchUpdater).Load(),
Dismissed: slices.Contains(dismissedHealthchecks, healthcheck.SectionWorkspaceProxy), Dismissed: slices.Contains(dismissedHealthchecks, codersdk.HealthSectionWorkspaceProxy),
}, },
}) })
} }

5
coderd/database/types.go
View File

@ -9,6 +9,7 @@ import (
"golang.org/x/xerrors" "golang.org/x/xerrors"
"github.com/coder/coder/v2/coderd/rbac" "github.com/coder/coder/v2/coderd/rbac"
"github.com/coder/coder/v2/codersdk"
) )
// AuditOAuthConvertState is never stored in the database. It is stored in a cookie // AuditOAuthConvertState is never stored in the database. It is stored in a cookie
@ -24,8 +25,8 @@ type AuditOAuthConvertState struct {
} }
type HealthSettings struct { type HealthSettings struct {
ID uuid.UUID `db:"id" json:"id"` ID uuid.UUID `db:"id" json:"id"`
DismissedHealthchecks []string `db:"dismissed_healthchecks" json:"dismissed_healthchecks"` DismissedHealthchecks []codersdk.HealthSection `db:"dismissed_healthchecks" json:"dismissed_healthchecks"`
} }
type Actions []rbac.Action type Actions []rbac.Action

9
coderd/debug.go
View File

@ -147,7 +147,7 @@ func (api *API) deploymentHealthSettings(rw http.ResponseWriter, r *http.Request
} }
if len(settings.DismissedHealthchecks) == 0 { if len(settings.DismissedHealthchecks) == 0 {
settings.DismissedHealthchecks = []string{} settings.DismissedHealthchecks = []codersdk.HealthSection{}
} }
httpapi.Write(r.Context(), rw, http.StatusOK, settings) httpapi.Write(r.Context(), rw, http.StatusOK, settings)
@ -218,6 +218,7 @@ func (api *API) putDeploymentHealthSettings(rw http.ResponseWriter, r *http.Requ
Action: database.AuditActionWrite, Action: database.AuditActionWrite,
}) })
defer commitAudit() defer commitAudit()
aReq.New = database.HealthSettings{ aReq.New = database.HealthSettings{
ID: uuid.New(), ID: uuid.New(),
DismissedHealthchecks: settings.DismissedHealthchecks, DismissedHealthchecks: settings.DismissedHealthchecks,
@ -237,7 +238,7 @@ func (api *API) putDeploymentHealthSettings(rw http.ResponseWriter, r *http.Requ
func validateHealthSettings(settings codersdk.HealthSettings) error { func validateHealthSettings(settings codersdk.HealthSettings) error {
for _, dismissed := range settings.DismissedHealthchecks { for _, dismissed := range settings.DismissedHealthchecks {
ok := slices.Contains(healthcheck.Sections, dismissed) ok := slices.Contains(codersdk.HealthSections, dismissed)
if !ok { if !ok {
return xerrors.Errorf("unknown healthcheck section: %s", dismissed) return xerrors.Errorf("unknown healthcheck section: %s", dismissed)
} }
@ -257,8 +258,8 @@ func validateHealthSettings(settings codersdk.HealthSettings) error {
// @x-apidocgen {"skip": true} // @x-apidocgen {"skip": true}
func _debugws(http.ResponseWriter, *http.Request) {} //nolint:unused func _debugws(http.ResponseWriter, *http.Request) {} //nolint:unused
func loadDismissedHealthchecks(ctx context.Context, db database.Store, logger slog.Logger) []string { func loadDismissedHealthchecks(ctx context.Context, db database.Store, logger slog.Logger) []codersdk.HealthSection {
dismissedHealthchecks := []string{} dismissedHealthchecks := []codersdk.HealthSection{}
settingsJSON, err := db.GetHealthSettings(ctx) settingsJSON, err := db.GetHealthSettings(ctx)
if err == nil { if err == nil {
var settings codersdk.HealthSettings var settings codersdk.HealthSettings

10
coderd/debug_test.go
View File

@ -251,7 +251,7 @@ func TestHealthSettings(t *testing.T) {
require.NoError(t, err) require.NoError(t, err)
// then // then
require.Equal(t, codersdk.HealthSettings{DismissedHealthchecks: []string{}}, settings) require.Equal(t, codersdk.HealthSettings{DismissedHealthchecks: []codersdk.HealthSection{}}, settings)
}) })
t.Run("DismissSection", func(t *testing.T) { t.Run("DismissSection", func(t *testing.T) {
@ -265,7 +265,7 @@ func TestHealthSettings(t *testing.T) {
_ = coderdtest.CreateFirstUser(t, adminClient) _ = coderdtest.CreateFirstUser(t, adminClient)
expected := codersdk.HealthSettings{ expected := codersdk.HealthSettings{
DismissedHealthchecks: []string{healthcheck.SectionDERP, healthcheck.SectionWebsocket}, DismissedHealthchecks: []codersdk.HealthSection{codersdk.HealthSectionDERP, codersdk.HealthSectionWebsocket},
} }
// when: dismiss "derp" and "websocket" // when: dismiss "derp" and "websocket"
@ -289,14 +289,14 @@ func TestHealthSettings(t *testing.T) {
_ = coderdtest.CreateFirstUser(t, adminClient) _ = coderdtest.CreateFirstUser(t, adminClient)
initial := codersdk.HealthSettings{ initial := codersdk.HealthSettings{
DismissedHealthchecks: []string{healthcheck.SectionDERP, healthcheck.SectionWebsocket}, DismissedHealthchecks: []codersdk.HealthSection{codersdk.HealthSectionDERP, codersdk.HealthSectionWebsocket},
} }
err := adminClient.PutHealthSettings(ctx, initial) err := adminClient.PutHealthSettings(ctx, initial)
require.NoError(t, err) require.NoError(t, err)
expected := codersdk.HealthSettings{ expected := codersdk.HealthSettings{
DismissedHealthchecks: []string{healthcheck.SectionDERP}, DismissedHealthchecks: []codersdk.HealthSection{codersdk.HealthSectionDERP},
} }
// when: undismiss "websocket" // when: undismiss "websocket"
@ -320,7 +320,7 @@ func TestHealthSettings(t *testing.T) {
_ = coderdtest.CreateFirstUser(t, adminClient) _ = coderdtest.CreateFirstUser(t, adminClient)
expected := codersdk.HealthSettings{ expected := codersdk.HealthSettings{
DismissedHealthchecks: []string{healthcheck.SectionDERP, healthcheck.SectionWebsocket}, DismissedHealthchecks: []codersdk.HealthSection{codersdk.HealthSectionDERP, codersdk.HealthSectionWebsocket},
} }
err := adminClient.PutHealthSettings(ctx, expected) err := adminClient.PutHealthSettings(ctx, expected)

25
coderd/healthcheck/healthcheck.go
View File

@ -9,18 +9,9 @@ import (
"github.com/coder/coder/v2/coderd/healthcheck/derphealth" "github.com/coder/coder/v2/coderd/healthcheck/derphealth"
"github.com/coder/coder/v2/coderd/healthcheck/health" "github.com/coder/coder/v2/coderd/healthcheck/health"
"github.com/coder/coder/v2/coderd/util/ptr" "github.com/coder/coder/v2/coderd/util/ptr"
"github.com/coder/coder/v2/codersdk"
) )
const (
SectionDERP string = "DERP"
SectionAccessURL string = "AccessURL"
SectionWebsocket string = "Websocket"
SectionDatabase string = "Database"
SectionWorkspaceProxy string = "WorkspaceProxy"
)
var Sections = []string{SectionAccessURL, SectionDatabase, SectionDERP, SectionWebsocket, SectionWorkspaceProxy}
type Checker interface { type Checker interface {
DERP(ctx context.Context, opts *derphealth.ReportOptions) derphealth.Report DERP(ctx context.Context, opts *derphealth.ReportOptions) derphealth.Report
AccessURL(ctx context.Context, opts *AccessURLReportOptions) AccessURLReport AccessURL(ctx context.Context, opts *AccessURLReportOptions) AccessURLReport
@ -39,7 +30,7 @@ type Report struct {
// Severity indicates the status of Coder health. // Severity indicates the status of Coder health.
Severity health.Severity `json:"severity" enums:"ok,warning,error"` Severity health.Severity `json:"severity" enums:"ok,warning,error"`
// FailingSections is a list of sections that have failed their healthcheck. // FailingSections is a list of sections that have failed their healthcheck.
FailingSections []string `json:"failing_sections"` FailingSections []codersdk.HealthSection `json:"failing_sections"`
DERP derphealth.Report `json:"derp"` DERP derphealth.Report `json:"derp"`
AccessURL AccessURLReport `json:"access_url"` AccessURL AccessURLReport `json:"access_url"`
@ -162,21 +153,21 @@ func Run(ctx context.Context, opts *ReportOptions) *Report {
wg.Wait() wg.Wait()
report.Time = time.Now() report.Time = time.Now()
report.FailingSections = []string{} report.FailingSections = []codersdk.HealthSection{}
if !report.DERP.Healthy { if !report.DERP.Healthy {
report.FailingSections = append(report.FailingSections, SectionDERP) report.FailingSections = append(report.FailingSections, codersdk.HealthSectionDERP)
} }
if !report.AccessURL.Healthy { if !report.AccessURL.Healthy {
report.FailingSections = append(report.FailingSections, SectionAccessURL) report.FailingSections = append(report.FailingSections, codersdk.HealthSectionAccessURL)
} }
if !report.Websocket.Healthy { if !report.Websocket.Healthy {
report.FailingSections = append(report.FailingSections, SectionWebsocket) report.FailingSections = append(report.FailingSections, codersdk.HealthSectionWebsocket)
} }
if !report.Database.Healthy { if !report.Database.Healthy {
report.FailingSections = append(report.FailingSections, SectionDatabase) report.FailingSections = append(report.FailingSections, codersdk.HealthSectionDatabase)
} }
if !report.WorkspaceProxy.Healthy { if !report.WorkspaceProxy.Healthy {
report.FailingSections = append(report.FailingSections, SectionWorkspaceProxy) report.FailingSections = append(report.FailingSections, codersdk.HealthSectionWorkspaceProxy)
} }
report.Healthy = len(report.FailingSections) == 0 report.Healthy = len(report.FailingSections) == 0

31
coderd/healthcheck/healthcheck_test.go
View File

@ -9,6 +9,7 @@ import (
"github.com/coder/coder/v2/coderd/healthcheck" "github.com/coder/coder/v2/coderd/healthcheck"
"github.com/coder/coder/v2/coderd/healthcheck/derphealth" "github.com/coder/coder/v2/coderd/healthcheck/derphealth"
"github.com/coder/coder/v2/coderd/healthcheck/health" "github.com/coder/coder/v2/coderd/healthcheck/health"
"github.com/coder/coder/v2/codersdk"
) )
type testChecker struct { type testChecker struct {
@ -47,7 +48,7 @@ func TestHealthcheck(t *testing.T) {
checker *testChecker checker *testChecker
healthy bool healthy bool
severity health.Severity severity health.Severity
failingSections []string failingSections []codersdk.HealthSection
}{{ }{{
name: "OK", name: "OK",
checker: &testChecker{ checker: &testChecker{
@ -74,7 +75,7 @@ func TestHealthcheck(t *testing.T) {
}, },
healthy: true, healthy: true,
severity: health.SeverityOK, severity: health.SeverityOK,
failingSections: []string{}, failingSections: []codersdk.HealthSection{},
}, { }, {
name: "DERPFail", name: "DERPFail",
checker: &testChecker{ checker: &testChecker{
@ -101,7 +102,7 @@ func TestHealthcheck(t *testing.T) {
}, },
healthy: false, healthy: false,
severity: health.SeverityError, severity: health.SeverityError,
failingSections: []string{healthcheck.SectionDERP}, failingSections: []codersdk.HealthSection{codersdk.HealthSectionDERP},
}, { }, {
name: "DERPWarning", name: "DERPWarning",
checker: &testChecker{ checker: &testChecker{
@ -129,7 +130,7 @@ func TestHealthcheck(t *testing.T) {
}, },
healthy: true, healthy: true,
severity: health.SeverityWarning, severity: health.SeverityWarning,
failingSections: []string{}, failingSections: []codersdk.HealthSection{},
}, { }, {
name: "AccessURLFail", name: "AccessURLFail",
checker: &testChecker{ checker: &testChecker{
@ -156,7 +157,7 @@ func TestHealthcheck(t *testing.T) {
}, },
healthy: false, healthy: false,
severity: health.SeverityWarning, severity: health.SeverityWarning,
failingSections: []string{healthcheck.SectionAccessURL}, failingSections: []codersdk.HealthSection{codersdk.HealthSectionAccessURL},
}, { }, {
name: "WebsocketFail", name: "WebsocketFail",
checker: &testChecker{ checker: &testChecker{
@ -183,7 +184,7 @@ func TestHealthcheck(t *testing.T) {
}, },
healthy: false, healthy: false,
severity: health.SeverityError, severity: health.SeverityError,
failingSections: []string{healthcheck.SectionWebsocket}, failingSections: []codersdk.HealthSection{codersdk.HealthSectionWebsocket},
}, { }, {
name: "DatabaseFail", name: "DatabaseFail",
checker: &testChecker{ checker: &testChecker{
@ -210,7 +211,7 @@ func TestHealthcheck(t *testing.T) {
}, },
healthy: false, healthy: false,
severity: health.SeverityError, severity: health.SeverityError,
failingSections: []string{healthcheck.SectionDatabase}, failingSections: []codersdk.HealthSection{codersdk.HealthSectionDatabase},
}, { }, {
name: "ProxyFail", name: "ProxyFail",
checker: &testChecker{ checker: &testChecker{
@ -237,7 +238,7 @@ func TestHealthcheck(t *testing.T) {
}, },
severity: health.SeverityError, severity: health.SeverityError,
healthy: false, healthy: false,
failingSections: []string{healthcheck.SectionWorkspaceProxy}, failingSections: []codersdk.HealthSection{codersdk.HealthSectionWorkspaceProxy},
}, { }, {
name: "ProxyWarn", name: "ProxyWarn",
checker: &testChecker{ checker: &testChecker{
@ -265,7 +266,7 @@ func TestHealthcheck(t *testing.T) {
}, },
severity: health.SeverityWarning, severity: health.SeverityWarning,
healthy: true, healthy: true,
failingSections: []string{}, failingSections: []codersdk.HealthSection{},
}, { }, {
name: "AllFail", name: "AllFail",
healthy: false, healthy: false,
@ -292,12 +293,12 @@ func TestHealthcheck(t *testing.T) {
}, },
}, },
severity: health.SeverityError, severity: health.SeverityError,
failingSections: []string{ failingSections: []codersdk.HealthSection{
healthcheck.SectionDERP, codersdk.HealthSectionDERP,
healthcheck.SectionAccessURL, codersdk.HealthSectionAccessURL,
healthcheck.SectionWebsocket, codersdk.HealthSectionWebsocket,
healthcheck.SectionDatabase, codersdk.HealthSectionDatabase,
healthcheck.SectionWorkspaceProxy, codersdk.HealthSectionWorkspaceProxy,
}, },
}} { }} {
c := c c := c

23
codersdk/health.go
View File

@ -8,12 +8,31 @@ import (
"golang.org/x/xerrors" "golang.org/x/xerrors"
) )
type HealthSection string
// If you add another const below, make sure to add it to HealthSections!
const (
HealthSectionDERP HealthSection = "DERP"
HealthSectionAccessURL HealthSection = "AccessURL"
HealthSectionWebsocket HealthSection = "Websocket"
HealthSectionDatabase HealthSection = "Database"
HealthSectionWorkspaceProxy HealthSection = "WorkspaceProxy"
)
var HealthSections = []HealthSection{
HealthSectionDERP,
HealthSectionAccessURL,
HealthSectionWebsocket,
HealthSectionDatabase,
HealthSectionWorkspaceProxy,
}
type HealthSettings struct { type HealthSettings struct {
DismissedHealthchecks []string `json:"dismissed_healthchecks"` DismissedHealthchecks []HealthSection `json:"dismissed_healthchecks"`
} }
type UpdateHealthSettings struct { type UpdateHealthSettings struct {
DismissedHealthchecks []string `json:"dismissed_healthchecks"` DismissedHealthchecks []HealthSection `json:"dismissed_healthchecks"`
} }
func (c *Client) HealthSettings(ctx context.Context) (HealthSettings, error) { func (c *Client) HealthSettings(ctx context.Context) (HealthSettings, error) {

8
docs/api/debug.md generated
View File

@ -280,7 +280,7 @@ curl -X GET http://coder-server:8080/api/v2/debug/health \
} }
] ]
}, },
"failing_sections": ["string"], "failing_sections": ["DERP"],
"healthy": true, "healthy": true,
"severity": "ok", "severity": "ok",
"time": "string", "time": "string",
@ -362,7 +362,7 @@ curl -X GET http://coder-server:8080/api/v2/debug/health/settings \
```json ```json
{ {
"dismissed_healthchecks": ["string"] "dismissed_healthchecks": ["DERP"]
} }
``` ```
@ -392,7 +392,7 @@ curl -X PUT http://coder-server:8080/api/v2/debug/health/settings \
```json ```json
{ {
"dismissed_healthchecks": ["string"] "dismissed_healthchecks": ["DERP"]
} }
``` ```
@ -408,7 +408,7 @@ curl -X PUT http://coder-server:8080/api/v2/debug/health/settings \
```json ```json
{ {
"dismissed_healthchecks": ["string"] "dismissed_healthchecks": ["DERP"]
} }
``` ```

38
docs/api/schemas.md generated
View File

@ -3170,19 +3170,37 @@ AuthorizationObject can represent a "set" of objects, such as: all workspaces in
| `user` | | `user` |
| `oidc` | | `oidc` |
## codersdk.HealthSection
```json
"DERP"
```
### Properties
#### Enumerated Values
| Value |
| ---------------- |
| `DERP` |
| `AccessURL` |
| `Websocket` |
| `Database` |
| `WorkspaceProxy` |
## codersdk.HealthSettings ## codersdk.HealthSettings
```json ```json
{ {
"dismissed_healthchecks": ["string"] "dismissed_healthchecks": ["DERP"]
} }
``` ```
### Properties ### Properties
| Name | Type | Required | Restrictions | Description | | Name | Type | Required | Restrictions | Description |
| ------------------------ | --------------- | -------- | ------------ | ----------- | | ------------------------ | --------------------------------------------------------- | -------- | ------------ | ----------- |
| `dismissed_healthchecks` | array of string | false | | | | `dismissed_healthchecks` | array of [codersdk.HealthSection](#codersdkhealthsection) | false | | |
## codersdk.Healthcheck ## codersdk.Healthcheck
@ -5182,15 +5200,15 @@ AuthorizationObject can represent a "set" of objects, such as: all workspaces in
```json ```json
{ {
"dismissed_healthchecks": ["string"] "dismissed_healthchecks": ["DERP"]
} }
``` ```
### Properties ### Properties
| Name | Type | Required | Restrictions | Description | | Name | Type | Required | Restrictions | Description |
| ------------------------ | --------------- | -------- | ------------ | ----------- | | ------------------------ | --------------------------------------------------------- | -------- | ------------ | ----------- |
| `dismissed_healthchecks` | array of string | false | | | | `dismissed_healthchecks` | array of [codersdk.HealthSection](#codersdkhealthsection) | false | | |
## codersdk.UpdateRoles ## codersdk.UpdateRoles
@ -7952,7 +7970,7 @@ If the schedule is empty, the user will be updated to use the default schedule.|
} }
] ]
}, },
"failing_sections": ["string"], "failing_sections": ["DERP"],
"healthy": true, "healthy": true,
"severity": "ok", "severity": "ok",
"time": "string", "time": "string",
@ -8015,7 +8033,7 @@ If the schedule is empty, the user will be updated to use the default schedule.|
| `coder_version` | string | false | | The Coder version of the server that the report was generated on. | | `coder_version` | string | false | | The Coder version of the server that the report was generated on. |
| `database` | [healthcheck.DatabaseReport](#healthcheckdatabasereport) | false | | | | `database` | [healthcheck.DatabaseReport](#healthcheckdatabasereport) | false | | |
| `derp` | [derphealth.Report](#derphealthreport) | false | | | | `derp` | [derphealth.Report](#derphealthreport) | false | | |
| `failing_sections` | array of string | false | | Failing sections is a list of sections that have failed their healthcheck. | | `failing_sections` | array of [codersdk.HealthSection](#codersdkhealthsection) | false | | Failing sections is a list of sections that have failed their healthcheck. |
| `healthy` | boolean | false | | Healthy is true if the report returns no errors. Deprecated: use `Severity` instead | | `healthy` | boolean | false | | Healthy is true if the report returns no errors. Deprecated: use `Severity` instead |
| `severity` | [health.Severity](#healthseverity) | false | | Severity indicates the status of Coder health. | | `severity` | [health.Severity](#healthseverity) | false | | Severity indicates the status of Coder health. |
| `time` | string | false | | Time is the time the report was generated at. | | `time` | string | false | | Time is the time the report was generated at. |

2
scripts/apitypings/main.go
View File

@ -875,6 +875,8 @@ func (g *Generator) typescriptType(ty types.Type) (TypescriptType, error) {
return TypescriptType{ValueType: "HealthMessage"}, nil return TypescriptType{ValueType: "HealthMessage"}, nil
case "github.com/coder/coder/v2/coderd/healthcheck/health.Severity": case "github.com/coder/coder/v2/coderd/healthcheck/health.Severity":
return TypescriptType{ValueType: "HealthSeverity"}, nil return TypescriptType{ValueType: "HealthSeverity"}, nil
case "github.com/coder/coder/v2/codersdk.HealthSection":
return TypescriptType{ValueType: "HealthSection"}, nil
} }
// Some hard codes are a bit trickier. // Some hard codes are a bit trickier.

21
site/src/api/typesGenerated.ts generated
View File

@ -544,7 +544,7 @@ export interface Group {
// From codersdk/health.go // From codersdk/health.go
export interface HealthSettings { export interface HealthSettings {
readonly dismissed_healthchecks: string[]; readonly dismissed_healthchecks: HealthSection[];
} }
// From codersdk/workspaceapps.go // From codersdk/workspaceapps.go
@ -1164,7 +1164,7 @@ export interface UpdateCheckResponse {
// From codersdk/health.go // From codersdk/health.go
export interface UpdateHealthSettings { export interface UpdateHealthSettings {
readonly dismissed_healthchecks: string[]; readonly dismissed_healthchecks: HealthSection[];
} }
// From codersdk/users.go // From codersdk/users.go
@ -1795,6 +1795,21 @@ export const FeatureNames: FeatureName[] = [
export type GroupSource = "oidc" | "user"; export type GroupSource = "oidc" | "user";
export const GroupSources: GroupSource[] = ["oidc", "user"]; export const GroupSources: GroupSource[] = ["oidc", "user"];
// From codersdk/health.go
export type HealthSection =
| "AccessURL"
| "DERP"
| "Database"
| "Websocket"
| "WorkspaceProxy";
export const HealthSections: HealthSection[] = [
"AccessURL",
"DERP",
"Database",
"Websocket",
"WorkspaceProxy",
];
// From codersdk/insights.go // From codersdk/insights.go
export type InsightsReportInterval = "day" | "week"; export type InsightsReportInterval = "day" | "week";
export const InsightsReportIntervals: InsightsReportInterval[] = [ export const InsightsReportIntervals: InsightsReportInterval[] = [
@ -2128,7 +2143,7 @@ export interface HealthcheckReport {
readonly time: string; readonly time: string;
readonly healthy: boolean; readonly healthy: boolean;
readonly severity: HealthSeverity; readonly severity: HealthSeverity;
readonly failing_sections: string[]; readonly failing_sections: HealthSection[];
readonly derp: DerphealthReport; readonly derp: DerphealthReport;
readonly access_url: HealthcheckAccessURLReport; readonly access_url: HealthcheckAccessURLReport;
readonly websocket: HealthcheckWebsocketReport; readonly websocket: HealthcheckWebsocketReport;