REST Resource: exclusions

Resource: LogExclusion

Specifies a set of log entries that are filtered out by a sink. If your Google Cloud resource receives a large volume of log entries, you can use exclusions to reduce your chargeable logs. Note that exclusions on organization-level and folder-level sinks don't apply to child resources. Note also that you cannot modify the _Required sink or exclude logs from it.

JSON representation
{
  "name": string,
  "description": string,
  "filter": string,
  "disabled": boolean,
  "createTime": string,
  "updateTime": string
}
Fields
name

string

Output only. A client-assigned identifier, such as "load-balancer-exclusion". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.

description

string

Optional. A description of this exclusion.

filter

string

Required. An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries.

For example, the following query matches 99% of low-severity log entries from Google Cloud Storage buckets:

resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)

disabled

boolean

Optional. If set to True, then this exclusion is disabled and it does not exclude any log entries. You can update an exclusion to change the value of this field.

createTime

string (Timestamp format)

Output only. The creation timestamp of the exclusion.

This field may not be present for older exclusions.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The last update timestamp of the exclusion.

This field may not be present for older exclusions.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Methods

create

Creates a new exclusion in the _Default sink in a specified parent resource.

delete

Deletes an exclusion in the _Default sink.

get

Gets the description of an exclusion in the _Default sink.

list

Lists all the exclusions on the _Default sink in a parent resource.

patch

Changes one or more properties of an existing exclusion in the _Default sink.