Skip to main content
Version: v5.1

to_google_cloud_logging

Sends events to Google Cloud Logging.

to_google_cloud_logging name=string, resource_type=string,
        [resource_labels=record, payload=string, service_credentials=string,
        severity=string, timestamp=time, batch_timeout=duration,
        max_batch_size=int]

Description​

Sends events to Google Cloud Logging.

name = string​

The resource name for the associated log entry. Must be in one of the following formats:

projects/[PROJECT_ID]/logs/[LOG_ID]
organizations/[ORGANIZATION_ID]/logs/[LOG_ID]
billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]
folders/[FOLDER_ID]/logs/[LOG_ID]

[LOG_ID] must be URL-encoded within name. Example: "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".

[LOG_ID] must be less than 512 characters long and can only include the following characters: upper and lower case alphanumeric characters, forward-slash, underscore, hyphen, and period.

resource_type = string​

The type of the monitored resource. All available types with their associated labels are listed here.

resource_labels = record (optional)​

Record of associated labels for the resource. Values of the record must be of type string. All available types with their associated labels are listed here.

payload = string (optional)​

The log entry payload. If unspecified, the incoming event is serialised as JSON and sent.

service_credentials = string (optional)​

Credentials to use if using a service account.

severity = string (optional)​

Severity of the event. Available severity levels are documented here.

Defaults to default.

timestamp = time (optional)​

Timestamp of the event.

batch_timeout = duration (optional)​

Maximum interval between sending the events.

Defaults to 5s.

max_batch_size = int (optional)​

Maximum events to batch before sending.

Defaults to 1k.

Example​

Send logs, authenticating automatically via ADC​

from {
  content: "log message",
  timestamp: now(),
}
to_google_cloud_logging name="projects/PROJECT_ID/logs/LOG_ID",
  resource_type="global"

Send logs using a service account​

from {
  content: "totally not a made up log",
  timestamp: now(),
  resource: "global",
}
to_google_cloud_logging name="projects/PROJECT_ID/logs/LOG_ID", 
  resource_type=resource,
  service_credentials=file_contents("/path/to/credentials.json")