aboutsummaryrefslogtreecommitdiffhomepage
path: root/third_party/googleapis/google/appengine/logging/v1/request_log.proto
diff options
context:
space:
mode:
Diffstat (limited to 'third_party/googleapis/google/appengine/logging/v1/request_log.proto')
-rw-r--r--third_party/googleapis/google/appengine/logging/v1/request_log.proto190
1 files changed, 190 insertions, 0 deletions
diff --git a/third_party/googleapis/google/appengine/logging/v1/request_log.proto b/third_party/googleapis/google/appengine/logging/v1/request_log.proto
new file mode 100644
index 0000000000..678ea9a5ec
--- /dev/null
+++ b/third_party/googleapis/google/appengine/logging/v1/request_log.proto
@@ -0,0 +1,190 @@
+// Copyright 2016 Google Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.appengine.logging.v1;
+
+import "google/logging/type/log_severity.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/appengine/logging/v1;logging";
+option java_multiple_files = true;
+option java_outer_classname = "RequestLogProto";
+option java_package = "com.google.appengine.logging.v1";
+
+
+// Application log line emitted while processing a request.
+message LogLine {
+ // Approximate time when this log entry was made.
+ google.protobuf.Timestamp time = 1;
+
+ // Severity of this log entry.
+ google.logging.type.LogSeverity severity = 2;
+
+ // App-provided log message.
+ string log_message = 3;
+
+ // Where in the source code this log message was written.
+ SourceLocation source_location = 4;
+}
+
+// Specifies a location in a source code file.
+message SourceLocation {
+ // Source file name. Depending on the runtime environment, this might be a
+ // simple name or a fully-qualified name.
+ string file = 1;
+
+ // Line within the source file.
+ int64 line = 2;
+
+ // 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).
+ string function_name = 3;
+}
+
+// A reference to a particular snapshot of the source tree used to build and
+// deploy an application.
+message SourceReference {
+ // Optional. A URI string identifying the repository.
+ // Example: "https://github.com/GoogleCloudPlatform/kubernetes.git"
+ string repository = 1;
+
+ // The canonical and persistent identifier of the deployed revision.
+ // Example (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"
+ string revision_id = 2;
+}
+
+// Complete log information about a single HTTP request to an App Engine
+// application.
+message RequestLog {
+ // Application that handled this request.
+ string app_id = 1;
+
+ // Module of the application that handled this request.
+ string module_id = 37;
+
+ // Version of the application that handled this request.
+ string version_id = 2;
+
+ // 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.
+ string request_id = 3;
+
+ // Origin IP address.
+ string ip = 4;
+
+ // Time when the request started.
+ google.protobuf.Timestamp start_time = 6;
+
+ // Time when the request finished.
+ google.protobuf.Timestamp end_time = 7;
+
+ // Latency of the request.
+ google.protobuf.Duration latency = 8;
+
+ // Number of CPU megacycles used to process request.
+ int64 mega_cycles = 9;
+
+ // Request method. Example: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`, `"DELETE"`.
+ string method = 10;
+
+ // 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.
+ string resource = 11;
+
+ // HTTP version of request. Example: `"HTTP/1.1"`.
+ string http_version = 12;
+
+ // HTTP response status code. Example: 200, 404.
+ int32 status = 13;
+
+ // Size in bytes sent back to client by request.
+ int64 response_size = 14;
+
+ // Referrer URL of request.
+ string referrer = 15;
+
+ // User agent that made the request.
+ string user_agent = 16;
+
+ // 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.
+ string nickname = 40;
+
+ // File or class that handled the request.
+ string url_map_entry = 17;
+
+ // Internet host and port number of the resource being requested.
+ string host = 20;
+
+ // An indication of the relative cost of serving this request.
+ double cost = 21;
+
+ // Queue name of the request, in the case of an offline request.
+ string task_queue_name = 22;
+
+ // Task name of the request, in the case of an offline request.
+ string task_name = 23;
+
+ // Whether this was a loading request for the instance.
+ bool was_loading_request = 24;
+
+ // Time this request spent in the pending request queue.
+ google.protobuf.Duration pending_time = 25;
+
+ // 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.
+ int32 instance_index = 26;
+
+ // Whether this request is finished or active.
+ bool finished = 27;
+
+ // 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.
+ bool first = 42;
+
+ // An identifier for the instance that handled the request.
+ string instance_id = 28;
+
+ // A list of log lines emitted by the application while serving this request.
+ repeated LogLine line = 29;
+
+ // App Engine release version.
+ string app_engine_release = 38;
+
+ // Stackdriver Trace identifier for this request.
+ string trace_id = 39;
+
+ // 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.
+ repeated SourceReference source_reference = 41;
+}