Interface LoggingRpc (3.16.0)

Version 3.16.0

• 3.17.1 (latest)
• 3.17.0
• 3.16.2
• 3.15.17
• 3.14.9
• 3.13.7
• 3.12.1
• 3.11.10
• 3.10.7
• 3.9.0
• 3.8.0
• 3.7.6
• 3.6.4
• 3.5.3

public interface LoggingRpc extends AutoCloseable, ServiceRpc

Implements

AutoCloseable, com.google.cloud.ServiceRpc

Methods

create(CreateExclusionRequest request)

public abstract ApiFuture<LogExclusion> create(CreateExclusionRequest request)

Sends a request to create a new exclusion in a specified parent resource. This method returns an ApiFuture object to consume the result. ApiFuture#get() returns the created exclusion.

Parameter
Name	Description
request	CreateExclusionRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogExclusion>

create(CreateLogMetricRequest request)

public abstract ApiFuture<LogMetric> create(CreateLogMetricRequest request)

Sends a request to create a log metric. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns the created metric.

Parameter
Name	Description
request	CreateLogMetricRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogMetric>

create(CreateSinkRequest request)

public abstract ApiFuture<LogSink> create(CreateSinkRequest request)

Sends a request to create a sink. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns the created sink.

Parameter
Name	Description
request	CreateSinkRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogSink>

delete(DeleteExclusionRequest request)

public abstract ApiFuture<Empty> delete(DeleteExclusionRequest request)

Sends a request to delete an exclusion. This method returns an ApiFuture object to consume the result. ApiFuture#get() returns Empty#getDefaultInstance() or null if the log exclusion was not found.

Parameter
Name	Description
request	DeleteExclusionRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<Empty>

delete(DeleteLogMetricRequest request)

public abstract ApiFuture<Empty> delete(DeleteLogMetricRequest request)

Sends a request to delete a log metric. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns Empty#getDefaultInstance() or null if the log was not found.

Parameter
Name	Description
request	DeleteLogMetricRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<Empty>

delete(DeleteLogRequest request)

public abstract ApiFuture<Empty> delete(DeleteLogRequest request)

Sends a request to deletes a log. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns Empty#getDefaultInstance() or null if the log was not found. The deleted log will reappear if it receives new log entries.

Parameter
Name	Description
request	DeleteLogRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<Empty>

delete(DeleteSinkRequest request)

public abstract ApiFuture<Empty> delete(DeleteSinkRequest request)

Sends a request to delete a sink. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns Empty#getDefaultInstance() or null if the sink was not found.

Parameter
Name	Description
request	DeleteSinkRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<Empty>

get(GetExclusionRequest request)

public abstract ApiFuture<LogExclusion> get(GetExclusionRequest request)

Sends a request to get the description of an exclusion. This method returns an ApiFuture object to consume the result. ApiFuture#get() returns the requested exclusion or null if not found.

Parameter
Name	Description
request	GetExclusionRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogExclusion>

get(GetLogMetricRequest request)

public abstract ApiFuture<LogMetric> get(GetLogMetricRequest request)

Sends a request to get a log metric. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns the requested log metric or null if not found.

Parameter
Name	Description
request	GetLogMetricRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogMetric>

get(GetSinkRequest request)

public abstract ApiFuture<LogSink> get(GetSinkRequest request)

Sends a request to get a sink. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns the requested sink or null if not found.

Parameter
Name	Description
request	GetSinkRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogSink>

getTailLogEntriesStream()

public default BidiStream<TailLogEntriesRequest,TailLogEntriesResponse> getTailLogEntriesStream()

This method returns a {code BidiStream} object to consume the stream of log entries.

Returns
Type	Description
BidiStream<TailLogEntriesRequest,TailLogEntriesResponse>

list(ListExclusionsRequest request)

public abstract ApiFuture<ListExclusionsResponse> list(ListExclusionsRequest request)

Sends a request to list all the exclusions in parent resource. Use this method to retrieve exclusions from Cloud Logging. This method returns an ApiFuture object to consume the result. ApiFuture#get() returns a response object containing the listing result.

Parameter
Name	Description
request	ListExclusionsRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<ListExclusionsResponse>

list(ListLogEntriesRequest request)

public abstract ApiFuture<ListLogEntriesResponse> list(ListLogEntriesRequest request)

Sends a request to list log entries. Use this method to retrieve log entries from Cloud Logging. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns a response object containing the listing result.

Parameter
Name	Description
request	ListLogEntriesRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<ListLogEntriesResponse>

list(ListLogMetricsRequest request)

public abstract ApiFuture<ListLogMetricsResponse> list(ListLogMetricsRequest request)

Sends a request to list the log metrics in a project. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns a response object containing the listing result.

Parameter
Name	Description
request	ListLogMetricsRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<ListLogMetricsResponse>

list(ListMonitoredResourceDescriptorsRequest request)

public abstract ApiFuture<ListMonitoredResourceDescriptorsResponse> list(ListMonitoredResourceDescriptorsRequest request)

Sends a request to list monitored resource descriptors. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns a response object containing the listing result.

Parameter
Name	Description
request	ListMonitoredResourceDescriptorsRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<ListMonitoredResourceDescriptorsResponse>

list(ListSinksRequest request)

public abstract ApiFuture<ListSinksResponse> list(ListSinksRequest request)

Sends a request to list the sinks in a project. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns a response object containing the listing result.

Parameter
Name	Description
request	ListSinksRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<ListSinksResponse>

listLogs(ListLogsRequest request)

public default ApiFuture<ListLogsResponse> listLogs(ListLogsRequest request)

Sends a request to list the log names in a project. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns a response object containing the listing result.

Parameter
Name	Description
request	ListLogsRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<ListLogsResponse>

update(UpdateExclusionRequest request)

public abstract ApiFuture<LogExclusion> update(UpdateExclusionRequest request)

Sends a request to change one or more properties of an existing exclusion. This method returns an ApiFuture object to consume the result. ApiFuture#get() returns the updated exclusion.

Parameter
Name	Description
request	UpdateExclusionRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogExclusion>

update(UpdateLogMetricRequest request)

public abstract ApiFuture<LogMetric> update(UpdateLogMetricRequest request)

Sends a request to update a log metric. If the log metric does not exist, it is created. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns the updated or created log metric.

Parameter
Name	Description
request	UpdateLogMetricRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogMetric>

update(UpdateSinkRequest request)

public abstract ApiFuture<LogSink> update(UpdateSinkRequest request)

Sends a request to update a sink. If the sink does not exist, it is created. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns the updated or created sink.

Parameter
Name	Description
request	UpdateSinkRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<LogSink>

write(WriteLogEntriesRequest request)

public abstract ApiFuture<WriteLogEntriesResponse> write(WriteLogEntriesRequest request)

Sends a request to write log entries to Cloud Logging. This method returns a ApiFuture object to consume the result. ApiFuture#get() returns a response object for the write operation.

Parameter
Name	Description
request	WriteLogEntriesRequest the request object containing all of the parameters for the API call

Returns
Type	Description
ApiFuture<WriteLogEntriesResponse>