---
title: "Cloud Logging integration | Proofline"
description: "Read the alerting resource’s logs over an alert’s window as masked signatures and excerpts."
url: https://proofline.sh/integrations/google-cloud-logging/
---

# Cloud Logging

Read the alerting resource’s logs over an alert’s window as masked signatures and excerpts.

## Read the logs of the alerting resource

An alarm investigation reads Cloud Logging entries for the resource a Cloud Monitoring alert names, over the window of its metric read. The resource type selects the logs, such as a Cloud SQL instance’s engine error logs, a Compute Engine VM’s container and system logs, or a GKE pod’s stdout and stderr, usually at WARNING and above. When the alert counts a log-based metric or matches log entries, the read narrows to the entries that filter selects and keeps only a digest of the filter.

Each entry’s text passes a protected-value check and the credential mask before it becomes a signature or an excerpt. Signatures group masked messages by resource, log name, severity and template, with a count, first and last times and one excerpt of at most 2 KiB. A matched protected value withholds the read’s text and keeps its counts and structure. A read stops at one day, 16 pages of 1,000 entries, 8 MiB or 60 seconds, and Proofline keeps no raw log payload.

## Investigate errors around an alert

Suppose a Cloud SQL alert opens while a change rolls out. The log read might show a new error signature in the instance’s engine log, whose first time you can compare with the alert’s opening and the deploys in the investigation’s timeline.

Excerpts remain untrusted log text. A completed read establishes neither continuous log coverage nor the absence of an event, and an empty read shows only that the query selected no entries.

## Read logs in an alert investigation

The log read runs inside an investigation that a Cloud Monitoring alert starts, with Logs Viewer access to the alert’s project. That access excludes Data Access audit logs, and Proofline asks for no private log access. Alarm investigations are not available to new workspaces today. [Talk to the team about availability](/book/).

[Find an environment’s investigations](/help/environment-investigations/)

[Get started with GitHub](https://proofline.sh/orgs/plan)
