gogol-logging-0.0.1: Google Cloud Logging SDK.

Copyright(c) 2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.Google.Logging

Contents

Description

Google Cloud Logging API lets you create logs, ingest log entries, and manage log sinks.

See: Google Cloud Logging API Reference

Synopsis

Service Configuration

loggingService :: Service Source

Default request referring to version v2beta1 of the Google Cloud Logging API. This contains the host and root path used as a starting point for constructing service requests.

API Declaration

type LoggingAPI = () Source

Represents the entirety of the methods and resources available for the Google Cloud Logging API service.

Types

RequestLog

data RequestLog Source

Complete log information about a single request to an application.

See: requestLog smart constructor.

rlTraceId :: Lens' RequestLog (Maybe Text) Source

Cloud Trace identifier of the trace for this request.

rlInstanceId :: Lens' RequestLog (Maybe Word8) Source

An opaque identifier for the instance that handled the request.

rlStatus :: Lens' RequestLog (Maybe Int32) Source

Response status of request.

rlRequestId :: Lens' RequestLog (Maybe Word8) Source

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.

rlInstanceIndex :: Lens' RequestLog (Maybe Int32) Source

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.

rlModuleId :: Lens' RequestLog (Maybe Text) Source

Identifies the module of the application that handled this request.

rlVersionId :: Lens' RequestLog (Maybe Text) Source

Version of the application that handled this request.

rlHTTPVersion :: Lens' RequestLog (Maybe Text) Source

HTTP version of request.

rlTaskName :: Lens' RequestLog (Maybe Text) Source

Task name of the request (for an offline request).

rlPendingTime :: Lens' RequestLog (Maybe Text) Source

Time this request spent in the pending request queue, if it was pending at all.

rlWasLoadingRequest :: Lens' RequestLog (Maybe Bool) Source

Was this request a loading request for this instance?

rlStartTime :: Lens' RequestLog (Maybe Text) Source

Time at which request was known to have begun processing.

rlLatency :: Lens' RequestLog (Maybe Text) Source

Latency of the request.

rlURLMapEntry :: Lens' RequestLog (Maybe Text) Source

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.

rlCost :: Lens' RequestLog (Maybe Double) Source

An indication of the relative cost of serving this request.

rlReferrer :: Lens' RequestLog (Maybe Text) Source

Referrer URL of request.

rlLine :: Lens' RequestLog [LogLine] Source

List of log lines emitted by the application while serving this request, if requested.

rlIP :: Lens' RequestLog (Maybe Text) Source

Origin IP address.

rlAppId :: Lens' RequestLog (Maybe Text) Source

Identifies the application that handled this request.

rlMethod :: Lens' RequestLog (Maybe Text) Source

Request method, such as `GET`, `HEAD`, `PUT`, `POST`, or `DELETE`.

rlResource :: Lens' RequestLog (Maybe Text) Source

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.

rlEndTime :: Lens' RequestLog (Maybe Text) Source

Time at which request was known to end processing.

rlFinished :: Lens' RequestLog (Maybe Bool) Source

If true, represents a finished request. Otherwise, the request is active.

rlMegaCycles :: Lens' RequestLog (Maybe Int64) Source

Number of CPU megacycles used to process request.

rlUserAgent :: Lens' RequestLog (Maybe Text) Source

User agent used for making request.

rlNickname :: Lens' RequestLog (Maybe Text) Source

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.

rlHost :: Lens' RequestLog (Maybe Text) Source

The Internet host and port number of the resource being requested.

rlTaskQueueName :: Lens' RequestLog (Maybe Text) Source

Queue name of the request (for an offline request).

rlResponseSize :: Lens' RequestLog (Maybe Int64) Source

Size in bytes sent back to client by request.

rlSourceReference :: Lens' RequestLog [SourceReference] Source

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.

rlAppEngineRelease :: Lens' RequestLog (Maybe Text) Source

App Engine release version string.

LogLine

data LogLine Source

Application log line emitted while processing a request.

See: logLine smart constructor.

logLine :: LogLine Source

Creates a value of LogLine with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

llTime :: Lens' LogLine (Maybe Text) Source

Time when log entry was made. May be inaccurate.

llSeverity :: Lens' LogLine (Maybe Text) Source

Severity of log.

llLogMessage :: Lens' LogLine (Maybe Text) Source

App provided log message.

llSourceLocation :: Lens' LogLine (Maybe SourceLocation) Source

Line of code that generated this log message.

SourceLocation

sourceLocation :: SourceLocation Source

Creates a value of SourceLocation with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

slLine :: Lens' SourceLocation (Maybe Int64) Source

Line within the source file.

slFunctionName :: Lens' SourceLocation (Maybe Text) Source

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 ...

slFile :: Lens' SourceLocation (Maybe Text) Source

Source file name. May or may not be a fully qualified name, depending on the runtime environment.

SourceReference

data SourceReference Source

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

See: sourceReference smart constructor.

sourceReference :: SourceReference Source

Creates a value of SourceReference with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

srRepository :: Lens' SourceReference (Maybe Text) Source

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

srRevisionId :: Lens' SourceReference (Maybe Text) Source

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