BigQuery

Fastly will upload log messages to the Google BigQuery dataset and table in the format specified in the BigQuery logging object.

Data model

nameStringThe name of the BigQuery logging object. Used as a primary key for API access.
service_idStringThe alphanumeric string identifying a service.
versionIntegerThe current version of a service.
formatStringApache style log formatting. Must produce JSON that matches the schema of your BigQuery table.
format_versionIntegerThe version of the custom logging format used for the configured endpoint. Can be either 2 (the default, version 2 log format) or 1 (the version 1 log format). The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.
userStringYour Google Cloud Platform service account email address. The client_email field in your service account authentication JSON.
secret_keyStringYour Google Cloud Platform account secret key. The private_key field in your service account authentication JSON.
project_idStringYour Google Cloud Platform project ID.
datasetStringYour BigQuery dataset.
tableStringYour BigQuery table.
template_suffixStringBigQuery table name suffix template. Optional.
placementStringWhere in the generated VCL the logging call should be placed, overriding any format_version default. Can be none or waf_debug. This field is not required and has no default value.
response_conditionStringThe name of an existing condition in the configured endpoint, or leave blank to always execute.
created_atStringTime-stamp (GMT) when the object was created.
updated_atStringTime-stamp (GMT) when the object was updated.
deleted_atStringTime-stamp (GMT) when the object was deleted.

Endpoints

List BigQuery log endpoints

GET/service/service_id/version/version/logging/bigquery

Get a BigQuery log endpoint

GET/service/service_id/version/version/logging/bigquery/name

Create a BigQuery log endpoint

POST/service/service_id/version/version/logging/bigquery

Update a BigQuery log endpoint

PUT/service/service_id/version/version/logging/bigquery/old_name

Delete a BigQuery log endpoint

DELETE/service/service_id/version/version/logging/bigquery/name

User contributed notes

We welcome comments that add use cases, ideas, tips, and caveats. All comments will be moderated before publication. To post support questions, visit our support center and we'll find you the help you need.