// Copyright 2015 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package main import ( "encoding/json" "fmt" "net/http" "strconv" "sync" "time" "github.com/prometheus/common/log" "github.com/prometheus/common/model" "github.com/prometheus/common/route" "golang.org/x/net/context" "github.com/prometheus/alertmanager/provider" "github.com/prometheus/alertmanager/types" "github.com/prometheus/alertmanager/version" ) // API provides registration of handlers for API routes. type API struct { alerts provider.Alerts silences provider.Silences config string uptime time.Time groups func() AlertOverview // context is an indirection for testing. context func(r *http.Request) context.Context mtx sync.RWMutex } // NewAPI returns a new API. func NewAPI(alerts provider.Alerts, silences provider.Silences, gf func() AlertOverview) *API { return &API{ context: route.Context, alerts: alerts, silences: silences, groups: gf, uptime: time.Now(), } } // Register regieters the API handlers under their correct routes // in the given router. func (api *API) Register(r *route.Router) { // Register legacy forwarder for alert pushing. r.Post("/alerts", api.legacyAddAlerts) // Register actual API. r = r.WithPrefix("/v1") r.Get("/status", api.status) r.Get("/alerts/groups", api.alertGroups) r.Get("/alerts", api.listAlerts) r.Post("/alerts", api.addAlerts) r.Get("/silences", api.listSilences) r.Post("/silences", api.addSilence) r.Get("/silence/:sid", api.getSilence) r.Del("/silence/:sid", api.delSilence) } // Update sets the configuration string to a new value. func (api *API) Update(config string) { api.mtx.Lock() defer api.mtx.Unlock() api.config = config } type errorType string const ( errorNone errorType = "" errorTimeout = "timeout" errorCanceled = "canceled" errorBadData = "bad_data" ) type apiError struct { typ errorType err error } func (e *apiError) Error() string { return fmt.Sprintf("%s: %s", e.typ, e.err) } func (api *API) status(w http.ResponseWriter, req *http.Request) { api.mtx.RLock() var status = struct { Config string `json:"config"` VersionInfo map[string]string `json:"versionInfo"` Uptime time.Time `json:"uptime"` }{ Config: api.config, VersionInfo: version.Map, Uptime: api.uptime, } api.mtx.RUnlock() respond(w, status) } func (api *API) alertGroups(w http.ResponseWriter, req *http.Request) { respond(w, api.groups()) } func (api *API) listAlerts(w http.ResponseWriter, r *http.Request) { alerts := api.alerts.GetPending() defer alerts.Close() var ( err error res []*types.Alert ) // TODO(fabxc): enforce a sensible timeout. for a := range alerts.Next() { if err = alerts.Err(); err != nil { break } res = append(res, a) } if err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) return } respond(w, types.Alerts(res...)) } func (api *API) legacyAddAlerts(w http.ResponseWriter, r *http.Request) { var legacyAlerts = []struct { Summary model.LabelValue `json:"summary"` Description model.LabelValue `json:"description"` Runbook model.LabelValue `json:"runbook"` Labels model.LabelSet `json:"labels"` Payload model.LabelSet `json:"payload"` }{} if err := receive(r, &legacyAlerts); err != nil { http.Error(w, err.Error(), http.StatusBadRequest) return } var alerts []*types.Alert for _, la := range legacyAlerts { a := &types.Alert{ Alert: model.Alert{ Labels: la.Labels, Annotations: la.Payload, }, } if a.Annotations == nil { a.Annotations = model.LabelSet{} } a.Annotations["summary"] = la.Summary a.Annotations["description"] = la.Description a.Annotations["runbook"] = la.Runbook alerts = append(alerts, a) } now := time.Now() for _, alert := range alerts { alert.UpdatedAt = now if alert.StartsAt.IsZero() { alert.StartsAt = now } if alert.EndsAt.IsZero() { alert.Timeout = true alert.EndsAt = alert.StartsAt.Add(ResolveTimeout) } } // TODO(fabxc): validate input. if err := api.alerts.Put(alerts...); err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) return } respond(w, nil) } func (api *API) addAlerts(w http.ResponseWriter, r *http.Request) { var alerts []*types.Alert if err := receive(r, &alerts); err != nil { http.Error(w, err.Error(), http.StatusBadRequest) return } now := time.Now() for _, alert := range alerts { alert.UpdatedAt = now if alert.StartsAt.IsZero() { alert.StartsAt = now } if alert.EndsAt.IsZero() { alert.Timeout = true alert.EndsAt = alert.StartsAt.Add(ResolveTimeout) } } // TODO(fabxc): validate input. if err := api.alerts.Put(alerts...); err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) return } respond(w, nil) } func (api *API) addSilence(w http.ResponseWriter, r *http.Request) { var sil types.Silence if err := receive(r, &sil); err != nil { http.Error(w, err.Error(), http.StatusBadRequest) return } if sil.CreatedAt.IsZero() { sil.CreatedAt = time.Now() } // TODO(fabxc): validate input. sid, err := api.silences.Set(&sil) if err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) return } respond(w, struct { SilenceID uint64 `json:"silenceId"` }{ SilenceID: sid, }) } func (api *API) getSilence(w http.ResponseWriter, r *http.Request) { sids := route.Param(api.context(r), "sid") sid, err := strconv.ParseUint(sids, 10, 64) if err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) } sil, err := api.silences.Get(sid) if err != nil { http.Error(w, fmt.Sprint("Error getting silence: ", err), http.StatusNotFound) return } respond(w, &sil) } func (api *API) delSilence(w http.ResponseWriter, r *http.Request) { sids := route.Param(api.context(r), "sid") sid, err := strconv.ParseUint(sids, 10, 64) if err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) } if err := api.silences.Del(sid); err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) return } respond(w, nil) } func (api *API) listSilences(w http.ResponseWriter, r *http.Request) { sils, err := api.silences.All() if err != nil { respondError(w, apiError{ typ: errorBadData, err: err, }, nil) return } respond(w, sils) } type status string const ( statusSuccess status = "success" statusError = "error" ) type response struct { Status status `json:"status"` Data interface{} `json:"data,omitempty"` ErrorType errorType `json:"errorType,omitempty"` Error string `json:"error,omitempty"` } func respond(w http.ResponseWriter, data interface{}) { w.Header().Set("Content-Type", "application/json") w.WriteHeader(200) b, err := json.Marshal(&response{ Status: statusSuccess, Data: data, }) if err != nil { return } w.Write(b) } func respondError(w http.ResponseWriter, apiErr apiError, data interface{}) { w.Header().Set("Content-Type", "application/json") w.WriteHeader(422) b, err := json.Marshal(&response{ Status: statusError, ErrorType: apiErr.typ, Error: apiErr.err.Error(), Data: data, }) if err != nil { return } w.Write(b) } func receive(r *http.Request, v interface{}) error { dec := json.NewDecoder(r.Body) defer r.Body.Close() err := dec.Decode(v) if err != nil { log.Debugf("Decoding request failed: %v", err) } return err }