Skip to main content

GCP Logging Link

A Logging Link in Google Cloud Platform (GCP) is an object that connects a Cloud Logging bucket to an external BigQuery dataset, allowing you to run Log Analytics queries with standard SQL without first exporting the logs. Each link lives under the resource path
projects/{project}/locations/{location}/buckets/{bucket}/links/{link}
and contains the metadata that tells Cloud Logging which BigQuery dataset to use and how long data should be retained there.
Official documentation: https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.locations.buckets.links

Supported Methods​

  • GET: Get a gcp-logging-link by its "locations|buckets|links"
  • LIST
  • SEARCH: Search for gcp-logging-link by its "locations|buckets"

gcp-logging-bucket​

Every Logging Link is defined inside a single logging bucket. Overmind creates a link from the bucket to its child gcp-logging-link resources so that you can see which buckets expose their data for BigQuery analysis.

gcp-big-query-dataset​

The link’s bigqueryDestination.dataset field points to the fully-qualified name of the target BigQuery dataset. Overmind uses this reference to build a relationship from the gcp-logging-link to the corresponding gcp-big-query-dataset, helping you trace where your logs will be stored and queried.