Package google.appengine.logging.v1

Index

LogLine (message)
RequestLog (message)
SourceLocation (message)
SourceReference (message)

LogLine

Application log line emitted while processing a request.

Fields
`time`	`Timestamp` Approximate time when this log entry was made.
`severity`	`LogSeverity` Severity of this log entry.
`log_message`	`string` App-provided log message.
`source_location`	`SourceLocation` Where in the source code this log message was written.

RequestLog

Complete log information about a single HTTP request to an App Engine application.

Fields
`app_id`	`string` Application that handled this request.
`module_id`	`string` Module of the application that handled this request.
`version_id`	`string` Version of the application that handled this request.
`request_id`	`string` Globally unique identifier for a request, which is based on the request start time. Request IDs for requests which started later will compare greater as strings than those for requests which started earlier.
`ip`	`string` Origin IP address.
`start_time`	`Timestamp` Time when the request started.
`end_time`	`Timestamp` Time when the request finished.
`latency`	`Duration` Latency of the request.
`mega_cycles`	`int64` Number of CPU megacycles used to process request.
`method`	`string` Request method. Example: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`, `"DELETE"`.
`resource`	`string` Contains the path and query portion of the URL that was requested. For example, if the URL was "http://example.com/app?name=val", the resource would be "/app?name=val". The fragment identifier, which is identified by the `#` character, is not included.
`http_version`	`string` HTTP version of request. Example: `"HTTP/1.1"`.
`status`	`int32` HTTP response status code. Example: 200, 404.
`response_size`	`int64` Size in bytes sent back to client by request.
`referrer`	`string` Referrer URL of request.
`user_agent`	`string` User agent that made the request.
`nickname`	`string` The logged-in user who made the request. Most likely, this is the part of the user's email before the `@` sign. The field value is the same for different requests from the same user, but different users can have similar names. This information is also available to the application via the App Engine Users API. This field will be populated starting with App Engine 1.9.21.
`url_map_entry`	`string` File or class that handled the request.
`host`	`string` Internet host and port number of the resource being requested.
`cost`	`double` An indication of the relative cost of serving this request.
`task_queue_name`	`string` Queue name of the request, in the case of an offline request.
`task_name`	`string` Task name of the request, in the case of an offline request.
`was_loading_request`	`bool` Whether this was a loading request for the instance.
`pending_time`	`Duration` Time this request spent in the pending request queue.
`instance_index`	`int32` If the instance processing this request belongs to a manually scaled module, then this is the 0-based index of the instance. Otherwise, this value is -1.
`finished`	`bool` Whether this request is finished or active.
`first`	`bool` Whether this is the first `RequestLog` entry for this request. If an active request has several `RequestLog` entries written to Stackdriver Logging, then this field will be set for one of them.
`instance_id`	`string` An identifier for the instance that handled the request.
`line[]`	`LogLine` A list of log lines emitted by the application while serving this request.
`app_engine_release`	`string` App Engine release version.
`trace_id`	`string` Stackdriver Trace identifier for this request.
`span_id`	`string` Stackdriver Trace span identifier for this request.
`trace_sampled`	`bool` If true, the value in the 'trace_id' field was sampled for storage in a trace backend.
`source_reference[]`	`SourceReference` Source code for the application that handled this request. There can be more than one source reference per deployed application if source code is distributed among multiple repositories.

SourceLocation

Specifies a location in a source code file.

Fields

Fields
`file`	`string` Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name.
`line`	`int64` Line within the source file.
`function_name`	`string` Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information is used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function` (Python).

file

string

Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name.

line

int64

Line within the source file.

function_name

string

Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information is used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).

SourceReference

A reference to a particular snapshot of the source tree used to build and deploy an application.

Fields

Fields
`repository`	`string` Optional. A URI string identifying the repository. Example: "https://github.com/GoogleCloudPlatform/kubernetes.git"
`revision_id`	`string` The canonical and persistent identifier of the deployed revision. Example (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"

repository

string

Optional. A URI string identifying the repository. Example: "https://github.com/GoogleCloudPlatform/kubernetes.git"

revision_id

string

The canonical and persistent identifier of the deployed revision. Example (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"