logging

package
v0.0.0-...-c8d75a8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 21, 2016 License: BSD-3-Clause Imports: 13 Imported by: 0

Documentation

Overview

Package logging provides access to the Stackdriver Logging API.

See https://cloud.google.com/logging/docs/

Usage example:

import "google.golang.org/api/logging/v2"
...
loggingService, err := logging.New(oauthHttpClient)

Index

Constants

View Source
const (
	// View and manage your data across Google Cloud Platform services
	CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"

	// View your data across Google Cloud Platform services
	CloudPlatformReadOnlyScope = "https://www.googleapis.com/auth/cloud-platform.read-only"

	// Administrate log data for your projects
	LoggingAdminScope = "https://www.googleapis.com/auth/logging.admin"

	// View log data for your projects
	LoggingReadScope = "https://www.googleapis.com/auth/logging.read"

	// Submit log data for your projects
	LoggingWriteScope = "https://www.googleapis.com/auth/logging.write"
)

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

type BillingAccountsLogsDeleteCall

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

func (*BillingAccountsLogsDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*BillingAccountsLogsDeleteCall) Do

Do executes the "logging.billingAccounts.logs.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BillingAccountsLogsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*BillingAccountsLogsDeleteCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type BillingAccountsLogsService

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

func NewBillingAccountsLogsService

func NewBillingAccountsLogsService(s *Service) *BillingAccountsLogsService

func (*BillingAccountsLogsService) Delete

Delete: Deletes a log and all its log entries. The log will reappear if it receives new entries.

type BillingAccountsService

type BillingAccountsService struct {
	Logs *BillingAccountsLogsService

	Sinks *BillingAccountsSinksService
	// contains filtered or unexported fields
}

func NewBillingAccountsService

func NewBillingAccountsService(s *Service) *BillingAccountsService

type BillingAccountsSinksCreateCall

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

func (*BillingAccountsSinksCreateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*BillingAccountsSinksCreateCall) Do

Do executes the "logging.billingAccounts.sinks.create" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BillingAccountsSinksCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*BillingAccountsSinksCreateCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*BillingAccountsSinksCreateCall) UniqueWriterIdentity

func (c *BillingAccountsSinksCreateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *BillingAccountsSinksCreateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type BillingAccountsSinksDeleteCall

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

func (*BillingAccountsSinksDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*BillingAccountsSinksDeleteCall) Do

Do executes the "logging.billingAccounts.sinks.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BillingAccountsSinksDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*BillingAccountsSinksDeleteCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type BillingAccountsSinksGetCall

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

func (*BillingAccountsSinksGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*BillingAccountsSinksGetCall) Do

Do executes the "logging.billingAccounts.sinks.get" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BillingAccountsSinksGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*BillingAccountsSinksGetCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*BillingAccountsSinksGetCall) IfNoneMatch

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type BillingAccountsSinksListCall

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

func (*BillingAccountsSinksListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*BillingAccountsSinksListCall) Do

Do executes the "logging.billingAccounts.sinks.list" call. Exactly one of *ListSinksResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListSinksResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BillingAccountsSinksListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*BillingAccountsSinksListCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*BillingAccountsSinksListCall) IfNoneMatch

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*BillingAccountsSinksListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.

func (*BillingAccountsSinksListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.

func (*BillingAccountsSinksListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type BillingAccountsSinksService

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

func NewBillingAccountsSinksService

func NewBillingAccountsSinksService(s *Service) *BillingAccountsSinksService

func (*BillingAccountsSinksService) Create

Create: Creates a sink.

func (*BillingAccountsSinksService) Delete

Delete: Deletes a sink.

func (*BillingAccountsSinksService) Get

Get: Gets a sink.

func (*BillingAccountsSinksService) List

List: Lists sinks.

func (*BillingAccountsSinksService) Update

Update: Updates or creates a sink.

type BillingAccountsSinksUpdateCall

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

func (*BillingAccountsSinksUpdateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*BillingAccountsSinksUpdateCall) Do

Do executes the "logging.billingAccounts.sinks.update" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BillingAccountsSinksUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*BillingAccountsSinksUpdateCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*BillingAccountsSinksUpdateCall) UniqueWriterIdentity

func (c *BillingAccountsSinksUpdateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *BillingAccountsSinksUpdateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type Empty

type Empty struct {
	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`
}

Empty: A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:

service Foo {
  rpc Bar(google.protobuf.Empty) returns

(google.protobuf.Empty);

}

The JSON representation for `Empty` is empty JSON object `{}`.

type EntriesListCall

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

func (*EntriesListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*EntriesListCall) Do

Do executes the "logging.entries.list" call. Exactly one of *ListLogEntriesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListLogEntriesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*EntriesListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*EntriesListCall) Header

func (c *EntriesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type EntriesService

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

func NewEntriesService

func NewEntriesService(s *Service) *EntriesService

func (*EntriesService) List

func (r *EntriesService) List(listlogentriesrequest *ListLogEntriesRequest) *EntriesListCall

List: Lists log entries. Use this method to retrieve log entries from Cloud Logging. For ways to export log entries, see [Exporting Logs](/logging/docs/export).

func (*EntriesService) Write

func (r *EntriesService) Write(writelogentriesrequest *WriteLogEntriesRequest) *EntriesWriteCall

Write: Writes log entries to Stackdriver Logging. All log entries are written by this method.

type EntriesWriteCall

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

func (*EntriesWriteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*EntriesWriteCall) Do

Do executes the "logging.entries.write" call. Exactly one of *WriteLogEntriesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *WriteLogEntriesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*EntriesWriteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*EntriesWriteCall) Header

func (c *EntriesWriteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type FoldersLogsDeleteCall

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

func (*FoldersLogsDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*FoldersLogsDeleteCall) Do

Do executes the "logging.folders.logs.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*FoldersLogsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*FoldersLogsDeleteCall) Header

func (c *FoldersLogsDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type FoldersLogsService

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

func NewFoldersLogsService

func NewFoldersLogsService(s *Service) *FoldersLogsService

func (*FoldersLogsService) Delete

func (r *FoldersLogsService) Delete(logName string) *FoldersLogsDeleteCall

Delete: Deletes a log and all its log entries. The log will reappear if it receives new entries.

type FoldersService

type FoldersService struct {
	Logs *FoldersLogsService

	Sinks *FoldersSinksService
	// contains filtered or unexported fields
}

func NewFoldersService

func NewFoldersService(s *Service) *FoldersService

type FoldersSinksCreateCall

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

func (*FoldersSinksCreateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*FoldersSinksCreateCall) Do

Do executes the "logging.folders.sinks.create" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*FoldersSinksCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*FoldersSinksCreateCall) Header

func (c *FoldersSinksCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*FoldersSinksCreateCall) UniqueWriterIdentity

func (c *FoldersSinksCreateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *FoldersSinksCreateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type FoldersSinksDeleteCall

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

func (*FoldersSinksDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*FoldersSinksDeleteCall) Do

Do executes the "logging.folders.sinks.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*FoldersSinksDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*FoldersSinksDeleteCall) Header

func (c *FoldersSinksDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type FoldersSinksGetCall

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

func (*FoldersSinksGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*FoldersSinksGetCall) Do

Do executes the "logging.folders.sinks.get" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*FoldersSinksGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*FoldersSinksGetCall) Header

func (c *FoldersSinksGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*FoldersSinksGetCall) IfNoneMatch

func (c *FoldersSinksGetCall) IfNoneMatch(entityTag string) *FoldersSinksGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type FoldersSinksListCall

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

func (*FoldersSinksListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*FoldersSinksListCall) Do

Do executes the "logging.folders.sinks.list" call. Exactly one of *ListSinksResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListSinksResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*FoldersSinksListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*FoldersSinksListCall) Header

func (c *FoldersSinksListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*FoldersSinksListCall) IfNoneMatch

func (c *FoldersSinksListCall) IfNoneMatch(entityTag string) *FoldersSinksListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*FoldersSinksListCall) PageSize

func (c *FoldersSinksListCall) PageSize(pageSize int64) *FoldersSinksListCall

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.

func (*FoldersSinksListCall) PageToken

func (c *FoldersSinksListCall) PageToken(pageToken string) *FoldersSinksListCall

PageToken sets the optional parameter "pageToken": If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.

func (*FoldersSinksListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type FoldersSinksService

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

func NewFoldersSinksService

func NewFoldersSinksService(s *Service) *FoldersSinksService

func (*FoldersSinksService) Create

func (r *FoldersSinksService) Create(parent string, logsink *LogSink) *FoldersSinksCreateCall

Create: Creates a sink.

func (*FoldersSinksService) Delete

func (r *FoldersSinksService) Delete(sinkNameid string) *FoldersSinksDeleteCall

Delete: Deletes a sink.

func (*FoldersSinksService) Get

Get: Gets a sink.

func (*FoldersSinksService) List

List: Lists sinks.

func (*FoldersSinksService) Update

func (r *FoldersSinksService) Update(sinkNameid string, logsink *LogSink) *FoldersSinksUpdateCall

Update: Updates or creates a sink.

type FoldersSinksUpdateCall

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

func (*FoldersSinksUpdateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*FoldersSinksUpdateCall) Do

Do executes the "logging.folders.sinks.update" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*FoldersSinksUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*FoldersSinksUpdateCall) Header

func (c *FoldersSinksUpdateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*FoldersSinksUpdateCall) UniqueWriterIdentity

func (c *FoldersSinksUpdateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *FoldersSinksUpdateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type HttpRequest

type HttpRequest struct {
	// CacheFillBytes: The number of HTTP response bytes inserted into
	// cache. Set only when a
	// cache fill was attempted.
	CacheFillBytes int64 `json:"cacheFillBytes,omitempty,string"`

	// CacheHit: Whether or not an entity was served from cache
	// (with or without validation).
	CacheHit bool `json:"cacheHit,omitempty"`

	// CacheLookup: Whether or not a cache lookup was attempted.
	CacheLookup bool `json:"cacheLookup,omitempty"`

	// CacheValidatedWithOriginServer: Whether or not the response was
	// validated with the origin server before
	// being served from cache. This field is only meaningful if `cache_hit`
	// is
	// True.
	CacheValidatedWithOriginServer bool `json:"cacheValidatedWithOriginServer,omitempty"`

	// Latency: The request processing latency on the server, from the time
	// the request was
	// received until the response was sent.
	Latency string `json:"latency,omitempty"`

	// Referer: The referer URL of the request, as defined in
	// [HTTP/1.1 Header Field
	// Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
	Referer string `json:"referer,omitempty"`

	// RemoteIp: The IP address (IPv4 or IPv6) of the client that issued the
	// HTTP
	// request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
	RemoteIp string `json:"remoteIp,omitempty"`

	// RequestMethod: The request method. Examples: "GET", "HEAD",
	// "PUT", "POST".
	RequestMethod string `json:"requestMethod,omitempty"`

	// RequestSize: The size of the HTTP request message in bytes, including
	// the request
	// headers and the request body.
	RequestSize int64 `json:"requestSize,omitempty,string"`

	// RequestUrl: The scheme (http, https), the host name, the path and the
	// query
	// portion of the URL that was requested.
	// Example: "http://example.com/some/info?color=red".
	RequestUrl string `json:"requestUrl,omitempty"`

	// ResponseSize: The size of the HTTP response message sent back to the
	// client, in bytes,
	// including the response headers and the response body.
	ResponseSize int64 `json:"responseSize,omitempty,string"`

	// ServerIp: The IP address (IPv4 or IPv6) of the origin server that the
	// request was
	// sent to.
	ServerIp string `json:"serverIp,omitempty"`

	// Status: The response code indicating the status of
	// response.
	// Examples: 200, 404.
	Status int64 `json:"status,omitempty"`

	// UserAgent: The user agent sent by the client. Example:
	// "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR
	// 1.0.3705)".
	UserAgent string `json:"userAgent,omitempty"`

	// ForceSendFields is a list of field names (e.g. "CacheFillBytes") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "CacheFillBytes") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

HttpRequest: A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message.

func (*HttpRequest) MarshalJSON

func (s *HttpRequest) MarshalJSON() ([]byte, error)

type LabelDescriptor

type LabelDescriptor struct {
	// Description: A human-readable description for the label.
	Description string `json:"description,omitempty"`

	// Key: The label key.
	Key string `json:"key,omitempty"`

	// ValueType: The type of data that can be assigned to the label.
	//
	// Possible values:
	//   "STRING" - A variable-length string. This is the default.
	//   "BOOL" - Boolean; true or false.
	//   "INT64" - A 64-bit signed integer.
	ValueType string `json:"valueType,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Description") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Description") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

LabelDescriptor: A description of a label.

func (*LabelDescriptor) MarshalJSON

func (s *LabelDescriptor) MarshalJSON() ([]byte, error)

type ListLogEntriesRequest

type ListLogEntriesRequest struct {
	// Filter: Optional. A filter that chooses which log entries to return.
	// See [Advanced
	// Logs Filters](/logging/docs/view/advanced_filters).  Only log entries
	// that
	// match the filter are returned.  An empty filter matches all log
	// entries.
	// The maximum length of the filter is 20000 characters.
	Filter string `json:"filter,omitempty"`

	// OrderBy: Optional. How the results should be sorted.  Presently, the
	// only permitted
	// values are "timestamp asc" (default) and "timestamp desc". The
	// first
	// option returns entries in order of increasing values
	// of
	// `LogEntry.timestamp` (oldest first), and the second option returns
	// entries
	// in order of decreasing timestamps (newest first).  Entries with
	// equal
	// timestamps are returned in order of `LogEntry.insertId`.
	OrderBy string `json:"orderBy,omitempty"`

	// PageSize: Optional. The maximum number of results to return from this
	// request.
	// Non-positive values are ignored.  The presence of `nextPageToken` in
	// the
	// response indicates that more results might be available.
	PageSize int64 `json:"pageSize,omitempty"`

	// PageToken: Optional. If present, then retrieve the next batch of
	// results from the
	// preceding call to this method.  `pageToken` must be the value
	// of
	// `nextPageToken` from the previous response.  The values of other
	// method
	// parameters should be identical to those in the previous call.
	PageToken string `json:"pageToken,omitempty"`

	// ProjectIds: Deprecated. One or more project identifiers or project
	// numbers from which
	// to retrieve log entries.  Examples: "my-project-1A",
	// "1234567890". If
	// present, these project identifiers are converted to resource format
	// and
	// added to the list of resources in `resourceNames`. Callers should
	// use
	// `resourceNames` rather than this parameter.
	ProjectIds []string `json:"projectIds,omitempty"`

	// ResourceNames: Required. One or more cloud resources from which to
	// retrieve log entries.
	// Example: "projects/my-project-1A", "projects/1234567890".
	// Projects
	// listed in `projectIds` are added to this list.
	ResourceNames []string `json:"resourceNames,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Filter") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Filter") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ListLogEntriesRequest: The parameters to `ListLogEntries`.

func (*ListLogEntriesRequest) MarshalJSON

func (s *ListLogEntriesRequest) MarshalJSON() ([]byte, error)

type ListLogEntriesResponse

type ListLogEntriesResponse struct {
	// Entries: A list of log entries.
	Entries []*LogEntry `json:"entries,omitempty"`

	// NextPageToken: If there might be more results than appear in this
	// response, then
	// `nextPageToken` is included.  To get the next set of results, call
	// this
	// method again using the value of `nextPageToken` as `pageToken`.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Entries") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Entries") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ListLogEntriesResponse: Result returned from `ListLogEntries`.

func (*ListLogEntriesResponse) MarshalJSON

func (s *ListLogEntriesResponse) MarshalJSON() ([]byte, error)

type ListLogMetricsResponse

type ListLogMetricsResponse struct {
	// Metrics: A list of logs-based metrics.
	Metrics []*LogMetric `json:"metrics,omitempty"`

	// NextPageToken: If there might be more results than appear in this
	// response, then
	// `nextPageToken` is included.  To get the next set of results, call
	// this
	// method again using the value of `nextPageToken` as `pageToken`.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Metrics") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Metrics") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ListLogMetricsResponse: Result returned from ListLogMetrics.

func (*ListLogMetricsResponse) MarshalJSON

func (s *ListLogMetricsResponse) MarshalJSON() ([]byte, error)

type ListMonitoredResourceDescriptorsResponse

type ListMonitoredResourceDescriptorsResponse struct {
	// NextPageToken: If there might be more results than appear in this
	// response, then
	// `nextPageToken` is included.  To get the next set of results, call
	// this
	// method again using the value of `nextPageToken` as `pageToken`.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// ResourceDescriptors: A list of resource descriptors.
	ResourceDescriptors []*MonitoredResourceDescriptor `json:"resourceDescriptors,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "NextPageToken") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ListMonitoredResourceDescriptorsResponse: Result returned from ListMonitoredResourceDescriptors.

func (*ListMonitoredResourceDescriptorsResponse) MarshalJSON

func (s *ListMonitoredResourceDescriptorsResponse) MarshalJSON() ([]byte, error)

type ListSinksResponse

type ListSinksResponse struct {
	// NextPageToken: If there might be more results than appear in this
	// response, then
	// `nextPageToken` is included.  To get the next set of results, call
	// the same
	// method again using the value of `nextPageToken` as `pageToken`.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// Sinks: A list of sinks.
	Sinks []*LogSink `json:"sinks,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "NextPageToken") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ListSinksResponse: Result returned from `ListSinks`.

func (*ListSinksResponse) MarshalJSON

func (s *ListSinksResponse) MarshalJSON() ([]byte, error)

type LogEntry

type LogEntry struct {
	// HttpRequest: Optional. Information about the HTTP request associated
	// with this
	// log entry, if applicable.
	HttpRequest *HttpRequest `json:"httpRequest,omitempty"`

	// InsertId: Optional. A unique ID for the log entry. If you provide
	// this
	// field, the logging service considers other log entries in the
	// same project with the same ID as duplicates which can be removed.
	// If
	// omitted, Stackdriver Logging will generate a unique ID for this
	// log entry.
	InsertId string `json:"insertId,omitempty"`

	// JsonPayload: The log entry payload, represented as a structure
	// that
	// is expressed as a JSON object.
	JsonPayload LogEntryJsonPayload `json:"jsonPayload,omitempty"`

	// Labels: Optional. A set of user-defined (key, value) data that
	// provides additional
	// information about the log entry.
	Labels map[string]string `json:"labels,omitempty"`

	// LogName: Required. The resource name of the log to which this log
	// entry
	// belongs. The format of the name
	// is
	// "projects/<project-id>/logs/<log-id>".
	// Examples:
	// "projects/my-projectid/logs/syslog",
	// "projects/my-project
	// id/logs/library.googleapis.com%2Fbook_log".
	//
	// The log ID part of resource name must be less than 512
	// characters
	// long and can only include the following characters: upper and
	// lower case alphanumeric characters: [A-Za-z0-9]; and
	// punctuation
	// characters: forward-slash, underscore, hyphen, and
	// period.
	// Forward-slash (`/`) characters in the log ID must be URL-encoded.
	LogName string `json:"logName,omitempty"`

	// Operation: Optional. Information about an operation associated with
	// the log entry, if
	// applicable.
	Operation *LogEntryOperation `json:"operation,omitempty"`

	// ProtoPayload: The log entry payload, represented as a protocol
	// buffer.  Some
	// Google Cloud Platform services use this field for their log
	// entry payloads.
	ProtoPayload LogEntryProtoPayload `json:"protoPayload,omitempty"`

	// Resource: Required. The monitored resource associated with this log
	// entry.
	// Example: a log entry that reports a database error would
	// be
	// associated with the monitored resource designating the
	// particular
	// database that reported the error.
	Resource *MonitoredResource `json:"resource,omitempty"`

	// Severity: Optional. The severity of the log entry. The default value
	// is
	// `LogSeverity.DEFAULT`.
	//
	// Possible values:
	//   "DEFAULT" - (0) The log entry has no assigned severity level.
	//   "DEBUG" - (100) Debug or trace information.
	//   "INFO" - (200) Routine information, such as ongoing status or
	// performance.
	//   "NOTICE" - (300) Normal but significant events, such as start up,
	// shut down, or
	// a configuration change.
	//   "WARNING" - (400) Warning events might cause problems.
	//   "ERROR" - (500) Error events are likely to cause problems.
	//   "CRITICAL" - (600) Critical events cause more severe problems or
	// outages.
	//   "ALERT" - (700) A person must take an action immediately.
	//   "EMERGENCY" - (800) One or more systems are unusable.
	Severity string `json:"severity,omitempty"`

	// TextPayload: The log entry payload, represented as a Unicode string
	// (UTF-8).
	TextPayload string `json:"textPayload,omitempty"`

	// Timestamp: Optional. The time the event described by the log entry
	// occurred.  If
	// omitted, Stackdriver Logging will use the time the log entry is
	// received.
	Timestamp string `json:"timestamp,omitempty"`

	// ForceSendFields is a list of field names (e.g. "HttpRequest") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "HttpRequest") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

LogEntry: An individual entry in a log.

func (*LogEntry) MarshalJSON

func (s *LogEntry) MarshalJSON() ([]byte, error)

type LogEntryJsonPayload

type LogEntryJsonPayload interface{}

type LogEntryOperation

type LogEntryOperation struct {
	// First: Optional. Set this to True if this is the first log entry in
	// the operation.
	First bool `json:"first,omitempty"`

	// Id: Optional. An arbitrary operation identifier. Log entries with
	// the
	// same identifier are assumed to be part of the same operation.
	Id string `json:"id,omitempty"`

	// Last: Optional. Set this to True if this is the last log entry in the
	// operation.
	Last bool `json:"last,omitempty"`

	// Producer: Optional. An arbitrary producer identifier. The combination
	// of
	// `id` and `producer` must be globally unique.  Examples for
	// `producer`:
	// "MyDivision.MyBigCompany.com",
	// "github.com/MyProject/MyApplication".
	Producer string `json:"producer,omitempty"`

	// ForceSendFields is a list of field names (e.g. "First") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "First") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

LogEntryOperation: Additional information about a potentially long-running operation with which a log entry is associated.

func (*LogEntryOperation) MarshalJSON

func (s *LogEntryOperation) MarshalJSON() ([]byte, error)

type LogEntryProtoPayload

type LogEntryProtoPayload interface{}

type LogLine

type LogLine struct {
	// LogMessage: App-provided log message.
	LogMessage string `json:"logMessage,omitempty"`

	// Severity: Severity of this log entry.
	//
	// Possible values:
	//   "DEFAULT" - (0) The log entry has no assigned severity level.
	//   "DEBUG" - (100) Debug or trace information.
	//   "INFO" - (200) Routine information, such as ongoing status or
	// performance.
	//   "NOTICE" - (300) Normal but significant events, such as start up,
	// shut down, or
	// a configuration change.
	//   "WARNING" - (400) Warning events might cause problems.
	//   "ERROR" - (500) Error events are likely to cause problems.
	//   "CRITICAL" - (600) Critical events cause more severe problems or
	// outages.
	//   "ALERT" - (700) A person must take an action immediately.
	//   "EMERGENCY" - (800) One or more systems are unusable.
	Severity string `json:"severity,omitempty"`

	// SourceLocation: Where in the source code this log message was
	// written.
	SourceLocation *SourceLocation `json:"sourceLocation,omitempty"`

	// Time: Approximate time when this log entry was made.
	Time string `json:"time,omitempty"`

	// ForceSendFields is a list of field names (e.g. "LogMessage") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "LogMessage") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

LogLine: Application log line emitted while processing a request.

func (*LogLine) MarshalJSON

func (s *LogLine) MarshalJSON() ([]byte, error)

type LogMetric

type LogMetric struct {
	// Description: Optional. A description of this metric, which is used in
	// documentation.
	Description string `json:"description,omitempty"`

	// Filter: Required. An [advanced logs
	// filter](/logging/docs/view/advanced_filters).
	// Example: "resource.type=gae_app AND severity>=ERROR".
	// The maximum length of the filter is 20000 characters.
	Filter string `json:"filter,omitempty"`

	// Name: Required. The client-assigned metric identifier.
	// Example:
	// "severe_errors".  Metric identifiers are limited to 100
	// characters and can include only the following characters:
	// `A-Z`,
	// `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`.
	// The
	// forward-slash character (`/`) denotes a hierarchy of name pieces,
	// and it cannot be the first character of the name.  The '%'
	// character
	// is used to URL encode unsafe and reserved characters and must
	// be
	// followed by two hexadecimal digits according to RFC 1738.
	Name string `json:"name,omitempty"`

	// Version: Output only. The API version that created or updated this
	// metric.
	// The version also dictates the syntax of the filter expression. When a
	// value
	// for this field is missing, the default value of V2 should be assumed.
	//
	// Possible values:
	//   "V2" - Stackdriver Logging API v2.
	//   "V1" - Stackdriver Logging API v1.
	Version string `json:"version,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Description") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Description") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

LogMetric: Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter.

func (*LogMetric) MarshalJSON

func (s *LogMetric) MarshalJSON() ([]byte, error)

type LogSink

type LogSink struct {
	// Destination: Required. The export destination. See
	// [Exporting Logs With
	// Sinks](/logging/docs/api/tasks/exporting-logs).
	// Examples:
	//
	//     "storage.googleapis.com/my-gcs-bucket"
	//
	// "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
	//     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
	Destination string `json:"destination,omitempty"`

	// EndTime: Optional. Time at which this sink will stop exporting log
	// entries.  If this
	// value is present, then log entries are exported only if
	// `entry.timestamp` <
	// `end_time`.
	EndTime string `json:"endTime,omitempty"`

	// Filter: Optional. An [advanced logs
	// filter](/logging/docs/view/advanced_filters).
	// Only log entries matching the filter are exported. The filter
	// must be consistent with the log entry format specified by
	// the
	// `outputVersionFormat` parameter, regardless of the format of the
	// log entry that was originally written to Stackdriver Logging.
	// Example filter (V2 format):
	//
	//     logName=projects/my-projectid/logs/syslog AND severity>=ERROR
	// The maximum length of the filter is 20000 characters.
	Filter string `json:"filter,omitempty"`

	// Name: Required. The client-assigned sink identifier, unique within
	// the
	// project. Example: "my-syslog-errors-to-pubsub".  Sink identifiers
	// are
	// limited to 1000 characters and can include only the following
	// characters:
	// `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum
	// length
	// of the name is 100 characters.
	Name string `json:"name,omitempty"`

	// OutputVersionFormat: Optional. The log entry version to use for this
	// sink's exported log
	// entries.  This version does not have to correspond to the version of
	// the
	// log entry that was written to Stackdriver Logging. If omitted, the
	// v2 format is used.
	//
	// Possible values:
	//   "VERSION_FORMAT_UNSPECIFIED" - An unspecified version format will
	// default to V2.
	//   "V2" - `LogEntry` version 2 format.
	//   "V1" - `LogEntry` version 1 format.
	OutputVersionFormat string `json:"outputVersionFormat,omitempty"`

	// StartTime: Optional. The time at which this sink will begin exporting
	// log entries.  If
	// this value is present, then log entries are exported only if
	// `start_time`
	// <=`entry.timestamp`.
	StartTime string `json:"startTime,omitempty"`

	// WriterIdentity: Output only. An IAM identity&mdash;a service account
	// or group&mdash;that
	// will write exported log entries to the destination on behalf of
	// Stackdriver
	// Logging. You must grant this identity write-access to the
	// destination.
	// Consult the destination service's documentation to determine the
	// exact role
	// that must be granted.
	WriterIdentity string `json:"writerIdentity,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Destination") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Destination") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

LogSink: Describes a sink used to export log entries outside of Stackdriver Logging. A logs filter controls which log entries are exported. Sinks can have a start time and an end time; these can be used to place log entries from an exact time range into a particular destination. If both `start_time` and `end_time` are present, then `start_time` must be less than `end_time`.

func (*LogSink) MarshalJSON

func (s *LogSink) MarshalJSON() ([]byte, error)

type MonitoredResource

type MonitoredResource struct {
	// Labels: Required. Values for all of the labels listed in the
	// associated monitored
	// resource descriptor. For example, Cloud SQL databases use the
	// labels
	// "database_id" and "zone".
	Labels map[string]string `json:"labels,omitempty"`

	// Type: Required. The monitored resource type. This field must
	// match
	// the `type` field of a MonitoredResourceDescriptor object.
	// For
	// example, the type of a Cloud SQL database is "cloudsql_database".
	Type string `json:"type,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Labels") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Labels") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

MonitoredResource: An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "zone":

{ "type": "gce_instance",
  "labels": { "instance_id": "12345678901234",
              "zone": "us-central1-a" }}

func (*MonitoredResource) MarshalJSON

func (s *MonitoredResource) MarshalJSON() ([]byte, error)

type MonitoredResourceDescriptor

type MonitoredResourceDescriptor struct {
	// Description: Optional. A detailed description of the monitored
	// resource type that might
	// be used in documentation.
	Description string `json:"description,omitempty"`

	// DisplayName: Optional. A concise name for the monitored resource type
	// that might be
	// displayed in user interfaces. It should be a Title Cased Noun
	// Phrase,
	// without any article or other determiners. For example,
	// "Google Cloud SQL Database".
	DisplayName string `json:"displayName,omitempty"`

	// Labels: Required. A set of labels used to describe instances of this
	// monitored
	// resource type. For example, an individual Google Cloud SQL database
	// is
	// identified by values for the labels "database_id" and "zone".
	Labels []*LabelDescriptor `json:"labels,omitempty"`

	// Name: Optional. The resource name of the monitored resource
	// descriptor:
	// "projects/{project_id}/monitoredResourceDescriptors/{type
	// }" where
	// {type} is the value of the `type` field in this object
	// and
	// {project_id} is a project ID that provides API-specific context
	// for
	// accessing the type.  APIs that do not use project information can use
	// the
	// resource name format "monitoredResourceDescriptors/{type}".
	Name string `json:"name,omitempty"`

	// Type: Required. The monitored resource type. For example, the
	// type
	// "cloudsql_database" represents databases in Google Cloud SQL.
	// The maximum length of this value is 256 characters.
	Type string `json:"type,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Description") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Description") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

MonitoredResourceDescriptor: An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of "gce_instance" and specifies the use of the labels "instance_id" and "zone" to identify particular VM instances.

Different APIs can support different monitored resource types. APIs generally provide a `list` method that returns the monitored resource descriptors used by the API.

func (*MonitoredResourceDescriptor) MarshalJSON

func (s *MonitoredResourceDescriptor) MarshalJSON() ([]byte, error)

type MonitoredResourceDescriptorsListCall

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

func (*MonitoredResourceDescriptorsListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*MonitoredResourceDescriptorsListCall) Do

Do executes the "logging.monitoredResourceDescriptors.list" call. Exactly one of *ListMonitoredResourceDescriptorsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListMonitoredResourceDescriptorsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*MonitoredResourceDescriptorsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*MonitoredResourceDescriptorsListCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*MonitoredResourceDescriptorsListCall) IfNoneMatch

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*MonitoredResourceDescriptorsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.

func (*MonitoredResourceDescriptorsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.

func (*MonitoredResourceDescriptorsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type MonitoredResourceDescriptorsService

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

func NewMonitoredResourceDescriptorsService

func NewMonitoredResourceDescriptorsService(s *Service) *MonitoredResourceDescriptorsService

func (*MonitoredResourceDescriptorsService) List

List: Lists the monitored resource descriptors used by Stackdriver Logging.

type OrganizationsLogsDeleteCall

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

func (*OrganizationsLogsDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsLogsDeleteCall) Do

Do executes the "logging.organizations.logs.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsLogsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsLogsDeleteCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type OrganizationsLogsService

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

func NewOrganizationsLogsService

func NewOrganizationsLogsService(s *Service) *OrganizationsLogsService

func (*OrganizationsLogsService) Delete

Delete: Deletes a log and all its log entries. The log will reappear if it receives new entries.

type OrganizationsService

type OrganizationsService struct {
	Logs *OrganizationsLogsService

	Sinks *OrganizationsSinksService
	// contains filtered or unexported fields
}

func NewOrganizationsService

func NewOrganizationsService(s *Service) *OrganizationsService

type OrganizationsSinksCreateCall

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

func (*OrganizationsSinksCreateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsSinksCreateCall) Do

Do executes the "logging.organizations.sinks.create" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsSinksCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsSinksCreateCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*OrganizationsSinksCreateCall) UniqueWriterIdentity

func (c *OrganizationsSinksCreateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *OrganizationsSinksCreateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type OrganizationsSinksDeleteCall

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

func (*OrganizationsSinksDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsSinksDeleteCall) Do

Do executes the "logging.organizations.sinks.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsSinksDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsSinksDeleteCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type OrganizationsSinksGetCall

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

func (*OrganizationsSinksGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsSinksGetCall) Do

Do executes the "logging.organizations.sinks.get" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsSinksGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsSinksGetCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*OrganizationsSinksGetCall) IfNoneMatch

func (c *OrganizationsSinksGetCall) IfNoneMatch(entityTag string) *OrganizationsSinksGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type OrganizationsSinksListCall

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

func (*OrganizationsSinksListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsSinksListCall) Do

Do executes the "logging.organizations.sinks.list" call. Exactly one of *ListSinksResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListSinksResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsSinksListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsSinksListCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*OrganizationsSinksListCall) IfNoneMatch

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*OrganizationsSinksListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.

func (*OrganizationsSinksListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.

func (*OrganizationsSinksListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type OrganizationsSinksService

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

func NewOrganizationsSinksService

func NewOrganizationsSinksService(s *Service) *OrganizationsSinksService

func (*OrganizationsSinksService) Create

Create: Creates a sink.

func (*OrganizationsSinksService) Delete

Delete: Deletes a sink.

func (*OrganizationsSinksService) Get

Get: Gets a sink.

func (*OrganizationsSinksService) List

List: Lists sinks.

func (*OrganizationsSinksService) Update

func (r *OrganizationsSinksService) Update(sinkNameid string, logsink *LogSink) *OrganizationsSinksUpdateCall

Update: Updates or creates a sink.

type OrganizationsSinksUpdateCall

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

func (*OrganizationsSinksUpdateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsSinksUpdateCall) Do

Do executes the "logging.organizations.sinks.update" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsSinksUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsSinksUpdateCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*OrganizationsSinksUpdateCall) UniqueWriterIdentity

func (c *OrganizationsSinksUpdateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *OrganizationsSinksUpdateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type ProjectsLogsDeleteCall

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

func (*ProjectsLogsDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsLogsDeleteCall) Do

Do executes the "logging.projects.logs.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsLogsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsLogsDeleteCall) Header

func (c *ProjectsLogsDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsLogsService

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

func NewProjectsLogsService

func NewProjectsLogsService(s *Service) *ProjectsLogsService

func (*ProjectsLogsService) Delete

Delete: Deletes a log and all its log entries. The log will reappear if it receives new entries.

type ProjectsMetricsCreateCall

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

func (*ProjectsMetricsCreateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsMetricsCreateCall) Do

Do executes the "logging.projects.metrics.create" call. Exactly one of *LogMetric or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogMetric.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsMetricsCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsMetricsCreateCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsMetricsDeleteCall

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

func (*ProjectsMetricsDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsMetricsDeleteCall) Do

Do executes the "logging.projects.metrics.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsMetricsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsMetricsDeleteCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsMetricsGetCall

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

func (*ProjectsMetricsGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsMetricsGetCall) Do

Do executes the "logging.projects.metrics.get" call. Exactly one of *LogMetric or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogMetric.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsMetricsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsMetricsGetCall) Header

func (c *ProjectsMetricsGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsMetricsGetCall) IfNoneMatch

func (c *ProjectsMetricsGetCall) IfNoneMatch(entityTag string) *ProjectsMetricsGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ProjectsMetricsListCall

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

func (*ProjectsMetricsListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsMetricsListCall) Do

Do executes the "logging.projects.metrics.list" call. Exactly one of *ListLogMetricsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListLogMetricsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsMetricsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsMetricsListCall) Header

func (c *ProjectsMetricsListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsMetricsListCall) IfNoneMatch

func (c *ProjectsMetricsListCall) IfNoneMatch(entityTag string) *ProjectsMetricsListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ProjectsMetricsListCall) PageSize

func (c *ProjectsMetricsListCall) PageSize(pageSize int64) *ProjectsMetricsListCall

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.

func (*ProjectsMetricsListCall) PageToken

func (c *ProjectsMetricsListCall) PageToken(pageToken string) *ProjectsMetricsListCall

PageToken sets the optional parameter "pageToken": If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.

func (*ProjectsMetricsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type ProjectsMetricsService

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

func NewProjectsMetricsService

func NewProjectsMetricsService(s *Service) *ProjectsMetricsService

func (*ProjectsMetricsService) Create

func (r *ProjectsMetricsService) Create(parent string, logmetric *LogMetric) *ProjectsMetricsCreateCall

Create: Creates a logs-based metric.

func (*ProjectsMetricsService) Delete

Delete: Deletes a logs-based metric.

func (*ProjectsMetricsService) Get

Get: Gets a logs-based metric.

func (*ProjectsMetricsService) List

List: Lists logs-based metrics.

func (*ProjectsMetricsService) Update

func (r *ProjectsMetricsService) Update(metricNameid string, logmetric *LogMetric) *ProjectsMetricsUpdateCall

Update: Creates or updates a logs-based metric.

type ProjectsMetricsUpdateCall

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

func (*ProjectsMetricsUpdateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsMetricsUpdateCall) Do

Do executes the "logging.projects.metrics.update" call. Exactly one of *LogMetric or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogMetric.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsMetricsUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsMetricsUpdateCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsService

type ProjectsService struct {
	Logs *ProjectsLogsService

	Metrics *ProjectsMetricsService

	Sinks *ProjectsSinksService
	// contains filtered or unexported fields
}

func NewProjectsService

func NewProjectsService(s *Service) *ProjectsService

type ProjectsSinksCreateCall

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

func (*ProjectsSinksCreateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsSinksCreateCall) Do

Do executes the "logging.projects.sinks.create" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsSinksCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsSinksCreateCall) Header

func (c *ProjectsSinksCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsSinksCreateCall) UniqueWriterIdentity

func (c *ProjectsSinksCreateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *ProjectsSinksCreateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type ProjectsSinksDeleteCall

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

func (*ProjectsSinksDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsSinksDeleteCall) Do

Do executes the "logging.projects.sinks.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsSinksDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsSinksDeleteCall) Header

func (c *ProjectsSinksDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsSinksGetCall

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

func (*ProjectsSinksGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsSinksGetCall) Do

Do executes the "logging.projects.sinks.get" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsSinksGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsSinksGetCall) Header

func (c *ProjectsSinksGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsSinksGetCall) IfNoneMatch

func (c *ProjectsSinksGetCall) IfNoneMatch(entityTag string) *ProjectsSinksGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ProjectsSinksListCall

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

func (*ProjectsSinksListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsSinksListCall) Do

Do executes the "logging.projects.sinks.list" call. Exactly one of *ListSinksResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListSinksResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsSinksListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsSinksListCall) Header

func (c *ProjectsSinksListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsSinksListCall) IfNoneMatch

func (c *ProjectsSinksListCall) IfNoneMatch(entityTag string) *ProjectsSinksListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ProjectsSinksListCall) PageSize

func (c *ProjectsSinksListCall) PageSize(pageSize int64) *ProjectsSinksListCall

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.

func (*ProjectsSinksListCall) PageToken

func (c *ProjectsSinksListCall) PageToken(pageToken string) *ProjectsSinksListCall

PageToken sets the optional parameter "pageToken": If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.

func (*ProjectsSinksListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type ProjectsSinksService

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

func NewProjectsSinksService

func NewProjectsSinksService(s *Service) *ProjectsSinksService

func (*ProjectsSinksService) Create

func (r *ProjectsSinksService) Create(parent string, logsink *LogSink) *ProjectsSinksCreateCall

Create: Creates a sink.

func (*ProjectsSinksService) Delete

func (r *ProjectsSinksService) Delete(sinkNameid string) *ProjectsSinksDeleteCall

Delete: Deletes a sink.

func (*ProjectsSinksService) Get

Get: Gets a sink.

func (*ProjectsSinksService) List

List: Lists sinks.

func (*ProjectsSinksService) Update

func (r *ProjectsSinksService) Update(sinkNameid string, logsink *LogSink) *ProjectsSinksUpdateCall

Update: Updates or creates a sink.

type ProjectsSinksUpdateCall

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

func (*ProjectsSinksUpdateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsSinksUpdateCall) Do

Do executes the "logging.projects.sinks.update" call. Exactly one of *LogSink or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LogSink.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsSinksUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsSinksUpdateCall) Header

func (c *ProjectsSinksUpdateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsSinksUpdateCall) UniqueWriterIdentity

func (c *ProjectsSinksUpdateCall) UniqueWriterIdentity(uniqueWriterIdentity bool) *ProjectsSinksUpdateCall

UniqueWriterIdentity sets the optional parameter "uniqueWriterIdentity": Whether the sink will have a dedicated service account returned in the sink's writer_identity. Set this field to be true to export logs from one project to a different project. This field is ignored for non-project sinks (e.g. organization sinks) because those sinks are required to have dedicated service accounts.

type RequestLog

type RequestLog struct {
	// AppEngineRelease: App Engine release version.
	AppEngineRelease string `json:"appEngineRelease,omitempty"`

	// AppId: Application that handled this request.
	AppId string `json:"appId,omitempty"`

	// Cost: An indication of the relative cost of serving this request.
	Cost float64 `json:"cost,omitempty"`

	// EndTime: Time when the request finished.
	EndTime string `json:"endTime,omitempty"`

	// Finished: Whether this request is finished or active.
	Finished bool `json:"finished,omitempty"`

	// First: 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.
	First bool `json:"first,omitempty"`

	// Host: Internet host and port number of the resource being requested.
	Host string `json:"host,omitempty"`

	// HttpVersion: HTTP version of request. Example: "HTTP/1.1".
	HttpVersion string `json:"httpVersion,omitempty"`

	// InstanceId: An identifier for the instance that handled the request.
	InstanceId string `json:"instanceId,omitempty"`

	// InstanceIndex: 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.
	InstanceIndex int64 `json:"instanceIndex,omitempty"`

	// Ip: Origin IP address.
	Ip string `json:"ip,omitempty"`

	// Latency: Latency of the request.
	Latency string `json:"latency,omitempty"`

	// Line: A list of log lines emitted by the application while serving
	// this request.
	Line []*LogLine `json:"line,omitempty"`

	// MegaCycles: Number of CPU megacycles used to process request.
	MegaCycles int64 `json:"megaCycles,omitempty,string"`

	// Method: Request method. Example: "GET", "HEAD", "PUT",
	// "POST", "DELETE".
	Method string `json:"method,omitempty"`

	// ModuleId: Module of the application that handled this request.
	ModuleId string `json:"moduleId,omitempty"`

	// Nickname: 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.
	Nickname string `json:"nickname,omitempty"`

	// PendingTime: Time this request spent in the pending request queue.
	PendingTime string `json:"pendingTime,omitempty"`

	// Referrer: Referrer URL of request.
	Referrer string `json:"referrer,omitempty"`

	// RequestId: 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.
	RequestId string `json:"requestId,omitempty"`

	// Resource: 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.
	Resource string `json:"resource,omitempty"`

	// ResponseSize: Size in bytes sent back to client by request.
	ResponseSize int64 `json:"responseSize,omitempty,string"`

	// 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.
	SourceReference []*SourceReference `json:"sourceReference,omitempty"`

	// StartTime: Time when the request started.
	StartTime string `json:"startTime,omitempty"`

	// Status: HTTP response status code. Example: 200, 404.
	Status int64 `json:"status,omitempty"`

	// TaskName: Task name of the request, in the case of an offline
	// request.
	TaskName string `json:"taskName,omitempty"`

	// TaskQueueName: Queue name of the request, in the case of an offline
	// request.
	TaskQueueName string `json:"taskQueueName,omitempty"`

	// TraceId: Stackdriver Trace identifier for this request.
	TraceId string `json:"traceId,omitempty"`

	// UrlMapEntry: File or class that handled the request.
	UrlMapEntry string `json:"urlMapEntry,omitempty"`

	// UserAgent: User agent that made the request.
	UserAgent string `json:"userAgent,omitempty"`

	// VersionId: Version of the application that handled this request.
	VersionId string `json:"versionId,omitempty"`

	// WasLoadingRequest: Whether this was a loading request for the
	// instance.
	WasLoadingRequest bool `json:"wasLoadingRequest,omitempty"`

	// ForceSendFields is a list of field names (e.g. "AppEngineRelease") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "AppEngineRelease") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

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

func (*RequestLog) MarshalJSON

func (s *RequestLog) MarshalJSON() ([]byte, error)

type Service

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	BillingAccounts *BillingAccountsService

	Entries *EntriesService

	Folders *FoldersService

	MonitoredResourceDescriptors *MonitoredResourceDescriptorsService

	Organizations *OrganizationsService

	Projects *ProjectsService
	// contains filtered or unexported fields
}

func New

func New(client *http.Client) (*Service, error)

type SourceLocation

type SourceLocation struct {
	// File: Source file name. Depending on the runtime environment, this
	// might be a
	// simple name or a fully-qualified name.
	File string `json:"file,omitempty"`

	// FunctionName: 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).
	FunctionName string `json:"functionName,omitempty"`

	// Line: Line within the source file.
	Line int64 `json:"line,omitempty,string"`

	// ForceSendFields is a list of field names (e.g. "File") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "File") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

SourceLocation: Specifies a location in a source code file.

func (*SourceLocation) MarshalJSON

func (s *SourceLocation) MarshalJSON() ([]byte, error)

type SourceReference

type SourceReference struct {
	// Repository: Optional. A URI string identifying the
	// repository.
	// Example: "https://github.com/GoogleCloudPlatform/kubernetes.git"
	Repository string `json:"repository,omitempty"`

	// RevisionId: The canonical and persistent identifier of the deployed
	// revision.
	// Example (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"
	RevisionId string `json:"revisionId,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Repository") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Repository") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

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

func (*SourceReference) MarshalJSON

func (s *SourceReference) MarshalJSON() ([]byte, error)

type WriteLogEntriesRequest

type WriteLogEntriesRequest struct {
	// Entries: Required. The log entries to write. Values supplied for the
	// fields
	// `log_name`, `resource`, and `labels` in this `entries.write` request
	// are
	// added to those log entries that do not provide their own values for
	// the
	// fields.
	//
	// To improve throughput and to avoid exceeding the
	// [quota limit](/logging/quota-policy) for calls to
	// `entries.write`,
	// you should write multiple log entries at once rather than
	// calling this method for each individual log entry.
	Entries []*LogEntry `json:"entries,omitempty"`

	// Labels: Optional. Default labels that are added to the `labels` field
	// of all log
	// entries in `entries`. If a log entry already has a label with the
	// same key
	// as a label in this parameter, then the log entry's label is not
	// changed.
	// See LogEntry.
	Labels map[string]string `json:"labels,omitempty"`

	// LogName: Optional. A default log resource name that is assigned to
	// all log entries
	// in `entries` that do not specify a value for `log_name`.
	// Example:
	// "projects/my-project/logs/syslog".  See
	// LogEntry.
	LogName string `json:"logName,omitempty"`

	// PartialSuccess: Optional. Whether valid entries should be written
	// even if some other
	// entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If
	// any
	// entry is not written, the response status will be the error
	// associated
	// with one of the failed entries and include error details in the form
	// of
	// WriteLogEntriesPartialErrors.
	PartialSuccess bool `json:"partialSuccess,omitempty"`

	// Resource: Optional. A default monitored resource object that is
	// assigned to all log
	// entries in `entries` that do not specify a value for `resource`.
	// Example:
	//
	//     { "type": "gce_instance",
	//       "labels": {
	//         "zone": "us-central1-a", "instance_id":
	// "00000000000000000000" }}
	//
	// See LogEntry.
	Resource *MonitoredResource `json:"resource,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Entries") to
	// unconditionally include in API requests. By default, fields with
	// empty values are omitted from API requests. However, any non-pointer,
	// non-interface field appearing in ForceSendFields will be sent to the
	// server regardless of whether the field is empty or not. This may be
	// used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Entries") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

WriteLogEntriesRequest: The parameters to WriteLogEntries.

func (*WriteLogEntriesRequest) MarshalJSON

func (s *WriteLogEntriesRequest) MarshalJSON() ([]byte, error)

type WriteLogEntriesResponse

type WriteLogEntriesResponse struct {
	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`
}

WriteLogEntriesResponse: Result returned from WriteLogEntries. empty

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL