com.google.cloud.logging

Class Sink

java.lang.Object

com.google.cloud.logging.SinkInfo

com.google.cloud.logging.Sink

All Implemented Interfaces:

Serializable

public class Sink
extends SinkInfo

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 CloudPub/Sub topic (see SinkInfo.Destination.TopicDestination).

Sink adds a layer of service-related functionality over SinkInfo. Objects of this class are immutable. To get a Sink object with the most recent information use reload() or reloadAsync().

See Also:

About Sinks, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Sink.Builder A builder for Sink objects.

Nested classes/interfaces inherited from class com.google.cloud.logging.SinkInfo

SinkInfo.Destination, SinkInfo.VersionFormat

Method Summary

Methods

Modifier and Type	Method and Description
boolean	delete() Deletes this sink.
Future<Boolean>	deleteAsync() Sends a request for deleting this sink.
boolean	equals(Object obj)
int	hashCode()
Logging	logging() Returns the sinks's Logging object used to issue requests.
Sink	reload() Fetches current sink's latest information.
Future<Sink>	reloadAsync() Sends a request to fetch current sink's latest information.
Sink.Builder	toBuilder() Returns a builder for this SinkInfo object.
Sink	update(SinkInfo sinkInfo) Updates current sink.
Future<Sink>	updateAsync(SinkInfo sinkInfo) Sends a request to update current sink.

Methods inherited from class com.google.cloud.logging.SinkInfo

builder, destination, filter, name, of, toString, versionFormat

Methods inherited from class java.lang.Object

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

Method Detail

toBuilder

public Sink.Builder toBuilder()

Description copied from class: SinkInfo

Returns a builder for this SinkInfo object.

Overrides:

toBuilder in class SinkInfo

hashCode

public final int hashCode()

Overrides:

hashCode in class SinkInfo

equals

public final boolean equals(Object obj)

Overrides:

equals in class SinkInfo

logging

public Logging logging()

Returns the sinks's Logging object used to issue requests.

delete

public boolean delete()

Deletes this sink.

Returns:

true if the sink was deleted, false if it was not found

Throws:

LoggingException - upon failure

deleteAsync

public Future<Boolean> deleteAsync()

Sends a request for deleting this sink. This method returns a Future object to consume the result. Future.get() returns true if the sink was deleted, false if it was not found.

Throws:

LoggingException - upon failure

reload

public Sink reload()

Fetches current sink's latest information. Returns null if the sink does not exist.

Returns:

a Sink object with latest information or null if not found

Throws:

LoggingException - upon failure

reloadAsync

public Future<Sink> reloadAsync()

Sends a request to fetch current sink's latest information. This method returns a Future object to consume the result. Future.get() returns a Sink object with latest information or null if not found.

Throws:

LoggingException - upon failure

update

public Sink update(SinkInfo sinkInfo)

Updates current sink. If the sink does not exist, it is created.

Returns:

a Sink object with updated information

Throws:

LoggingException - upon failure

updateAsync

public Future<Sink> updateAsync(SinkInfo sinkInfo)

Sends a request to update current sink. If the sink does not exist, it is created. This method returns a Future object to consume the result. Future.get() returns a Sink object with updated information.

Throws:

LoggingException - upon failure