logging

package
v0.0.0-...-0848a1d Latest Latest
Warning

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

Go to latest
Published: Sep 23, 2016 License: Apache-2.0 Imports: 14 Imported by: 0

README

Auto-generated logging v2 clients

This package includes auto-generated clients for the logging v2 API.

Use the handwritten logging client (in the parent directory, cloud.google.com/go/logging) in preference to this.

This code is EXPERIMENTAL and subject to CHANGE AT ANY TIME.

Documentation

Overview

Package logging is an experimental, auto-generated package for the logging API.

The Google Cloud Logging API lets you write log entries and manage your logs, log sinks and logs-based metrics.

Index

Examples

Constants

This section is empty.

Variables

View Source
var Done = errors.New("iterator done")

Done is returned by iterators on successful completion.

Functions

func ConfigParentPath

func ConfigParentPath(project string) string

ParentPath returns the path for the parent resource.

func ConfigSinkPath

func ConfigSinkPath(project string, sink string) string

SinkPath returns the path for the sink resource.

func LoggingLogPath

func LoggingLogPath(project string, log string) string

LogPath returns the path for the log resource.

func LoggingParentPath

func LoggingParentPath(project string) string

ParentPath returns the path for the parent resource.

func MetricsMetricPath

func MetricsMetricPath(project string, metric string) string

MetricPath returns the path for the metric resource.

func MetricsParentPath

func MetricsParentPath(project string) string

ParentPath returns the path for the parent resource.

Types

type CallOptions

type CallOptions struct {
	DeleteLog                        []gax.CallOption
	WriteLogEntries                  []gax.CallOption
	ListLogEntries                   []gax.CallOption
	ListMonitoredResourceDescriptors []gax.CallOption
}

CallOptions contains the retry settings for each method of this client.

type Client

type Client struct {

	// The call options for this service.
	CallOptions *CallOptions
	// contains filtered or unexported fields
}

Client is a client for interacting with LoggingServiceV2.

func NewClient

func NewClient(ctx context.Context, opts ...option.ClientOption) (*Client, error)

NewClient creates a new logging service client.

Service for ingesting and querying logs.

Example
ctx := context.Background()
c, err := logging.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use client.
_ = c
Output:

func (*Client) Close

func (c *Client) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*Client) Connection

func (c *Client) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*Client) DeleteLog

func (c *Client) DeleteLog(ctx context.Context, req *loggingpb.DeleteLogRequest) error

DeleteLog deletes a log and all its log entries. The log will reappear if it receives new entries.

Example
ctx := context.Background()
c, err := logging.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.DeleteLogRequest{
	// TODO: Fill request struct fields.
}
err = c.DeleteLog(ctx, req)
if err != nil {
	// TODO: Handle error.
}
Output:

func (*Client) ListLogEntries

func (c *Client) ListLogEntries(ctx context.Context, req *loggingpb.ListLogEntriesRequest) *LogEntryIterator

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

Example
ctx := context.Background()
c, err := logging.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.ListLogEntriesRequest{
	// TODO: Fill request struct fields.
}
it := c.ListLogEntries(ctx, req)
for {
	resp, err := it.Next()
	if err != nil {
		// TODO: Handle error.
		break
	}
	// TODO: Use resp.
	_ = resp
}
Output:

func (*Client) ListMonitoredResourceDescriptors

ListMonitoredResourceDescriptors lists the monitored resource descriptors used by Stackdriver Logging.

Example
ctx := context.Background()
c, err := logging.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.ListMonitoredResourceDescriptorsRequest{
	// TODO: Fill request struct fields.
}
it := c.ListMonitoredResourceDescriptors(ctx, req)
for {
	resp, err := it.Next()
	if err != nil {
		// TODO: Handle error.
		break
	}
	// TODO: Use resp.
	_ = resp
}
Output:

func (*Client) SetGoogleClientInfo

func (c *Client) SetGoogleClientInfo(name, version string)

SetGoogleClientInfo sets the name and version of the application in the `x-goog-api-client` header passed on each request. Intended for use by Google-written clients.

func (*Client) WriteLogEntries

WriteLogEntries writes log entries to Stackdriver Logging. All log entries are written by this method.

Example
ctx := context.Background()
c, err := logging.NewClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.WriteLogEntriesRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.WriteLogEntries(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp
Output:

type ConfigCallOptions

type ConfigCallOptions struct {
	ListSinks  []gax.CallOption
	GetSink    []gax.CallOption
	CreateSink []gax.CallOption
	UpdateSink []gax.CallOption
	DeleteSink []gax.CallOption
}

ConfigCallOptions contains the retry settings for each method of this client.

type ConfigClient

type ConfigClient struct {

	// The call options for this service.
	CallOptions *ConfigCallOptions
	// contains filtered or unexported fields
}

ConfigClient is a client for interacting with ConfigServiceV2.

func NewConfigClient

func NewConfigClient(ctx context.Context, opts ...option.ClientOption) (*ConfigClient, error)

NewConfigClient creates a new config service client.

Service for configuring sinks used to export log entries outside Stackdriver Logging.

Example
ctx := context.Background()
c, err := logging.NewConfigClient(ctx)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use client.
_ = c
Output:

func (*ConfigClient) Close

func (c *ConfigClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*ConfigClient) Connection

func (c *ConfigClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*ConfigClient) CreateSink

CreateSink creates a sink.

Example
ctx := context.Background()
c, err := logging.NewConfigClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.CreateSinkRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.CreateSink(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp
Output:

func (*ConfigClient) DeleteSink

func (c *ConfigClient) DeleteSink(ctx context.Context, req *loggingpb.DeleteSinkRequest) error

DeleteSink deletes a sink.

Example
ctx := context.Background()
c, err := logging.NewConfigClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.DeleteSinkRequest{
	// TODO: Fill request struct fields.
}
err = c.DeleteSink(ctx, req)
if err != nil {
	// TODO: Handle error.
}
Output:

func (*ConfigClient) GetSink

GetSink gets a sink.

Example
ctx := context.Background()
c, err := logging.NewConfigClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.GetSinkRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.GetSink(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp
Output:

func (*ConfigClient) ListSinks

ListSinks lists sinks.

Example
ctx := context.Background()
c, err := logging.NewConfigClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.ListSinksRequest{
	// TODO: Fill request struct fields.
}
it := c.ListSinks(ctx, req)
for {
	resp, err := it.Next()
	if err != nil {
		// TODO: Handle error.
		break
	}
	// TODO: Use resp.
	_ = resp
}
Output:

func (*ConfigClient) SetGoogleClientInfo

func (c *ConfigClient) SetGoogleClientInfo(name, version string)

SetGoogleClientInfo sets the name and version of the application in the `x-goog-api-client` header passed on each request. Intended for use by Google-written clients.

func (*ConfigClient) UpdateSink

UpdateSink creates or updates a sink.

Example
ctx := context.Background()
c, err := logging.NewConfigClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.UpdateSinkRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.UpdateSink(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp
Output:

type LogEntryIterator

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

LogEntryIterator manages a stream of *loggingpb.LogEntry.

func (*LogEntryIterator) Next

func (it *LogEntryIterator) Next() (*loggingpb.LogEntry, error)

Next returns the next result. Its second return value is Done if there are no more results. Once next returns Done, all subsequent calls will return Done.

Internally, Next retrieves results in bulk. You can call SetPageSize as a performance hint to affect how many results are retrieved in a single RPC.

SetPageToken should not be called when using Next.

Next and NextPage should not be used with the same iterator.

func (*LogEntryIterator) NextPage

func (it *LogEntryIterator) NextPage() ([]*loggingpb.LogEntry, error)

NextPage returns the next page of results. It will return at most the number of results specified by the last call to SetPageSize. If SetPageSize was never called or was called with a value less than 1, the page size is determined by the underlying service.

NextPage may return a second return value of Done along with the last page of results. After NextPage returns Done, all subsequent calls to NextPage will return (nil, Done).

Next and NextPage should not be used with the same iterator.

func (*LogEntryIterator) NextPageToken

func (it *LogEntryIterator) NextPageToken() string

NextPageToken returns a page token that can be used with SetPageToken to resume iteration from the next page. It returns the empty string if there are no more pages.

func (*LogEntryIterator) PageSize

func (it *LogEntryIterator) PageSize() int

PageSize returns the page size for all subsequent calls to NextPage.

func (*LogEntryIterator) SetPageSize

func (it *LogEntryIterator) SetPageSize(pageSize int)

SetPageSize sets the page size for all subsequent calls to NextPage.

func (*LogEntryIterator) SetPageToken

func (it *LogEntryIterator) SetPageToken(token string)

SetPageToken sets the page token for the next call to NextPage, to resume the iteration from a previous point.

type LogMetricIterator

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

LogMetricIterator manages a stream of *loggingpb.LogMetric.

func (*LogMetricIterator) Next

func (it *LogMetricIterator) Next() (*loggingpb.LogMetric, error)

Next returns the next result. Its second return value is Done if there are no more results. Once next returns Done, all subsequent calls will return Done.

Internally, Next retrieves results in bulk. You can call SetPageSize as a performance hint to affect how many results are retrieved in a single RPC.

SetPageToken should not be called when using Next.

Next and NextPage should not be used with the same iterator.

func (*LogMetricIterator) NextPage

func (it *LogMetricIterator) NextPage() ([]*loggingpb.LogMetric, error)

NextPage returns the next page of results. It will return at most the number of results specified by the last call to SetPageSize. If SetPageSize was never called or was called with a value less than 1, the page size is determined by the underlying service.

NextPage may return a second return value of Done along with the last page of results. After NextPage returns Done, all subsequent calls to NextPage will return (nil, Done).

Next and NextPage should not be used with the same iterator.

func (*LogMetricIterator) NextPageToken

func (it *LogMetricIterator) NextPageToken() string

NextPageToken returns a page token that can be used with SetPageToken to resume iteration from the next page. It returns the empty string if there are no more pages.

func (*LogMetricIterator) PageSize

func (it *LogMetricIterator) PageSize() int

PageSize returns the page size for all subsequent calls to NextPage.

func (*LogMetricIterator) SetPageSize

func (it *LogMetricIterator) SetPageSize(pageSize int)

SetPageSize sets the page size for all subsequent calls to NextPage.

func (*LogMetricIterator) SetPageToken

func (it *LogMetricIterator) SetPageToken(token string)

SetPageToken sets the page token for the next call to NextPage, to resume the iteration from a previous point.

type LogSinkIterator

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

LogSinkIterator manages a stream of *loggingpb.LogSink.

func (*LogSinkIterator) Next

func (it *LogSinkIterator) Next() (*loggingpb.LogSink, error)

Next returns the next result. Its second return value is Done if there are no more results. Once next returns Done, all subsequent calls will return Done.

Internally, Next retrieves results in bulk. You can call SetPageSize as a performance hint to affect how many results are retrieved in a single RPC.

SetPageToken should not be called when using Next.

Next and NextPage should not be used with the same iterator.

func (*LogSinkIterator) NextPage

func (it *LogSinkIterator) NextPage() ([]*loggingpb.LogSink, error)

NextPage returns the next page of results. It will return at most the number of results specified by the last call to SetPageSize. If SetPageSize was never called or was called with a value less than 1, the page size is determined by the underlying service.

NextPage may return a second return value of Done along with the last page of results. After NextPage returns Done, all subsequent calls to NextPage will return (nil, Done).

Next and NextPage should not be used with the same iterator.

func (*LogSinkIterator) NextPageToken

func (it *LogSinkIterator) NextPageToken() string

NextPageToken returns a page token that can be used with SetPageToken to resume iteration from the next page. It returns the empty string if there are no more pages.

func (*LogSinkIterator) PageSize

func (it *LogSinkIterator) PageSize() int

PageSize returns the page size for all subsequent calls to NextPage.

func (*LogSinkIterator) SetPageSize

func (it *LogSinkIterator) SetPageSize(pageSize int)

SetPageSize sets the page size for all subsequent calls to NextPage.

func (*LogSinkIterator) SetPageToken

func (it *LogSinkIterator) SetPageToken(token string)

SetPageToken sets the page token for the next call to NextPage, to resume the iteration from a previous point.

type MetricsCallOptions

type MetricsCallOptions struct {
	ListLogMetrics  []gax.CallOption
	GetLogMetric    []gax.CallOption
	CreateLogMetric []gax.CallOption
	UpdateLogMetric []gax.CallOption
	DeleteLogMetric []gax.CallOption
}

MetricsCallOptions contains the retry settings for each method of this client.

type MetricsClient

type MetricsClient struct {

	// The call options for this service.
	CallOptions *MetricsCallOptions
	// contains filtered or unexported fields
}

MetricsClient is a client for interacting with MetricsServiceV2.

func NewMetricsClient

func NewMetricsClient(ctx context.Context, opts ...option.ClientOption) (*MetricsClient, error)

NewMetricsClient creates a new metrics service client.

Service for configuring logs-based metrics.

Example
ctx := context.Background()
c, err := logging.NewMetricsClient(ctx)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use client.
_ = c
Output:

func (*MetricsClient) Close

func (c *MetricsClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*MetricsClient) Connection

func (c *MetricsClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*MetricsClient) CreateLogMetric

CreateLogMetric creates a logs-based metric.

Example
ctx := context.Background()
c, err := logging.NewMetricsClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.CreateLogMetricRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.CreateLogMetric(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp
Output:

func (*MetricsClient) DeleteLogMetric

func (c *MetricsClient) DeleteLogMetric(ctx context.Context, req *loggingpb.DeleteLogMetricRequest) error

DeleteLogMetric deletes a logs-based metric.

Example
ctx := context.Background()
c, err := logging.NewMetricsClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.DeleteLogMetricRequest{
	// TODO: Fill request struct fields.
}
err = c.DeleteLogMetric(ctx, req)
if err != nil {
	// TODO: Handle error.
}
Output:

func (*MetricsClient) GetLogMetric

GetLogMetric gets a logs-based metric.

Example
ctx := context.Background()
c, err := logging.NewMetricsClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.GetLogMetricRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.GetLogMetric(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp
Output:

func (*MetricsClient) ListLogMetrics

ListLogMetrics lists logs-based metrics.

Example
ctx := context.Background()
c, err := logging.NewMetricsClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.ListLogMetricsRequest{
	// TODO: Fill request struct fields.
}
it := c.ListLogMetrics(ctx, req)
for {
	resp, err := it.Next()
	if err != nil {
		// TODO: Handle error.
		break
	}
	// TODO: Use resp.
	_ = resp
}
Output:

func (*MetricsClient) SetGoogleClientInfo

func (c *MetricsClient) SetGoogleClientInfo(name, version string)

SetGoogleClientInfo sets the name and version of the application in the `x-goog-api-client` header passed on each request. Intended for use by Google-written clients.

func (*MetricsClient) UpdateLogMetric

UpdateLogMetric creates or updates a logs-based metric.

Example
ctx := context.Background()
c, err := logging.NewMetricsClient(ctx)
if err != nil {
	// TODO: Handle error.
}

req := &loggingpb.UpdateLogMetricRequest{
	// TODO: Fill request struct fields.
}
resp, err := c.UpdateLogMetric(ctx, req)
if err != nil {
	// TODO: Handle error.
}
// TODO: Use resp.
_ = resp
Output:

type MonitoredResourceDescriptorIterator

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

MonitoredResourceDescriptorIterator manages a stream of *monitoredrespb.MonitoredResourceDescriptor.

func (*MonitoredResourceDescriptorIterator) Next

Next returns the next result. Its second return value is Done if there are no more results. Once next returns Done, all subsequent calls will return Done.

Internally, Next retrieves results in bulk. You can call SetPageSize as a performance hint to affect how many results are retrieved in a single RPC.

SetPageToken should not be called when using Next.

Next and NextPage should not be used with the same iterator.

func (*MonitoredResourceDescriptorIterator) NextPage

NextPage returns the next page of results. It will return at most the number of results specified by the last call to SetPageSize. If SetPageSize was never called or was called with a value less than 1, the page size is determined by the underlying service.

NextPage may return a second return value of Done along with the last page of results. After NextPage returns Done, all subsequent calls to NextPage will return (nil, Done).

Next and NextPage should not be used with the same iterator.

func (*MonitoredResourceDescriptorIterator) NextPageToken

func (it *MonitoredResourceDescriptorIterator) NextPageToken() string

NextPageToken returns a page token that can be used with SetPageToken to resume iteration from the next page. It returns the empty string if there are no more pages.

func (*MonitoredResourceDescriptorIterator) PageSize

PageSize returns the page size for all subsequent calls to NextPage.

func (*MonitoredResourceDescriptorIterator) SetPageSize

func (it *MonitoredResourceDescriptorIterator) SetPageSize(pageSize int)

SetPageSize sets the page size for all subsequent calls to NextPage.

func (*MonitoredResourceDescriptorIterator) SetPageToken

func (it *MonitoredResourceDescriptorIterator) SetPageToken(token string)

SetPageToken sets the page token for the next call to NextPage, to resume the iteration from a previous point.

Jump to

Keyboard shortcuts

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