com.google.cloud.logging

Class SinkInfo

java.lang.Object

com.google.cloud.logging.SinkInfo

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

Sink

public class SinkInfo
extends Object
implements Serializable

Stackdriver Logging sinks can be used to control the export of your logs. Each sink specifies the export of a set of log entries to a certain destination. A sink consists of a name, unique to the project, a filter for choosing the log entries to export and a destination for the log entries.

Sink destination can either be a Google Cloud Storage bucket (see SinkInfo.Destination.BucketDestination, a Google Cloud BigQuery dataset (see SinkInfo.Destination.DatasetDestination) or a Google Cloud Pub/Sub topic (see SinkInfo.Destination.TopicDestination).

See Also:

About Sinks, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SinkInfo.Builder A builder for SinkInfo objects.
static class	SinkInfo.Destination
static class	SinkInfo.VersionFormat Available log entry formats.

Method Summary

Methods

Modifier and Type	Method and Description
static SinkInfo.Builder	builder(String name, SinkInfo.Destination destination) Returns a builder for SinkInfo objects given the name of the sink and its destination.
<T extends SinkInfo.Destination> T	destination() Returns the export destination.
boolean	equals(Object obj)
String	filter() Returns an advanced logs filter.
int	hashCode()
String	name() Returns the name of the sink.
static SinkInfo	of(String name, SinkInfo.Destination destination) Creates a SinkInfo object given the name of the sink and its destination.
SinkInfo.Builder	toBuilder() Returns a builder for this SinkInfo object.
String	toString()
SinkInfo.VersionFormat	versionFormat() Returns the log entry version to use for this sink's exported log entries.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

name

public String name()

Returns the name of the sink. Example: my-severe-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 _-..

destination

public <T extends SinkInfo.Destination> T destination()

Returns the export destination. This method returns a SinkInfo.Destination.BucketDestination for sinks that export logs to Google Cloud Storage buckets. Returns SinkInfo.Destination.DatasetDestination for sinks that export logs to Google Cloud BigQuery datasets. Returns SinkInfo.Destination.TopicDestination for sinks that export logs to Google Cloud Pub/Sub topics.

See Also:

Exporting Logs

filter

public String filter()

Returns an advanced logs filter. Only log entries matching that filter are exported. The filter must be consistent with the log entry format specified in versionFormat(), regardless of the format of the log entry that wa originally written to Stackdriver Logging. Example (V2 format): logName=projects/my-projectid/logs/syslog AND severity>=ERROR.

See Also:

Advanced Log Filters

versionFormat

public SinkInfo.VersionFormat versionFormat()

Returns 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 when it was written to Google Cloud Logging.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toBuilder

public SinkInfo.Builder toBuilder()

Returns a builder for this SinkInfo object.

builder

public static SinkInfo.Builder builder(String name,
                       SinkInfo.Destination destination)

Returns a builder for SinkInfo objects given the name of the sink and its destination.

of

public static SinkInfo of(String name,
          SinkInfo.Destination destination)

Creates a SinkInfo object given the name of the sink and its destination.