blob: 405d244259d9c41baf46d3beeef65ba0d74132c5 [file] [log] [blame]
{
"kind": "discovery#restDescription",
"etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/Dl8jzEbCLfW8aU_OmsbXBqEUy5Y\"",
"discoveryVersion": "v1",
"id": "logging:v2beta1",
"name": "logging",
"version": "v2beta1",
"revision": "20151007",
"title": "Google Cloud Logging API",
"description": "Google Cloud Logging API lets you create logs, ingest log entries, and manage log sinks.",
"ownerDomain": "google.com",
"ownerName": "Google",
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"documentationLink": "https://cloud.google.com/logging/docs/",
"protocol": "rest",
"baseUrl": "https://logging.googleapis.com/",
"basePath": "/",
"rootUrl": "https://logging.googleapis.com/",
"servicePath": "",
"batchPath": "batch",
"parameters": {
"access_token": {
"type": "string",
"description": "OAuth access token.",
"location": "query"
},
"alt": {
"type": "string",
"description": "Data format for response.",
"default": "json",
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query"
},
"bearer_token": {
"type": "string",
"description": "OAuth bearer token.",
"location": "query"
},
"callback": {
"type": "string",
"description": "JSONP",
"location": "query"
},
"fields": {
"type": "string",
"description": "Selector specifying which fields to include in a partial response.",
"location": "query"
},
"key": {
"type": "string",
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query"
},
"oauth_token": {
"type": "string",
"description": "OAuth 2.0 token for the current user.",
"location": "query"
},
"pp": {
"type": "boolean",
"description": "Pretty-print response.",
"default": "true",
"location": "query"
},
"prettyPrint": {
"type": "boolean",
"description": "Returns response with indentations and line breaks.",
"default": "true",
"location": "query"
},
"quotaUser": {
"type": "string",
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query"
},
"upload_protocol": {
"type": "string",
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query"
},
"uploadType": {
"type": "string",
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query"
},
"$.xgafv": {
"type": "string",
"description": "V1 error format.",
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query"
}
},
"schemas": {
"RequestLog": {
"id": "RequestLog",
"type": "object",
"description": "Complete log information about a single request to an application.",
"properties": {
"appId": {
"type": "string",
"description": "Identifies the application that handled this request."
},
"moduleId": {
"type": "string",
"description": "Identifies the module of the application that handled this request."
},
"versionId": {
"type": "string",
"description": "Version of the application that handled this request."
},
"requestId": {
"type": "string",
"description": "Globally unique identifier for a request, based on request start time. Request IDs for requests which started later will compare greater as binary strings than those for requests which started earlier.",
"format": "byte"
},
"ip": {
"type": "string",
"description": "Origin IP address."
},
"startTime": {
"type": "string",
"description": "Time at which request was known to have begun processing."
},
"endTime": {
"type": "string",
"description": "Time at which request was known to end processing."
},
"latency": {
"type": "string",
"description": "Latency of the request."
},
"megaCycles": {
"type": "string",
"description": "Number of CPU megacycles used to process request.",
"format": "int64"
},
"method": {
"type": "string",
"description": "Request method, such as `GET`, `HEAD`, `PUT`, `POST`, or `DELETE`."
},
"resource": {
"type": "string",
"description": "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\". Any trailing fragment (separated by a '#' character) will not be included."
},
"httpVersion": {
"type": "string",
"description": "HTTP version of request."
},
"status": {
"type": "integer",
"description": "Response status of request.",
"format": "int32"
},
"responseSize": {
"type": "string",
"description": "Size in bytes sent back to client by request.",
"format": "int64"
},
"referrer": {
"type": "string",
"description": "Referrer URL of request."
},
"userAgent": {
"type": "string",
"description": "User agent used for making request."
},
"nickname": {
"type": "string",
"description": "A string that identifies a logged-in user who made this request, or empty if the user is not logged in. 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 may have a similar name. This information is also available to the application via Users API. This field will be populated starting with App Engine 1.9.21."
},
"urlMapEntry": {
"type": "string",
"description": "File or class within URL mapping used for request. Useful for tracking down the source code which was responsible for managing request. Especially for multiply mapped handlers."
},
"host": {
"type": "string",
"description": "The Internet host and port number of the resource being requested."
},
"cost": {
"type": "number",
"description": "An indication of the relative cost of serving this request.",
"format": "double"
},
"taskQueueName": {
"type": "string",
"description": "Queue name of the request (for an offline request)."
},
"taskName": {
"type": "string",
"description": "Task name of the request (for an offline request)."
},
"wasLoadingRequest": {
"type": "boolean",
"description": "Was this request a loading request for this instance?"
},
"pendingTime": {
"type": "string",
"description": "Time this request spent in the pending request queue, if it was pending at all."
},
"instanceIndex": {
"type": "integer",
"description": "If the instance that processed this request was individually addressable (i.e. belongs to a manually scaled module), this is the index of the instance.",
"format": "int32"
},
"finished": {
"type": "boolean",
"description": "If true, represents a finished request. Otherwise, the request is active."
},
"instanceId": {
"type": "string",
"description": "An opaque identifier for the instance that handled the request.",
"format": "byte"
},
"line": {
"type": "array",
"description": "List of log lines emitted by the application while serving this request, if requested.",
"items": {
"$ref": "LogLine"
}
},
"appEngineRelease": {
"type": "string",
"description": "App Engine release version string."
},
"traceId": {
"type": "string",
"description": "Cloud Trace identifier of the trace for this request."
},
"sourceReference": {
"type": "array",
"description": "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.",
"items": {
"$ref": "SourceReference"
}
}
}
},
"LogLine": {
"id": "LogLine",
"type": "object",
"description": "Application log line emitted while processing a request.",
"properties": {
"time": {
"type": "string",
"description": "Time when log entry was made. May be inaccurate."
},
"severity": {
"type": "string",
"description": "Severity of log.",
"enum": [
"DEFAULT",
"DEBUG",
"INFO",
"NOTICE",
"WARNING",
"ERROR",
"CRITICAL",
"ALERT",
"EMERGENCY"
]
},
"logMessage": {
"type": "string",
"description": "App provided log message."
},
"sourceLocation": {
"$ref": "SourceLocation",
"description": "Line of code that generated this log message."
}
}
},
"SourceLocation": {
"id": "SourceLocation",
"type": "object",
"description": "Specifies a location in a source file.",
"properties": {
"file": {
"type": "string",
"description": "Source file name. May or may not be a fully qualified name, depending on the runtime environment."
},
"line": {
"type": "string",
"description": "Line within the source file.",
"format": "int64"
},
"functionName": {
"type": "string",
"description": "Human-readable name of the function or method being invoked, with optional context such as the class or package name, for use in contexts such as the logs viewer where file:line number is less meaningful. This may vary by language, for example: in Java: qual.if.ied.Class.method in Go: dir/package.func in Python: function ..."
}
}
},
"SourceReference": {
"id": "SourceReference",
"type": "object",
"description": "A reference to a particular snapshot of the source tree used to build and deploy an application.",
"properties": {
"repository": {
"type": "string",
"description": "Optional. A URI string identifying the repository. Example: \"https://github.com/GoogleCloudPlatform/kubernetes.git\""
},
"revisionId": {
"type": "string",
"description": "The canonical (and persistent) identifier of the deployed revision. Example (git): \"0035781c50ec7aa23385dc841529ce8a4b70db1b\""
}
}
}
}
}