package logmon import ( "fmt" "io" "strings" "time" hclog "github.com/hashicorp/go-hclog" "github.com/hashicorp/nomad/client/driver/logging" "github.com/hashicorp/nomad/client/lib/fifo" ) const ( // processOutputCloseTolerance is the length of time we will wait for the // launched process to close its stdout/stderr before we force close it. If // data is written after this tolerance, we will not capture it. processOutputCloseTolerance = 2 * time.Second ) type LogConfig struct { // LogDir is the host path where logs are to be written to LogDir string // StdoutLogFile is the path relative to LogDir for stdout logging StdoutLogFile string // StderrLogFile is the path relative to LogDir for stderr logging StderrLogFile string // StdoutFifo is the path on the host to the stdout pipe StdoutFifo string // StderrFifo is the path on the host to the stderr pipe StderrFifo string // MaxFiles is the max rotated files allowed MaxFiles int // MaxFileSizeMB is the max log file size in MB allowed before rotation occures MaxFileSizeMB int } type LogMon interface { Start(*LogConfig) error Stop() error } func NewLogMon(logger hclog.Logger) LogMon { return &logmonImpl{ logger: logger, } } type logmonImpl struct { logger hclog.Logger tl *TaskLogger } func (l *logmonImpl) Start(cfg *LogConfig) error { tl, err := NewTaskLogger(cfg, l.logger) if err != nil { return err } l.tl = tl return nil } func (l *logmonImpl) Stop() error { if l.tl != nil { l.tl.Close() } return nil } type TaskLogger struct { config *LogConfig // rotator for stdout lro *logRotatorWrapper // rotator for stderr lre *logRotatorWrapper } func (tl *TaskLogger) Close() { if tl.lro != nil { tl.lro.Close() } if tl.lre != nil { tl.lre.Close() } } func NewTaskLogger(cfg *LogConfig, logger hclog.Logger) (*TaskLogger, error) { tl := &TaskLogger{config: cfg} logFileSize := int64(cfg.MaxFileSizeMB * 1024 * 1024) lro, err := logging.NewFileRotator(cfg.LogDir, cfg.StdoutLogFile, cfg.MaxFiles, logFileSize, logger) if err != nil { return nil, fmt.Errorf("failed to create stdout logfile for %q: %v", cfg.StdoutLogFile, err) } wrapperOut, err := newLogRotatorWrapper(cfg.StdoutFifo, logger, lro) if err != nil { return nil, err } tl.lro = wrapperOut lre, err := logging.NewFileRotator(cfg.LogDir, cfg.StderrLogFile, cfg.MaxFiles, logFileSize, logger) if err != nil { return nil, fmt.Errorf("failed to create stderr logfile for %q: %v", cfg.StderrLogFile, err) } wrapperErr, err := newLogRotatorWrapper(cfg.StderrFifo, logger, lre) if err != nil { return nil, err } tl.lre = wrapperErr return tl, nil } // logRotatorWrapper wraps our log rotator and exposes a pipe that can feed the // log rotator data. The processOutWriter should be attached to the process and // data will be copied from the reader to the rotator. type logRotatorWrapper struct { fifoPath string processOutReader io.ReadCloser rotatorWriter *logging.FileRotator hasFinishedCopied chan struct{} logger hclog.Logger } // newLogRotatorWrapper takes a rotator and returns a wrapper that has the // processOutWriter to attach to the stdout or stderr of a process. func newLogRotatorWrapper(path string, logger hclog.Logger, rotator *logging.FileRotator) (*logRotatorWrapper, error) { logger.Info("opening fifo", "path", path) f, err := fifo.New(path) if err != nil { return nil, fmt.Errorf("failed to create fifo for extracting logs: %v", err) } wrap := &logRotatorWrapper{ fifoPath: path, processOutReader: f, rotatorWriter: rotator, hasFinishedCopied: make(chan struct{}), logger: logger, } wrap.start() return wrap, nil } // start starts a goroutine that copies from the pipe into the rotator. This is // called by the constructor and not the user of the wrapper. func (l *logRotatorWrapper) start() { go func() { defer close(l.hasFinishedCopied) _, err := io.Copy(l.rotatorWriter, l.processOutReader) if err != nil { // Close reader to propagate io error across pipe. // Note that this may block until the process exits on // Windows due to // https://github.com/PowerShell/PowerShell/issues/4254 // or similar issues. Since this is already running in // a goroutine its safe to block until the process is // force-killed. l.processOutReader.Close() } }() return } // Close closes the rotator and the process writer to ensure that the Wait // command exits. func (l *logRotatorWrapper) Close() { // Wait up to the close tolerance before we force close select { case <-l.hasFinishedCopied: case <-time.After(processOutputCloseTolerance): } // Closing the read side of a pipe may block on Windows if the process // is being debugged as in: // https://github.com/PowerShell/PowerShell/issues/4254 // The pipe will be closed and cleaned up when the process exits. closeDone := make(chan struct{}) go func() { defer close(closeDone) err := l.processOutReader.Close() if err != nil && !strings.Contains(err.Error(), "file already closed") { l.logger.Warn("error closing read-side of process output pipe", "err", err) } }() select { case <-closeDone: case <-time.After(processOutputCloseTolerance): l.logger.Warn("timed out waiting for read-side of process output pipe to close") } l.rotatorWriter.Close() return }