github.com/jiasir/docker@v1.3.3-0.20170609024000-252e610103e7/daemon/logger/gelf/gelf.go (about) 1 // +build linux 2 3 // Package gelf provides the log driver for forwarding server logs to 4 // endpoints that support the Graylog Extended Log Format. 5 package gelf 6 7 import ( 8 "compress/flate" 9 "encoding/json" 10 "fmt" 11 "net" 12 "net/url" 13 "strconv" 14 "time" 15 16 "github.com/Graylog2/go-gelf/gelf" 17 "github.com/Sirupsen/logrus" 18 "github.com/docker/docker/daemon/logger" 19 "github.com/docker/docker/daemon/logger/loggerutils" 20 "github.com/docker/docker/pkg/urlutil" 21 ) 22 23 const name = "gelf" 24 25 type gelfLogger struct { 26 writer *gelf.Writer 27 info logger.Info 28 hostname string 29 rawExtra json.RawMessage 30 } 31 32 func init() { 33 if err := logger.RegisterLogDriver(name, New); err != nil { 34 logrus.Fatal(err) 35 } 36 if err := logger.RegisterLogOptValidator(name, ValidateLogOpt); err != nil { 37 logrus.Fatal(err) 38 } 39 } 40 41 // New creates a gelf logger using the configuration passed in on the 42 // context. The supported context configuration variable is gelf-address. 43 func New(info logger.Info) (logger.Logger, error) { 44 // parse gelf address 45 address, err := parseAddress(info.Config["gelf-address"]) 46 if err != nil { 47 return nil, err 48 } 49 50 // collect extra data for GELF message 51 hostname, err := info.Hostname() 52 if err != nil { 53 return nil, fmt.Errorf("gelf: cannot access hostname to set source field") 54 } 55 56 // parse log tag 57 tag, err := loggerutils.ParseLogTag(info, loggerutils.DefaultTemplate) 58 if err != nil { 59 return nil, err 60 } 61 62 extra := map[string]interface{}{ 63 "_container_id": info.ContainerID, 64 "_container_name": info.Name(), 65 "_image_id": info.ContainerImageID, 66 "_image_name": info.ContainerImageName, 67 "_command": info.Command(), 68 "_tag": tag, 69 "_created": info.ContainerCreated, 70 } 71 72 extraAttrs, err := info.ExtraAttributes(func(key string) string { 73 if key[0] == '_' { 74 return key 75 } 76 return "_" + key 77 }) 78 79 if err != nil { 80 return nil, err 81 } 82 83 for k, v := range extraAttrs { 84 extra[k] = v 85 } 86 87 rawExtra, err := json.Marshal(extra) 88 if err != nil { 89 return nil, err 90 } 91 92 // create new gelfWriter 93 gelfWriter, err := gelf.NewWriter(address) 94 if err != nil { 95 return nil, fmt.Errorf("gelf: cannot connect to GELF endpoint: %s %v", address, err) 96 } 97 98 if v, ok := info.Config["gelf-compression-type"]; ok { 99 switch v { 100 case "gzip": 101 gelfWriter.CompressionType = gelf.CompressGzip 102 case "zlib": 103 gelfWriter.CompressionType = gelf.CompressZlib 104 case "none": 105 gelfWriter.CompressionType = gelf.CompressNone 106 default: 107 return nil, fmt.Errorf("gelf: invalid compression type %q", v) 108 } 109 } 110 111 if v, ok := info.Config["gelf-compression-level"]; ok { 112 val, err := strconv.Atoi(v) 113 if err != nil { 114 return nil, fmt.Errorf("gelf: invalid compression level %s, err %v", v, err) 115 } 116 gelfWriter.CompressionLevel = val 117 } 118 119 return &gelfLogger{ 120 writer: gelfWriter, 121 info: info, 122 hostname: hostname, 123 rawExtra: rawExtra, 124 }, nil 125 } 126 127 func (s *gelfLogger) Log(msg *logger.Message) error { 128 level := gelf.LOG_INFO 129 if msg.Source == "stderr" { 130 level = gelf.LOG_ERR 131 } 132 133 m := gelf.Message{ 134 Version: "1.1", 135 Host: s.hostname, 136 Short: string(msg.Line), 137 TimeUnix: float64(msg.Timestamp.UnixNano()/int64(time.Millisecond)) / 1000.0, 138 Level: level, 139 RawExtra: s.rawExtra, 140 } 141 logger.PutMessage(msg) 142 143 if err := s.writer.WriteMessage(&m); err != nil { 144 return fmt.Errorf("gelf: cannot send GELF message: %v", err) 145 } 146 return nil 147 } 148 149 func (s *gelfLogger) Close() error { 150 return s.writer.Close() 151 } 152 153 func (s *gelfLogger) Name() string { 154 return name 155 } 156 157 // ValidateLogOpt looks for gelf specific log option gelf-address. 158 func ValidateLogOpt(cfg map[string]string) error { 159 for key, val := range cfg { 160 switch key { 161 case "gelf-address": 162 case "tag": 163 case "labels": 164 case "env": 165 case "env-regex": 166 case "gelf-compression-level": 167 i, err := strconv.Atoi(val) 168 if err != nil || i < flate.DefaultCompression || i > flate.BestCompression { 169 return fmt.Errorf("unknown value %q for log opt %q for gelf log driver", val, key) 170 } 171 case "gelf-compression-type": 172 switch val { 173 case "gzip", "zlib", "none": 174 default: 175 return fmt.Errorf("unknown value %q for log opt %q for gelf log driver", val, key) 176 } 177 default: 178 return fmt.Errorf("unknown log opt %q for gelf log driver", key) 179 } 180 } 181 182 _, err := parseAddress(cfg["gelf-address"]) 183 return err 184 } 185 186 func parseAddress(address string) (string, error) { 187 if address == "" { 188 return "", nil 189 } 190 if !urlutil.IsTransportURL(address) { 191 return "", fmt.Errorf("gelf-address should be in form proto://address, got %v", address) 192 } 193 url, err := url.Parse(address) 194 if err != nil { 195 return "", err 196 } 197 198 // we support only udp 199 if url.Scheme != "udp" { 200 return "", fmt.Errorf("gelf: endpoint needs to be UDP") 201 } 202 203 // get host and port 204 if _, _, err = net.SplitHostPort(url.Host); err != nil { 205 return "", fmt.Errorf("gelf: please provide gelf-address as udp://host:port") 206 } 207 208 return url.Host, nil 209 }