El paquete de registro

import "google.golang.org/appengine/log"

Introducción

El registro de paquetes proporciona los medios para consultar los registros de una aplicación desde una aplicación de App Engine.

Ejemplo:

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)
}

Índice

Variables
func Criticalf(ctx context.Context, format string, args ...interface{})
func Debugf(ctx context.Context, format string, args ...interface{})
func Errorf(ctx context.Context, format string, args ...interface{})
func Infof(ctx context.Context, format string, args ...interface{})
func Warningf(ctx context.Context, format string, args ...interface{})
type AppLog
type Query
    func (params *Query) Run(c context.Context) *Result
type Record
type Result
    func (qr *Result) Next() (*Record, error)

Variables

var Done = errors.New("log: query has no more results")

Se muestra Done cuando se completa una iteración de la consulta.

func Criticalf

func Criticalf(ctx context.Context, format string, args ...interface{})

Criticalf es como Debugf, pero a un nivel crítico.

func Debugf

func Debugf(ctx context.Context, format string, args ...interface{})

Debugf formatea sus argumentos según el formato análogo a fmt.Printf y registra el texto como un mensaje de registro en el nivel de Debug. El mensaje se asociará con la solicitud vinculada al contexto proporcionado.

func Errorf

func Errorf(ctx context.Context, format string, args ...interface{})

Errorf es como Debugf, pero en el nivel de Error.

func Infof

func Infof(ctx context.Context, format string, args ...interface{})

Infof es como Debugf, pero en el nivel de Info.

func Warningf

func Warningf(ctx context.Context, format string, args ...interface{})

Warningf es como Debugf, pero en el nivel de Warning.

type AppLog

type AppLog struct {
    Time    time.Time
    Level   int
    Message string
}

AppLog representa un registro único a nivel de la aplicación.

type 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 define una consulta de registros.

func (*Query) Run

func (params *Query) Run(c context.Context) *Result

Run inicia una consulta para registros, que contiene información de registro a nivel de la solicitud y la aplicación.

type 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 contiene toda la información para una solicitud web única.

type Result

type Result struct {
    // contains filtered or unexported fields
}

Result representa el resultado de una consulta.

func (*Result) Next

func (qr *Result) Next() (*Record, error)

Next muestra el siguiente registro.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Entorno estándar de App Engine para Go