// Mgmt // Copyright (C) 2013-2017+ James Shubin and the project contributors // Written by James Shubin and the project contributors // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU Affero General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Affero General Public License for more details. // // You should have received a copy of the GNU Affero General Public License // along with this program. If not, see . package resources import ( "encoding/gob" "fmt" "log" "regexp" "strings" "github.com/coreos/go-systemd/journal" ) func init() { RegisterResource("msg", func() Res { return &MsgRes{} }) gob.Register(&MsgRes{}) } // MsgRes is a resource that writes messages to logs. type MsgRes struct { BaseRes `yaml:",inline"` Body string `yaml:"body"` Priority string `yaml:"priority"` Fields map[string]string `yaml:"fields"` Journal bool `yaml:"journal"` // enable systemd journal output Syslog bool `yaml:"syslog"` // enable syslog output logStateOK bool journalStateOK bool syslogStateOK bool } // MsgUID is a unique representation for a MsgRes object. type MsgUID struct { BaseUID body string } // Default returns some sensible defaults for this resource. func (obj *MsgRes) Default() Res { return &MsgRes{ BaseRes: BaseRes{ MetaParams: DefaultMetaParams, // force a default }, } } // Validate the params that are passed to MsgRes. func (obj *MsgRes) Validate() error { invalidCharacters := regexp.MustCompile("[^a-zA-Z0-9_]") for field := range obj.Fields { if invalidCharacters.FindString(field) != "" { return fmt.Errorf("invalid character in field %s", field) } if strings.HasPrefix(field, "_") { return fmt.Errorf("fields cannot begin with _") } } return obj.BaseRes.Validate() } // Init runs some startup code for this resource. func (obj *MsgRes) Init() error { obj.BaseRes.Kind = "msg" return obj.BaseRes.Init() // call base init, b/c we're overrriding } // isAllStateOK derives a compound state from all internal cache flags that apply to this resource. func (obj *MsgRes) isAllStateOK() bool { if obj.Journal && !obj.journalStateOK { return false } if obj.Syslog && !obj.syslogStateOK { return false } return obj.logStateOK } // updateStateOK sets the global state so it can be read by the engine. func (obj *MsgRes) updateStateOK() { obj.StateOK(obj.isAllStateOK()) } // JournalPriority converts a string description to a numeric priority. // XXX: Have Validate() make sure it actually is one of these. func (obj *MsgRes) journalPriority() journal.Priority { switch obj.Priority { case "Emerg": return journal.PriEmerg case "Alert": return journal.PriAlert case "Crit": return journal.PriCrit case "Err": return journal.PriErr case "Warning": return journal.PriWarning case "Notice": return journal.PriNotice case "Info": return journal.PriInfo case "Debug": return journal.PriDebug } return journal.PriNotice } // Watch is the primary listener for this resource and it outputs events. func (obj *MsgRes) Watch() error { // notify engine that we're running if err := obj.Running(); err != nil { return err // bubble up a NACK... } var send = false // send event? var exit *error for { select { case event := <-obj.Events(): // we avoid sending events on unpause if exit, send = obj.ReadEvent(event); exit != nil { return *exit // exit } } // do all our event sending all together to avoid duplicate msgs if send { send = false obj.Event() } } } // CheckApply method for Msg resource. // Every check leads to an apply, meaning that the message is flushed to the journal. func (obj *MsgRes) CheckApply(apply bool) (bool, error) { // isStateOK() done by engine, so we updateStateOK() to pass in value //if obj.isAllStateOK() { // return true, nil //} if obj.Refresh() { // if we were notified... // invalidate cached state... obj.logStateOK = false if obj.Journal { obj.journalStateOK = false } if obj.Syslog { obj.syslogStateOK = false } obj.updateStateOK() } if !obj.logStateOK { log.Printf("%s: Body: %s", obj, obj.Body) obj.logStateOK = true obj.updateStateOK() } if !apply { return false, nil } if obj.Journal && !obj.journalStateOK { if err := journal.Send(obj.Body, obj.journalPriority(), obj.Fields); err != nil { return false, err } obj.journalStateOK = true obj.updateStateOK() } if obj.Syslog && !obj.syslogStateOK { // TODO: implement syslog client obj.syslogStateOK = true obj.updateStateOK() } return false, nil } // UIDs includes all params to make a unique identification of this object. // Most resources only return one, although some resources can return multiple. func (obj *MsgRes) UIDs() []ResUID { x := &MsgUID{ BaseUID: BaseUID{ Name: obj.GetName(), Kind: obj.GetKind(), }, body: obj.Body, } return []ResUID{x} } // Compare two resources and return if they are equivalent. func (obj *MsgRes) Compare(r Res) bool { // we can only compare MsgRes to others of the same resource kind res, ok := r.(*MsgRes) if !ok { return false } if !obj.BaseRes.Compare(res) { return false } if obj.Body != res.Body { return false } if obj.Priority != res.Priority { return false } if len(obj.Fields) != len(res.Fields) { return false } for field, value := range obj.Fields { if res.Fields[field] != value { return false } } return true } // UnmarshalYAML is the custom unmarshal handler for this struct. // It is primarily useful for setting the defaults. func (obj *MsgRes) UnmarshalYAML(unmarshal func(interface{}) error) error { type rawRes MsgRes // indirection to avoid infinite recursion def := obj.Default() // get the default res, ok := def.(*MsgRes) // put in the right format if !ok { return fmt.Errorf("could not convert to MsgRes") } raw := rawRes(*res) // convert; the defaults go here if err := unmarshal(&raw); err != nil { return err } *obj = MsgRes(raw) // restore from indirection with type conversion! return nil }