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  }