mirror of https://github.com/EasyDarwin/EasyDarwin
166 lines
4.0 KiB
Markdown
166 lines
4.0 KiB
Markdown
file-rotatelogs
|
|
==================
|
|
|
|
Periodically rotates log files from within the application. Port of [File::RotateLogs](https://metacpan.org/release/File-RotateLogs) from Perl to Go.
|
|
|
|
[](https://travis-ci.org/lestrrat-go/file-rotatelogs)
|
|
|
|
[](https://godoc.org/github.com/lestrrat-go/file-rotatelogs)
|
|
|
|
|
|
# SYNOPSIS
|
|
|
|
```go
|
|
import (
|
|
"log"
|
|
"net/http"
|
|
|
|
apachelog "github.com/lestrrat-go/apache-logformat"
|
|
rotatelogs "github.com/lestrrat-go/file-rotatelogs"
|
|
)
|
|
|
|
func main() {
|
|
mux := http.NewServeMux()
|
|
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { ... })
|
|
|
|
logf, err := rotatelogs.New(
|
|
"/path/to/access_log.%Y%m%d%H%M",
|
|
rotatelogs.WithLinkName("/path/to/access_log"),
|
|
rotatelogs.WithMaxAge(24 * time.Hour),
|
|
rotatelogs.WithRotationTime(time.Hour),
|
|
)
|
|
if err != nil {
|
|
log.Printf("failed to create rotatelogs: %s", err)
|
|
return
|
|
}
|
|
|
|
http.ListenAndServe(":8080", apachelog.Wrap(mux, logf))
|
|
}
|
|
```
|
|
|
|
# DESCRIPTION
|
|
|
|
When you integrate this to to you app, it automatically write to logs that
|
|
are rotated from within the app: No more disk-full alerts because you forgot
|
|
to setup logrotate!
|
|
|
|
To install, simply issue a `go get`:
|
|
|
|
```
|
|
go get github.com/lestrrat-go/file-rotatelogs
|
|
```
|
|
|
|
It's normally expected that this library is used with some other
|
|
logging service, such as the built-in `log` library, or loggers
|
|
such as `github.com/lestrrat-go/apache-logformat`.
|
|
|
|
```go
|
|
import(
|
|
"log"
|
|
"github.com/lestrrat-go/file-rotatelogs"
|
|
)
|
|
|
|
func main() {
|
|
rl, _ := rotatelogs.New("/path/to/access_log.%Y%m%d%H%M")
|
|
|
|
log.SetOutput(rl)
|
|
|
|
/* elsewhere ... */
|
|
log.Printf("Hello, World!")
|
|
}
|
|
```
|
|
|
|
OPTIONS
|
|
====
|
|
|
|
## Pattern (Required)
|
|
|
|
The pattern used to generate actual log file names. You should use patterns
|
|
using the strftime (3) format. For example:
|
|
|
|
```go
|
|
rotatelogs.New("/var/log/myapp/log.%Y%m%d")
|
|
```
|
|
|
|
## Clock (default: rotatelogs.Local)
|
|
|
|
You may specify an object that implements the roatatelogs.Clock interface.
|
|
When this option is supplied, it's used to determine the current time to
|
|
base all of the calculations on. For example, if you want to base your
|
|
calculations in UTC, you may specify rotatelogs.UTC
|
|
|
|
```go
|
|
rotatelogs.New(
|
|
"/var/log/myapp/log.%Y%m%d",
|
|
rotatelogs.WithClock(rotatelogs.UTC),
|
|
)
|
|
```
|
|
|
|
## Location
|
|
|
|
This is an alternative to the `WithClock` option. Instead of providing an
|
|
explicit clock, you can provide a location for you times. We will create
|
|
a Clock object that produces times in your specified location, and configure
|
|
the rotatelog to respect it.
|
|
|
|
## LinkName (default: "")
|
|
|
|
Path where a symlink for the actual log file is placed. This allows you to
|
|
always check at the same location for log files even if the logs were rotated
|
|
|
|
```go
|
|
rotatelogs.New(
|
|
"/var/log/myapp/log.%Y%m%d",
|
|
rotatelogs.WithLinkName("/var/log/myapp/current"),
|
|
)
|
|
```
|
|
|
|
```
|
|
// Else where
|
|
$ tail -f /var/log/myapp/current
|
|
```
|
|
|
|
If not provided, no link will be written.
|
|
|
|
## RotationTime (default: 86400 sec)
|
|
|
|
Interval between file rotation. By default logs are rotated every 86400 seconds.
|
|
Note: Remember to use time.Duration values.
|
|
|
|
```go
|
|
// Rotate every hour
|
|
rotatelogs.New(
|
|
"/var/log/myapp/log.%Y%m%d",
|
|
rotatelogs.WithRotationTime(time.Hour),
|
|
)
|
|
```
|
|
|
|
## MaxAge (default: 7 days)
|
|
|
|
Time to wait until old logs are purged. By default no logs are purged, which
|
|
certainly isn't what you want.
|
|
Note: Remember to use time.Duration values.
|
|
|
|
```go
|
|
// Purge logs older than 1 hour
|
|
rotatelogs.New(
|
|
"/var/log/myapp/log.%Y%m%d",
|
|
rotatelogs.WithMaxAge(time.Hour),
|
|
)
|
|
```
|
|
|
|
## RotationCount (default: -1)
|
|
|
|
The number of files should be kept. By default, this option is disabled.
|
|
|
|
Note: MaxAge should be disabled by specifing `WithMaxAge(-1)` explicitly.
|
|
|
|
```go
|
|
// Purge logs except latest 7 files
|
|
rotatelogs.New(
|
|
"/var/log/myapp/log.%Y%m%d",
|
|
rotatelogs.WithMaxAge(-1),
|
|
rotatelogs.WithRotationCount(7),
|
|
)
|
|
```
|