package matrix import ( "bytes" "encoding/json" "fmt" "io" "math/rand" "net/http" "net/url" "time" "github.com/TwiN/gatus/v5/alerting/alert" "github.com/TwiN/gatus/v5/client" "github.com/TwiN/gatus/v5/config/endpoint" ) // AlertProvider is the configuration necessary for sending an alert using Matrix type AlertProvider struct { ProviderConfig `yaml:",inline"` // DefaultAlert is the default alert configuration to use for endpoints with an alert of the appropriate type DefaultAlert *alert.Alert `yaml:"default-alert,omitempty"` // Overrides is a list of Override that may be prioritized over the default configuration Overrides []Override `yaml:"overrides,omitempty"` } // Override is a case under which the default integration is overridden type Override struct { Group string `yaml:"group"` ProviderConfig `yaml:",inline"` } const defaultServerURL = "https://matrix-client.matrix.org" type ProviderConfig struct { // ServerURL is the custom homeserver to use (optional) ServerURL string `yaml:"server-url"` // AccessToken is the bot user's access token to send messages AccessToken string `yaml:"access-token"` // InternalRoomID is the room that the bot user has permissions to send messages to InternalRoomID string `yaml:"internal-room-id"` } // IsValid returns whether the provider's configuration is valid func (provider *AlertProvider) IsValid() bool { registeredGroups := make(map[string]bool) if provider.Overrides != nil { for _, override := range provider.Overrides { if isAlreadyRegistered := registeredGroups[override.Group]; isAlreadyRegistered || override.Group == "" || len(override.AccessToken) == 0 || len(override.InternalRoomID) == 0 { return false } registeredGroups[override.Group] = true } } return len(provider.AccessToken) > 0 && len(provider.InternalRoomID) > 0 } // Send an alert using the provider func (provider *AlertProvider) Send(ep *endpoint.Endpoint, alert *alert.Alert, result *endpoint.Result, resolved bool) error { buffer := bytes.NewBuffer(provider.buildRequestBody(ep, alert, result, resolved)) config := provider.getConfigForGroup(ep.Group) if config.ServerURL == "" { config.ServerURL = defaultServerURL } // The Matrix endpoint requires a unique transaction ID for each event sent txnId := randStringBytes(24) request, err := http.NewRequest( http.MethodPut, fmt.Sprintf("%s/_matrix/client/v3/rooms/%s/send/m.room.message/%s?access_token=%s", config.ServerURL, url.PathEscape(config.InternalRoomID), txnId, url.QueryEscape(config.AccessToken), ), buffer, ) if err != nil { return err } request.Header.Set("Content-Type", "application/json") response, err := client.GetHTTPClient(nil).Do(request) if err != nil { return err } defer response.Body.Close() if response.StatusCode > 399 { body, _ := io.ReadAll(response.Body) return fmt.Errorf("call to provider alert returned status code %d: %s", response.StatusCode, string(body)) } return err } type Body struct { MsgType string `json:"msgtype"` Format string `json:"format"` Body string `json:"body"` FormattedBody string `json:"formatted_body"` } // buildRequestBody builds the request body for the provider func (provider *AlertProvider) buildRequestBody(ep *endpoint.Endpoint, alert *alert.Alert, result *endpoint.Result, resolved bool) []byte { body, _ := json.Marshal(Body{ MsgType: "m.text", Format: "org.matrix.custom.html", Body: buildPlaintextMessageBody(ep, alert, result, resolved), FormattedBody: buildHTMLMessageBody(ep, alert, result, resolved), }) return body } // buildPlaintextMessageBody builds the message body in plaintext to include in request func buildPlaintextMessageBody(ep *endpoint.Endpoint, alert *alert.Alert, result *endpoint.Result, resolved bool) string { var message string if resolved { message = fmt.Sprintf("An alert for `%s` has been resolved after passing successfully %d time(s) in a row", ep.DisplayName(), alert.SuccessThreshold) } else { message = fmt.Sprintf("An alert for `%s` has been triggered due to having failed %d time(s) in a row", ep.DisplayName(), alert.FailureThreshold) } var formattedConditionResults string for _, conditionResult := range result.ConditionResults { var prefix string if conditionResult.Success { prefix = "✓" } else { prefix = "✕" } formattedConditionResults += fmt.Sprintf("\n%s - %s", prefix, conditionResult.Condition) } var description string if alertDescription := alert.GetDescription(); len(alertDescription) > 0 { description = "\n" + alertDescription } return fmt.Sprintf("%s%s\n%s", message, description, formattedConditionResults) } // buildHTMLMessageBody builds the message body in HTML to include in request func buildHTMLMessageBody(ep *endpoint.Endpoint, alert *alert.Alert, result *endpoint.Result, resolved bool) string { var message string if resolved { message = fmt.Sprintf("An alert for %s has been resolved after passing successfully %d time(s) in a row", ep.DisplayName(), alert.SuccessThreshold) } else { message = fmt.Sprintf("An alert for %s has been triggered due to having failed %d time(s) in a row", ep.DisplayName(), alert.FailureThreshold) } var formattedConditionResults string if len(result.ConditionResults) > 0 { formattedConditionResults = "\n
Condition results
" } var description string if alertDescription := alert.GetDescription(); len(alertDescription) > 0 { description = fmt.Sprintf("\n
%s
", alertDescription) } return fmt.Sprintf("

%s

%s%s", message, description, formattedConditionResults) } // getConfigForGroup returns the appropriate configuration for a given group func (provider *AlertProvider) getConfigForGroup(group string) ProviderConfig { if provider.Overrides != nil { for _, override := range provider.Overrides { if group == override.Group { return override.ProviderConfig } } } return provider.ProviderConfig } func randStringBytes(n int) string { // All the compatible characters to use in a transaction ID const availableCharacterBytes = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789" b := make([]byte, n) rand.Seed(time.Now().UnixNano()) for i := range b { b[i] = availableCharacterBytes[rand.Intn(len(availableCharacterBytes))] } return string(b) } // GetDefaultAlert returns the provider's default alert configuration func (provider *AlertProvider) GetDefaultAlert() *alert.Alert { return provider.DefaultAlert }