Package log provides the means of writing and querying an application's logs from within an App Engine application.
Example:
c := appengine . NewContext ( r ) query := & log . Query { AppLogs : true , Versions : [] string { "1" } , } for results := query . Run ( c ); ; { record , err := results . Next () if err == log . Done { log . Infof ( c , "Done processing results" ) break } if err ! = nil { log . Errorf ( c , "Failed to retrieve next log: %v" , err ) break } log . Infof ( c , "Saw record %v" , record ) }
Variables
Done
Done is returned when a query iteration has completed.
Functions
func Criticalf
Criticalf is like Debugf, but at Critical level.
func Debugf
Debugf formats its arguments according to the format, analogous to fmt.Printf, and records the text as a log message at Debug level. The message will be associated with the request linked with the provided context.
func Errorf
Errorf is like Debugf, but at Error level.
func Infof
Infof is like Debugf, but at Info level.
func Warningf
Warningf is like Debugf, but at Warning level.
AppLog
AppLog represents a single application-level log.
Query
type
Query
struct
{
// Start time specifies the earliest log to return (inclusive).
StartTime
time
.
Time
// End time specifies the latest log to return (exclusive).
EndTime
time
.
Time
// Offset specifies a position within the log stream to resume reading from,
// and should come from a previously returned Record's field of the same name.
Offset
[]
byte
// Incomplete controls whether active (incomplete) requests should be included.
Incomplete
bool
// AppLogs indicates if application-level logs should be included.
AppLogs
bool
// ApplyMinLevel indicates if MinLevel should be used to filter results.
ApplyMinLevel
bool
// If ApplyMinLevel is true, only logs for requests with at least one
// application log of MinLevel or higher will be returned.
MinLevel
int
// Versions is the major version IDs whose logs should be retrieved.
// Logs for specific modules can be retrieved by the specifying versions
// in the form "module:version"; the default module is used if no module
// is specified.
Versions
[]
string
// A list of requests to search for instead of a time-based scan. Cannot be
// combined with filtering options such as StartTime, EndTime, Offset,
// Incomplete, ApplyMinLevel, or Versions.
RequestIDs
[]
string
}
Query defines a logs query.
func (*Query) Run
Run starts a query for log records, which contain request and application level log information.
Record
type
Record
struct
{
AppID
string
ModuleID
string
VersionID
string
RequestID
[]
byte
IP
string
Nickname
string
AppEngineRelease
string
//
The
time
when
this
request
started
.
StartTime
time
.
Time
//
The
time
when
this
request
finished
.
EndTime
time
.
Time
//
Opaque
cursor
into
the
result
stream
.
Offset
[]
byte
//
The
time
required
to
process
the
request
.
Latency
time
.
Duration
MCycles
int64
Method
string
Resource
string
HTTPVersion
string
Status
int32
//
The
size
of
the
request
sent
back
to
the
client
,
in
bytes
.
ResponseSize
int64
Referrer
string
UserAgent
string
URLMapEntry
string
Combined
string
Host
string
//
The
estimated
cost
of
this
request
,
in
dollars
.
Cost
float64
TaskQueueName
string
TaskName
string
WasLoadingRequest
bool
PendingTime
time
.
Duration
Finished
bool
AppLogs
[]
AppLog
//
Mostly
-
unique
identifier
for
the
instance
that
handled
the
request
if
available
.
InstanceID
string
}
Record contains all the information for a single web request.
Result
type
Result
struct
{
//
contains
filtered
or
unexported
fields
}
Result represents the result of a query.
func (*Result) Next
Next returns the next log record,
