README
¶
App Engine Logger
This is Logger for App Engine 2nd Generation. App Engine Plain Logger only supports structured logging (ref: https://cloud.google.com/logging/docs/structured-logging), so this does not support logging experience which proprietary App Engine API provided.
How to use
mux := http.NewServeMux()
mux.HandleFunc("/", func(writer http.ResponseWriter, request *http.Request) {
ctx := request.Context()
aelog.Infof(ctx, "some log message")
})
h := middleware.AELogger("ServeHTTP")(mux)
if err := http.ListenAndServe(fmt.Sprintf(":%s", port), h); err != nil {
panic(err)
}
License
MIT
Documentation
¶
Overview ¶
Package aelog provides the structured log of an application's logs from within an App Engine application.
Example:
ctx := r.Context() // r is *http.Request aelog.Infof(ctx, "info log. requestURL: %s", r.URL.String())
Index ¶
- func Criticalf(ctx context.Context, format string, a ...interface{})
- func Debugf(ctx context.Context, format string, a ...interface{})
- func Errorf(ctx context.Context, format string, a ...interface{})
- func Infof(ctx context.Context, format string, a ...interface{})
- func OutputJSON(ctx context.Context, severity, format string, a ...interface{})
- func OutputText(ctx context.Context, severity, format string, a ...interface{})
- func SetOutput(f func(context.Context, string, string, ...interface{}))
- func Warningf(ctx context.Context, format string, a ...interface{})
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Criticalf ¶
Criticalf is like Debugf, but the severity is critical level.
Example ¶
ctx := trace.NewContext(context.Background(), nil) Criticalf(ctx, "Criticalf: %s", "Sample Text")
Output: {"severity":"CRITICAL","message":"Criticalf: Sample Text","logging.googleapis.com/trace":"projects//traces/00000000000000000000000000000000","logging.googleapis.com/spanId":"0000000000000000"}
func Debugf ¶
Debugf formats its arguments according to the format, analogous to fmt.Printf, and records the text as log message at debug level. The log message will be associated with the platform request linked with the context.
Example ¶
ctx := trace.NewContext(context.Background(), nil) Debugf(ctx, "Debugf: %s", "Sample Text")
Output: {"severity":"DEBUG","message":"Debugf: Sample Text","logging.googleapis.com/trace":"projects//traces/00000000000000000000000000000000","logging.googleapis.com/spanId":"0000000000000000"}
func Errorf ¶
Errorf is like Debugf, but the severity is error level.
Example ¶
ctx := trace.NewContext(context.Background(), nil) Errorf(ctx, "Errorf: %s", "Sample Text")
Output: {"severity":"ERROR","message":"Errorf: Sample Text","logging.googleapis.com/trace":"projects//traces/00000000000000000000000000000000","logging.googleapis.com/spanId":"0000000000000000"}
func Infof ¶
Infof is like Debugf, but the severity is info level.
Example ¶
ctx := trace.NewContext(context.Background(), nil) Infof(ctx, "Infof: %s", "Sample Text")
Output: {"severity":"INFO","message":"Infof: Sample Text","logging.googleapis.com/trace":"projects//traces/00000000000000000000000000000000","logging.googleapis.com/spanId":"0000000000000000"}
func OutputJSON ¶
OutputJSON fills the fields required with the structured log described in https://cloud.google.com/logging/docs/agent/configuration#special-fields and outputs the log in json format.
func OutputText ¶
OutputText outputs log using standard log package.
func SetOutput ¶
SetOutput allows to set the log output format. The default log setting is json format.
func Warningf ¶
Warningf is like Debugf, but the severity is warning level.
Example ¶
ctx := trace.NewContext(context.Background(), nil) Warningf(ctx, "Warningf: %s", "Sample Text")
Output: {"severity":"WARNING","message":"Warningf: Sample Text","logging.googleapis.com/trace":"projects//traces/00000000000000000000000000000000","logging.googleapis.com/spanId":"0000000000000000"}
Types ¶
This section is empty.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
Package middleware provides the http.Handler with spancontext.
|
Package middleware provides the http.Handler with spancontext. |