Logging release notes

This page documents production updates to Logging. You can periodically check this page for announcements about new or updated features, bug fixes, known issues, and deprecated functionality.

For a combined list of all release notes for the products in Google Cloud Observability, see Consolidated release notes.

You can see the latest product updates for all of Google Cloud on the Google Cloud page, browse and filter all release notes in the Google Cloud console, or programmatically access release notes in BigQuery.

To get the latest product updates delivered to you, add the URL of this page to your feed reader, or add the feed URL directly.

November 25, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.20.7 (2024-11-18)

Bug Fixes
  • deps: Update the Java code generator (gapic-generator-java) to 2.49.0 (a1ec68d)
  • deps: Update the Java code generator (gapic-generator-java) to 2.50.0 (afcf63c)
  • Fixed outdated link to X-Cloud-Trace-Context header description (#1713) (d474313)
Dependencies

November 08, 2024

Audit Logging now populates the status.details field in the audit log with the google.rpc.ErrorInfo and google.rpc.Help proto payload types in cases where an API returns an error status and that status includes one of those types in the details field.

October 29, 2024

You can now create and manage log scopes by using the Google Cloud CLI, in addition to using the Cloud Console and Terraform. Log scopes are in Public Preview. For more information, see

October 28, 2024

You can now use tags to annotate your log buckets and use the tags to manage access to the log buckets. For more information, see Manage log buckets by using tags.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.20.6 (2024-10-26)

Dependencies

3.20.5 (2024-10-23)

Dependencies

October 24, 2024

You can now create alerting policies that monitor the results of your SQL queries. For more information about SQL-based alerting policies, see the following documents:

October 21, 2024

A weekly digest of client library updates from across the Cloud SDK.

Go

Changes for logging/apiv2

1.12.0 (2024-10-16)

Features
  • logging: Add support for Go 1.23 iterators (84461c0)
Bug Fixes
  • logging: Bump dependencies (2ddeb15)
  • logging: Fixed input validation for X-Cloud-Trace-Context; encoded spanID from XCTC header into hex string. (#10979) (a157558)
  • logging: Update google.golang.org/api to v0.191.0 (5b32644)

Python

Changes for google-cloud-logging

3.11.3 (2024-10-15)

Bug Fixes
  • 16-bit hexadecimal formatting for XCTC span IDs (#946) (1f2b190)

October 14, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.20.4 (2024-10-07)

Bug Fixes
  • deps: Update the Java code generator (gapic-generator-java) to 2.47.0 (90b88ee)
Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.37.0 (#1702) (1f7da17)

October 09, 2024

Ops Agent release 2.51.0 adds support for Compute Engine Arm VMs that are running Rocky Linux 8.

October 07, 2024

You can now include pipe syntax in the SQL queries you run on the Log Analytics page. For more information, see the BigQuery documentation about pipe syntax.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.20.3 (2024-10-01)

Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.36.1 (#1698) (9491512)
  • Update dependency org.apache.maven.plugins:maven-deploy-plugin to v3.1.3 (2b6ea70)

October 02, 2024

You can now use Terraform commands to a create or update a log scope. For more information, see Create a log scope.

September 30, 2024

The layout of the Logs Explorer page has been changed. For more information, see View logs by using the Logs Explorer.

The pricing for vended network logs has changed. For more information see the following:

September 19, 2024

You can now query your log data from the Log Analytics page by using reserved BigQuery slots. For more information, see Query and view logs in Log Analytics.

September 16, 2024

You can now create and manage your log scopes by using the Logging API in addition to using the Cloud Console. This feature is in public preview. For more information, see Create and manage log scopes.

There is a new Cloud Observability Overview page in the Google Cloud Console. The new page, which you can customize, introduces the Cloud Observability products, and provides information about your logs, dashboards, incidents, and more. This page can help you detect issues in your resources, view relevant events, and view signals that matter to you.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.20.2 (2024-09-12)

Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.35.0 (#1683) (31ec2b9)

August 26, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.20.1 (2024-08-22)

Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.34.0 (#1677) (dbd050c)

Python

Changes for google-cloud-logging

3.11.2 (2024-08-15)

Bug Fixes
  • deps: Require google-cloud-appengine-logging>=0.1.3 (550abca)
  • deps: Require google-cloud-audit-log >= 0.2.4 (550abca)
  • deps: Require opentelemetry-api>=1.9.0 (550abca)
  • Fixed type hinting issue with specifying Transport class (#930) (e2875d6)

August 13, 2024

Introducing log scopes. Log scopes are persistent, project-level resources that list a set of resources to be searched for log entries. For example, you might configure a log scope to contain multiple projects and several log views. If you select your log scope when using the Logs Explorer, it displays the log entries that originate in the specified projects and those in the specified log views.

You can create, edit, and delete log scopes. You can also set one log scope as the default log scope, which determines the resources that the Logs Explorer searches for log entries.

For more information, see Create and manage log scopes.

August 12, 2024

A weekly digest of client library updates from across the Cloud SDK.

Python

Changes for google-cloud-logging

3.11.1 (2024-08-06)

Bug Fixes

August 05, 2024

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

11.2.0 (2024-07-15)

Features
  • Open telemetry integration and span Id fix for nodejs logging library (#1497) (91577e0)

Java

Changes for google-cloud-logging

3.20.0 (2024-08-02)

Features
Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.33.0 (#1664) (cb6de76)
Documentation
  • Documentation update for OpenTelemetry and tracing (#1657) (e3c6670)

July 29, 2024

A weekly digest of client library updates from across the Cloud SDK.

Go

Changes for logging/apiv2

1.11.0 (2024-07-24)

Features
  • logging: OpenTelemetry trace/span ID integration for Go logging library (#10030) (c6711b8)
Bug Fixes
  • logging: Bump google.golang.org/api@v0.187.0 (8fa9e39)
  • logging: Bump google.golang.org/grpc@v1.64.1 (8ecc4e9)
  • logging: Skip automatic resource detection if a CommonResource (#10441) (fc4c910)
  • logging: Update dependencies (257c40b)
Documentation
  • logging: Documentation for automatic trace/span ID extraction (#10536) (8cf89a3)

Python

Changes for google-cloud-logging

3.11.0 (2024-07-15)

Features
  • OpenTelemetry trace/spanID integration for Python handlers (#889) (78168a3)
Bug Fixes
  • Added environment specific labels to client library when running in Cloud Run Jobs (#877) (9c5e8f0)
  • Added missing import into logger.py (#896) (9ca242d)
  • Added type hints to CloudLoggingHandler constructor (#903) (6959345)
Documentation
  • Add summary_overview template (#878) (b60714c)
  • Changed table in web-framework-integration to bulleted list (#875) (a4aa3a7)
  • Documentation update for OpenTelemetry (#915) (2a0539a)
  • Update dictConfig snippet (#885) (6264107)

July 19, 2024

The permissions required to use saved and recent queries have changed. You can also define a location in your default resource settings where saved and recent queries are saved. This location must align with your organization policy.

July 08, 2024

Log buckets in all regions supported by Cloud Logging can now be upgraded to use Log Analytics. For more information, see Supported regions.

July 03, 2024

Agent-installation policies for the Ops Agent are now GA. For more information, see Overview of agent policies for the Ops Agent.

You can now view the estimated number of byte processed along with the validation status of your SQL query when running queries in Log Analytics. You can use this information to understand the relative volume of data that your SQL query will scan.

July 01, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.19.0 (2024-06-26)

Features
  • logging: OpenTelemetry trace/span ID integration for Java logging library (#1596) (67db829)
Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.32.0 (#1649) (cb428d1)

June 26, 2024

You can now analyze your billable log volume when using Log Analytics. This feature is in Public Preview. For more information, see Analyze log volume with Log Analytics.

June 25, 2024

Ops Agent version 2.48.0 introduces support for Compute Engine VMs that are running Deep Learning VM Images based on Debian 11 (Bullseye). For more information, see Operating systems.

June 24, 2024

Gauges and scorecards are now available to visualize the results of your SQL queries. For more information, see Chart query results with Log Analytics.

June 13, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.18.0 (2024-06-04)

Features
Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.31.0 (#1625) (9db8f3b)

You can now use Terraform commands to attach an IAM role binding to a log view that grants a principal access to the log view. For more information about log views and about controlling access to log views, see Configure log views on a log bucket.

June 03, 2024

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

11.1.0 (2024-05-29)

Features
  • Add several fields to manage state of database encryption update (#1495) (4137f7b)
  • Update Nodejs generator to send API versions in headers for GAPICs (#1502) (346e646)
Bug Fixes
  • Correct long audio synthesis HTTP binding (#1479) (1f94504)
  • Improve retry logic for streaming API calls (#1484) (7e11e11)

May 29, 2024

Ops Agent version 2.47.0 introduces support for Compute Engine VMs that are running Ubuntu 24.04 LTS (Noble Numbat). For more information, see Operating systems.

May 20, 2024

A weekly digest of client library updates from across the Cloud SDK.

Go

Changes for logging/apiv2

1.10.0 (2024-05-15)

Features
  • logging/logadmin: Allow logging PageSize to override (#9409) (5ca0271)
Bug Fixes
  • logging: Bump x/net to v0.24.0 (ba31ed5)
  • logging: Enable universe domain resolution options (fd1d569)
  • logging: Set default value for BundleByteLimit to 9.5 MiB to avoid payload size limits. (#9662) (d5815da)
  • logging: Update protobuf dep to v1.33.0 (30b038d)

Java

Changes for google-cloud-logging

3.17.2 (2024-05-16)

Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.30.1 (#1611) (e7a0904)

May 15, 2024

You can now attach an IAM role binding to a log view that grants a principal access to the log view. For more information about log views and about controlling access to log views, see Configure log views on a log bucket.

May 13, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.17.1 (2024-05-06)

Dependencies
  • Update actions/checkout action to v4 (#1570) (ea0db35)
  • Update actions/github-script action to v7 (#1571) (16d6192)
  • Update actions/setup-java action to v4 (#1572) (9eb8834)
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.30.0 (#1603) (16967e5)

April 29, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.17.0 (2024-04-25)

Features
Bug Fixes
  • deps: Update the Java code generator (gapic-generator-java) to 2.39.0 (#1587) (848418b)
Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.29.0 (#1586) (edcaf8d)

April 22, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.16.3 (2024-04-17)

Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.28.1 (#1569) (8eb0781)

April 03, 2024

The Logging query language now supports the cast and regexp_extract functions. For more information, see the Logging query language documentation.

March 28, 2024

Pie charts are now available for visualizing data in the Log Analytics page. For more information, see Change chart type.

March 26, 2024

You can now configure your aggregated sink to be intercepting, which prevents logs from being passed through the Log Router of child resources. For more information, see Collate and route organization-level logs to supported destinations.

Duet AI in Google Cloud is now Gemini for Google Cloud. See our blog post for more information.

March 25, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.16.2 (2024-03-20)

Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.28.0 (#1560) (d52e623)
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.28.1 (#1563) (81aa3e6)

March 18, 2024

A weekly digest of client library updates from across the Cloud SDK.

Python

Changes for google-cloud-logging

3.10.0 (2024-03-13)

Features
  • Allow users to explicitly configure universe domain (#846) (e998a21)
Bug Fixes
  • Added placeholder kwargs to StructuredLogHandler (#845) (9bc0a37)
  • Allowed for a partial override of loggers that get excluded from setup_client (#831) (870c940)
  • Remove usage in including_default_value_fields to prepare for protobuf 5.x (#866) (66a534d)
  • Use value of cluster-location in GKE for tagging location (#830) (c15847c)
Documentation
  • Added documentation for Django/Flask integrations and dictConfig (#848) (c65ec92)

March 11, 2024

You can now use SQL JOIN and UNION operators on the Log Analytics page to combine tables in multiple Google Cloud projects.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.16.1 (2024-03-07)

Bug Fixes
  • deps: Update the Java code generator (gapic-generator-java) to 2.37.0 (#1553) (15b05fc)
Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.27.0 (#1552) (6c5464d)

March 07, 2024

Log buckets in the africa-south1 region can now be upgraded to use Log Analytics. For more information, see Supported regions.

February 26, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.16.0 (2024-02-20)

Features
  • Add an API method for reordering firewall policies (#1538) (9cd6b96)
Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.25.0 (#1535) (7fde779)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.10.0 (#1528) (b3e4f9b)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.10.0 (#1456) (f27713e)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.10.1 (#1542) (af784bc)
  • Update dependency org.junit.vintage:junit-vintage-engine to v5.10.2 (#1530) (20981dc)

February 20, 2024

You can now configure and save a Log Analytics chart directly in Monitoring. For more information, see Add charts generated from a Log Analytics query.

For information and recommendations about how to instrument your applications to collect metrics, logs, and traces, see the following documents:

February 13, 2024

February 12, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.17 (2024-02-07)

Dependencies
  • Update dependency com.google.cloud:sdk-platform-java-config to v3.24.0 (#1526) (235f1aa)
Documentation

You can now display Log Analytics query results as a table in your Monitoring dashboards by selecting Table as the widget type.

February 08, 2024

You can now create log buckets in the africa-south1 region. For a complete list of supported regions, see Supported regions.

February 07, 2024

Log buckets in the following regions can now be upgraded to use Log Analytics:

  • europe-west10

For more information, see Supported regions.

January 31, 2024

Fixed a bug that caused the audit log associated with an API that performs both Data Access and Admin Activity operations to be classified as a Data Access log. These logs are now always classified as Admin Activity audit logs.

January 29, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.16 (2024-01-25)

Bug Fixes
  • deps: Update the Java code generator (gapic-generator-java) to 2.32.0 (#1511) (e2f574c)
  • Enable v2.LogEntry Protobufs converter functions (#1509) (9ef4d90)
Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.22.0 (#1510) (b40e846)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.23.0 (#1518) (30ba9ed)

January 16, 2024

You can now edit Log Analytics charts that are saved to a dashboard directly in the Dashboards page. For more information, see Edit a chart saved to a custom dashboard.

Announcing a common navigation pane in the Cloud console for Logging, Monitoring, Trace, and Error Reporting. When you are troubleshooting an issue, the new navigation pane simplifies accessing the pages you need to explore different types of telemetry:

  • The Explore section list the pages to view and analyze telemetry data.
  • The Detect section lists the pages you use to ensure that you are notified when errors occur.
  • The Configure section lists configuration and management pages.

You can continue to use the search bar to locate pages in the Cloud console and to find documentation.

January 15, 2024

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.15 (2024-01-10)

Bug Fixes
  • deps: Update the Java code generator (gapic-generator-java) to 2.31.0 (#1502) (c7a20de)
  • Replace internal Structs class with google-cloud-core version (#1501) (21e1929)
Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.21.0 (#1500) (6cce3c9)

January 08, 2024

You can now go to the Log Analytics page from the Logs Explorer page by clicking the Analyze results button, which automatically translates the Logging query language query into a SQL query. For more information, see Analyze results.

December 18, 2023

A weekly digest of client library updates from across the Cloud SDK.

Go

Changes for logging/apiv2

1.9.0 (2023-12-12)

Features
  • logging: Add Cloud Run job monitored resource (#8631) (de66868)
  • logging: Automatic project detection in logging.NewClient() (#9006) (bc13e6a)
Bug Fixes
  • logging: Added marshalling methods for proto fields in structuredLogEntry (#8979) (aa385f9)
  • logging: Bump google.golang.org/api to v0.149.0 (8d2ab9f)
  • logging: Update golang.org/x/net to v0.17.0 (174da47)
  • logging: Update grpc-go to v1.56.3 (343cea8)
  • logging: Update grpc-go to v1.59.0 (81a97b0)
  • logging: Use instance/attributes/cluster-location for location on GKE (#9094) (c85b9d4)

Python

Changes for google-cloud-logging

:robot: I have created a release beep boop

3.9.0rc1 (2023-12-08)

Features
  • Add support for Python 3.12 (#813) (6591b53)
  • Use native namespaces instead of pkg_resources (#812) (10ad75d)
Bug Fixes
  • Fixed DeprecationWarning for datetime objects for Python 3.12 (#824) (2384981)
  • Fixed object paths in autogenerated code in owlbot.py (#804) (b14bb14)
  • Updated protobuf JSON formatting to support nested protobufs (#797) (a00c261)
  • Use retry_async instead of retry in async client (#816) (c79f7f5)
  • Use warning instead of warn in system tests to avoid DeprecationWarning (#821) (c447175)

This PR was generated with Release Please. See documentation.

3.9.0 (2023-12-08)

Features
  • Add support for Python 3.12 (#813) (6591b53)
  • Use native namespaces instead of pkg_resources (#812) (10ad75d)
Bug Fixes
  • Fixed DeprecationWarning for datetime objects for Python 3.12 (#824) (2384981)
  • Fixed object paths in autogenerated code in owlbot.py (#804) (b14bb14)
  • Updated protobuf JSON formatting to support nested protobufs (#797) (a00c261)
  • Use retry_async instead of retry in async client (#816) (c79f7f5)
  • Use warning instead of warn in system tests to avoid DeprecationWarning (#821) (c447175)

December 13, 2023

Charting in the Log Analytics page is now generally available (GA). In addition to features available in the preview, the GA release includes the ability to select none as an aggregation function on a chart.

December 05, 2023

You can now query for a specific error group in the Logs Explorer and Log Analytics pages by using the error group ID. For more information, see Find error group details for a log entry.

December 04, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.14 (2023-12-01)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.20.0 (#1484) (f3227db)

December 01, 2023

Ops Agent version 2.44.0 introduces the following features:

  • Support for Compute Engine VMs that are running Ubuntu 23.10 (Mantic Minotaur). For more information, see Operating systems.
  • Support for Compute Engine Arm VMs that are running Debian 12 (Bookworm). For more information, see Support for Compute Engine Arm VMs.
  • An option to prevent the agent from collecting self logs and sending them to Cloud Logging. For more information, see Collection of self logs.

November 29, 2023

You can now specify an inclusion filter or exclusion filter that is applied to the _Default sinks of new resources. For more information, see Configure default filter of _Default sinks.

November 13, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.13 (2023-11-06)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.19.0 (#1468) (5835a7d)
  • Update dependency org.junit.vintage:junit-vintage-engine to v5.10.1 (#1471) (debc77f)

November 10, 2023

You can now load saved queries in the Log Analytics page by using the Load button. The Load button lets you edit the query in the Query pane before running the query.

November 06, 2023

Log buckets in the following regions can now be upgraded to use Log Analytics:

  • me-central2

For more information, see Supported regions.

November 02, 2023

You can now set a custom time interval for charts in the Log Analytics page. The custom time interval can be specified in minutes, hours, or days.

November 01, 2023

October 30, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.12 (2023-10-25)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.18.0 (#1454) (dc25a87)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.28 (#1455) (3080cec)

October 24, 2023

Ops Agent version 2.43.0 introduces support for Compute Engine Arm VMs that are running SLES 15 and OpenSUSE Leap 15. For more information, see Support for Compute Engine Arm VMs.

October 16, 2023

You can now create log buckets in the us-west8 region. For a complete list of supported regions, see Supported regions.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.11 (2023-10-10)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.17.0 (#1444) (748e8a2)

October 12, 2023

You can now configure the format of the timestamp in your query results in the Logs Explorer. For more information, see Logs Explorer overview: Configure the Time column.

October 09, 2023

A weekly digest of client library updates from across the Cloud SDK.

Python

Changes for google-cloud-logging

3.8.0 (2023-10-03)

Features
  • Add cloud_run_job monitored resource type. (#788) (3b310d6)

When you install the Ops Agent on a Compute Engine VM by using the Cloud Monitoring VM Instances dashboard or the Observability tab on a Compute Engine VM details page, the agent is now installed with an Ops Agent OS policy. This installation method replaces the prior set of manual steps. For more information, see Installing the agent by using the Google Cloud console.

October 02, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.10 (2023-09-27)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.16.1 (#1434) (e9e9835)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.27 (#1430) (9e750a3)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.27 (#1431) (7c2aa2c)

Python

Changes for google-cloud-logging

3.7.0 (2023-09-25)

Features
  • Add ConfigServiceV2.CreateBucketAsync method for creating Log Buckets asynchronously (30f24a8)
  • Add ConfigServiceV2.CreateLink method for creating linked datasets for Log Analytics Buckets (30f24a8)
  • Add ConfigServiceV2.DeleteLink method for deleting linked datasets (30f24a8)
  • Add ConfigServiceV2.GetLink methods for describing linked datasets (30f24a8)
  • Add ConfigServiceV2.ListLinks method for listing linked datasets (30f24a8)
  • Add ConfigServiceV2.UpdateBucketAsync method for creating Log Buckets asynchronously (30f24a8)
  • Add LogBucket.analytics_enabled field that specifies whether Log Bucket's Analytics features are enabled (30f24a8)
  • Add LogBucket.index_configs field that contains a list of Log Bucket's indexed fields and related configuration data (30f24a8)
  • Log Analytics features of the Cloud Logging API (30f24a8)
Bug Fixes
  • Add async context manager return types (30f24a8)
  • Add severity to structured log write (#783) (31a7f69)
  • Handle exceptions raised when fetching Django request data (#758) (5ecf886)
  • Unintended exception omittion (#736) (022dc54)
Documentation
  • Documentation for the Log Analytics features of the Cloud Logging API (30f24a8)
  • Minor formatting (30f24a8)

September 29, 2023

Ops Agent versions 2.39.0 and 2.40.0 crash if you use them on Compute Engine VMs with attached GPUs. Use Ops Agent version 2.38.0, or versions 2.41.0 and newer, on VMs with attached GPUs.

September 18, 2023

You can now save charts generated from a Log Analytics SQL query to a custom dashboard. For more information, see Save a chart to a custom dashboard.

You can now customize the Logs Dashboard page by using custom dashboards. For more information, see Visualize log severity and error metrics.

You can now use the Log fields pane of the Logs Explorer to filter your Kubernetes Container logs by their service name. The service name is extracted from the value of the pod_name label. For more information, see Logs fields pane.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.9 (2023-09-11)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.15.0 (#1424) (4f82f33)
  • Update dependency org.easymock:easymock to v5.2.0 (#1421) (f931544)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.26 (#1420) (ff581a6)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.26 (#1412) (bd9be4e)

September 12, 2023

Log buckets in the following regions can now be upgraded to use Log Analytics:

  • us-east5
  • us-south1
  • me-central1
  • europe-west12

For more information, see Supported regions.

August 29, 2023

August 21, 2023

You can now view your query results as a chart in the Log Analytics page. For more information, see Chart query results with Log Analytics.

Identity and Access Management (IAM) deny policies can now include Cloud Logging permissions. For a list of Cloud Logging permissions that are supported by deny policies, see Permissions supported in deny policies.

A weekly digest of client library updates from across the Cloud SDK.

Go

Changes for logging/apiv2

1.8.1 (2023-08-14)

Bug Fixes

August 16, 2023

The behavior of simple text searches as changed. To improve the performance, the Search function is automatically invoked when you don't wrap the search terms in double quotes.

August 14, 2023

Version 2.37.0 of the Ops Agent introduces runtime health checks for errors in the configuration of logging pipelines and in parsing logs. These errors are reported to Cloud Logging. For more information, see Agent health checks.

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

11.0.0 (2023-08-10)

⚠ BREAKING CHANGES
  • migrate to Node 14
Miscellaneous Chores

Go

Changes for logging/apiv2

1.8.0 (2023-08-09)

Features
  • logging: Log Analytics features of the Cloud Logging API feat: Add ConfigServiceV2.CreateBucketAsync method for creating Log Buckets asynchronously feat: Add ConfigServiceV2.UpdateBucketAsync method for creating Log Buckets asynchronously feat: Add ConfigServiceV2.CreateLink method for creating linked datasets for Log Analytics Buckets feat: Add ConfigServiceV2.DeleteLink method for deleting linked datasets feat: Add ConfigServiceV2.ListLinks method for listing linked datasets feat: Add ConfigServiceV2.GetLink methods for describing linked datasets feat: Add LogBucket.analytics_enabled field that specifies whether Log Bucket's Analytics features are enabled feat: Add LogBucket.index_configs field that contains a list of Log Bucket's indexed fields and related configuration data docs: Documentation for the Log Analytics features of the Cloud Logging API (31c3766)
  • logging: Update all direct dependencies (b340d03)
Bug Fixes
  • logging/logadmin: Fix paging example filter (#8224) (710c627)
  • logging: REST query UpdateMask bug (df52820)
  • logging: Update grpc to v1.55.0 (1147ce0)
  • logging: Use fieldmask directly instead of field_mask genproto alias (#8031) (13d9483)

Java

Changes for google-cloud-logging

3.15.8 (2023-08-08)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.14.0 (#1409) (f9af381)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.24 (#1411) (0487cdf)

August 07, 2023

Cloud Logging now supports the following regions:

  • europe-west10
  • europe-west12
  • me-central2

For more information, see Supported regions.

August 01, 2023

Ops Agent version 2.36.0 introduces support for Compute Engine Arm VMs that are running Debian 11 (Bullseye). For more information, see Support for Compute Engine Arm VMs.

July 31, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.7 (2023-07-24)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.13.1 (#1395) (1a29b9d)
  • Update dependency org.junit.vintage:junit-vintage-engine to v5.10.0 (#1397) (f15d246)

July 26, 2023

Starting with version 2.35.0, the Ops Agent health-check log is renamed ops-agent-health; earlier versions of the Ops Agent that support health checks use the name ops-agent-health-checks.

July 24, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.6 (2023-07-17)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.13.0 (#1388) (03179b0)

July 21, 2023

The Cloud Logging agent for Windows version 1-21 is now available. This version has no user-visible changes but upgrades the grpc gem and others to fix vulnerabilities. This also includes the switch to Ruby 3, from version 1-20 of the Logging agent.

You can now view logs that are stored in log buckets in different projects by using the Refine scope button in the Logs Explorer. For more information, see Refine scope.

July 20, 2023

Support for routing your logs through the Log Router of another Google Cloud project is now Generally Available (GA). For more information, see Route logs to supported destinations.

July 19, 2023

The pricing language for Cloud Logging has changed; however, the free allotments and the rates haven't changed. For more information, see Cloud Logging pricing summary.

July 18, 2023

You can now upgrade log buckets in most regions to use Log Analytics. To determine if the region of a log bucket is supported, see Supported regions.

July 17, 2023

A weekly digest of client library updates from across the Cloud SDK.

Python

Changes for google-cloud-logging

3.6.0 (2023-07-05)

Features
  • Add logic to convert severity string to uppercase (#744) (c1c8ce1)
Bug Fixes
  • Properly handle None from metadata server (#718) (dedaff9)
Documentation
  • Fix formatting of request arg in docstring (#734) (dbb1794)

July 10, 2023

Time ranges are now synchronized between select Logging and Monitoring pages.

July 06, 2023

The Google Cloud console can now automatically install the Ops Agent for you when you create a VM instance. During the installation process, the Compute Engine VM Manager creates an Ops Agent OS policy that installs the agent and reinstalls it when necessary. For more information, see Install the Ops Agent during VM creation.

June 26, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.5 (2023-06-22)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.12.0 (#1382) (8241302)

3.15.4 (2023-06-22)

Dependencies
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.23 (#1374) (dce3c4c)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.23 (#1375) (a15c73c)

June 20, 2023

Log buckets in the following regions can now be upgraded to use Log Analytics:

  • asia-east1
  • europe-north1
  • northamerica-northeast2
  • us-east4

For more information, see Supported regions.

June 12, 2023

You can now create log sinks with user-defined service accounts. For more information, see Configure log sinks with user-managed service accounts.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.3 (2023-06-08)

Bug Fixes
Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.11.0 (#1367) (8cd2a53)

June 05, 2023

You can now configure CMEK and a default storage location for individual folders, in addition to organizations. For more information, see Configure default settings for organizations and folders and Configure CMEK for Cloud Logging.

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.5.0 (2023-05-30)

Features
  • Log Analytics features of the Cloud Logging API (#1416) (3c3de6d)

Java

Changes for google-cloud-logging

3.15.2 (2023-05-30)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.10.1 (#1354) (b2f1111)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.22 (#1340) (b3b9d5f)

May 31, 2023

Cloud Logging no longer creates a dedicated service account for each log sink. Instead, Logging reuses an existing service account when one is available for the resource type. Logging creates a service account when none are available. For more information, see Set destination permissions.

May 22, 2023

You can now use SQL JOIN and UNION operators in queries on the Log Analytics page. For more information, see Combine data from multiple sources.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.1 (2023-05-12)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.9.0 (#1342) (8b14ae1)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.22 (#1341) (cfc0106)

May 19, 2023

Log buckets with Log Analytics enabled now support the use of Customer Managed Encryption Keys (CMEK). For information about enabling Log Analytics on log buckets, see Create a bucket or Upgrade a bucket to use Log Analytics.

May 15, 2023

You can now customize the time range of your queries in the Log Analytics page by using the time-range selector. There are several time range options, such as preset times, custom start and end times, and relative time ranges. For more information, see Filter by time.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.15.0 (2023-05-06)

Features
  • Log Analytics features of the Cloud Logging API (#1335) (7d43b80)
Dependencies
  • Update dependency org.junit.vintage:junit-vintage-engine to v5.9.3 (#1329) (dfb98f4)

May 01, 2023

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.4.1 (2023-04-28)

Bug Fixes

Java

Changes for google-cloud-logging

3.14.9 (2023-04-25)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.8.0 (#1326) (5a56f1b)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.21 (#1319) (5aef8d6)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.21 (#1320) (fc2d065)

April 26, 2023

Version 2.31.0 of the Ops Agent introduces built-in support for log rotation. For more information, see Configure log rotation in the Ops Agent.

April 24, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.8 (2023-04-14)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.7.0 (#1318) (973d260)

April 18, 2023

You can now configure Log Analytics on Cloud Logging buckets and BigQuery linked datasets by using the following Terraform modules:

April 11, 2023

The Logging Query Language now supports a built-in SEARCH function that you can use to find strings in your log data. The SEARCH function is now GA. For more information, see SEARCH function.

April 03, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.7 (2023-03-28)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.6.0 (#1308) (febcf49)

March 31, 2023

Effective 1 April 2023, storage costs apply to logs data retained longer than 30 days. For pricing details, see Cloud Logging pricing summary. Prior to 1 April 2023, there are no charges for retaining logs longer than 30 days. To review the billable storage for your log buckets, go to the Logs Storage page of the Google Cloud console.

March 29, 2023

When you create a log view and use the source() function in your filter, the argument to the function is now validated to ensure that it is a single string representing a project, folder, billing account or organization.

March 27, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.6 (2023-03-20)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.5.0 (#1301) (9fa6f05)

The Cloud Logging API now supports the following region:

  • Doha: me-central1

March 22, 2023

Log buckets in the following regions can now be upgraded to use Log Analytics:

  • asia-northeast1
  • australia-southeast1
  • europe-west1
  • europe-west2
  • northamerica-northeast1
  • us-east1
  • us-west2

For more information, see Supported regions.

March 14, 2023

The Logging Query Language now supports a built-in SEARCH function that you can use to find strings in your log data. The SEARCH function is in preview. For more information, see SEARCH function.

March 10, 2023

Log-based metrics on log buckets are now generally available (GA). In addition to features available in the preview, the GA release includes the ability to create bucket-level log-based metrics in the Google Cloud console.

Starting with version 2.28.0, the Ops Agent limits the amount of disk space it can use to store buffer chunks. The Ops Agent creates buffer chunks when logging data can't be sent to the Logging API. Without a limit, these chunks might consume all available space, interrupting other services on the VM. When a network outage causes buffer chunks to be written to disk, the Ops Agent now uses a platform-specific amount of disk space to store the chunks.

March 09, 2023

You can now route logs through the Log Router of another Google Cloud project. The logs can then be managed by the other Google Cloud project, which includes log-based metrics, log-based alerts, and other log sinks. For more information, see Route logs to supported destinations.

A weekly digest of client library updates from across the Cloud SDK.

Go

Changes for logging/apiv2

1.7.0 (2023-02-27)

Features
  • logging: Add (*Logger). StandardLoggerFromTemplate() method. (#7261) (533ecbb)
  • logging: Add REST client (06a54a1)
  • logging: Rewrite signatures and type in terms of new location (620e6d8)
Bug Fixes
  • logging: Correctly populate SourceLocation when logging via (*Logger).StandardLogger (#7320) (1a0bd13)
  • logging: Fix typo in README.md (#7297) (82aa2ee)

Java

Changes for google-cloud-logging

3.14.5 (2023-03-02)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.4.0 (#1290) (84d42ae)

March 01, 2023

You can now use the gcloud CLI to do the following:

  • Create a log bucket and upgrade that bucket to use Log Analytics.
  • Upgrade an existing log bucket to use Log Analytics.
  • Create a linked dataset in BigQuery.

For more information, see Configure log buckets.

Log buckets in the following regions can now be upgraded to use Log Analytics:

  • us-central1
  • us-west1
  • asia-south1

For more information, see Supported regions.

February 27, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.4 (2023-02-21)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.3.0 (#1282) (58ac608)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.20 (#1279) (296cce1)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.20 (#1280) (6363196)

February 23, 2023

The time-range selector in the Logs Explorer has been updated to support a larger set of time range options, such as preset times, custom start and end times, and relative time ranges. For more information, see Use the time-range selector.

February 17, 2023

You can create log buckets that use Log Analytics and upgrade existing log buckets to use Log Analytics by using the Logging API. For more information, see Create a bucket.

February 16, 2023

Version 2.25.1 of the Ops Agent introduces health checks. When the Ops Agent starts, it performs a series of checks for conditions that prevent the agent from running correctly. If the agent detects one of the conditions, it writes a message to its health-check log and exits. For more information, see Find Ops Agent troubleshooting information.

February 13, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.3 (2023-02-06)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.2.0 (#1269) (e196a80)

February 06, 2023

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.4.0 (2023-01-30)

Features

February 01, 2023

To help you manage your costs, the Logs Storage page now displays the billable storage for the current month for each log bucket. For reference, this page also displays each log bucket's ingested bytes for the current and previous months.

January 30, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.2 (2023-01-24)

Bug Fixes
Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.1.2 (#1258) (d4bc663)

Python

Changes for google-cloud-logging

3.5.0 (2023-01-24)

Features
  • Add support for Python 3.11 (412d481)
Bug Fixes
  • Add context manager return types (e2278c1)
  • Instrumentation entries should not contain user labels (#703) (e05d132)
  • Require proto-plus 1.22.2 for Python 3.11 (412d481)
  • Send StructuredLogHandler instrumentation log using an explicit logger (#705) (ac6a2c6)
Documentation
  • Add documentation for enums (e2278c1)

January 17, 2023

You can now save your SQL queries, and you can set custom retention periods on log buckets upgraded to use Log Analytics. For more information, see Save a query.

Log Analytics is now GA. For more information, see Configure log buckets.

January 16, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.1 (2023-01-10)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.1.1 (#1243) (fdf6b7a)
  • Update dependency org.junit.vintage:junit-vintage-engine to v5.9.2 (#1245) (e73a704)

January 09, 2023

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.14.0 (2022-12-31)

Features
Dependencies
  • Update dependency org.easymock:easymock to v5.1.0 (#1238) (d9a381a)

January 02, 2023

A weekly digest of client library updates from across the Cloud SDK.

Python

Changes for google-cloud-logging

3.4.0 (2022-12-15)

Features
  • Add typing to proto.Message based class attributes (9d505f1)
Bug Fixes
  • Add dict typing for client_options (9d505f1)
  • deps: Require google-api-core >=1.34.0, >=2.11.0 (9d505f1)
  • Drop usage of pkg_resources (9d505f1)
  • Fix timeout default values (9d505f1)
Documentation
  • samples: Snippetgen handling of repeated enum field (9d505f1)
  • samples: Snippetgen should call await on the operation coroutine before calling result (9d505f1)

December 26, 2022

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.3.3 (2022-12-16)

Bug Fixes
  • Add CLOUDSDK_PYTHON env var to environment tests (#1385) (8ac3e6b)

Java

Changes for google-cloud-logging

3.13.7 (2022-12-19)

Bug Fixes
  • Install auth plugin on gke environment tests (#1232) (d18bbba)

December 19, 2022

Cloud Logging now supports the following regions:

  • US

  • EU

For more information, see Data regionality for Cloud Logging.

December 12, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.13.6 (2022-12-07)

Bug Fixes
  • Retrieving logentries pagewise always results in an exception (#1220) (662a439)

3.13.5 (2022-12-06)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.1.0 (#1219) (b54e015)

Python

Changes for google-cloud-logging

3.3.1 (2022-12-05)

Bug Fixes

December 05, 2022

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.3.2 (2022-12-02)

Bug Fixes

Go

Changes for logging/apiv2

1.6.1 (2022-12-02)

Bug Fixes
  • logging: downgrade some dependencies (7540152)

1.6.0 (2022-11-29)

Features
  • logging: start generating proto stubs (0eb700d)
Bug Fixes
  • logging: Fix stdout log http request format (#7083) (2894e66)

Java

Changes for google-cloud-logging

3.13.4 (2022-12-03)

Dependencies
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.19 (#1214) (f104203)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.19 (#1215) (7785a7c)

3.13.3 (2022-12-01)

Bug Fixes

Python

Changes for google-cloud-logging

3.3.0 (2022-11-26)

Features
  • Add support for custom JSON encoders (#657) (77e621c)
  • Include context on batch log errors (#650) (d08be9a)
  • Set partial_success to default to true for batched logs (#649) (e56d3e8)
  • Support Django asgi middleware (#625) (f52b3aa)
Bug Fixes
  • deps: Allow protobuf 3.19.5 (#644) (12f3001)
  • Json fields dictionary has modification side effect (#654) (a62a0d6)

November 28, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.13.2 (2022-11-21)

Dependencies
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.18 (#1201) (8b00108)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.18 (#1202) (c884361)

November 21, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.13.1 (2022-11-16)

Bug Fixes
  • Fix failing instrumentation test preventing release (#1187) (04bb6c0)
  • Test failures due to RESOURCE_EXHAUSTED (#1197) (f74b86d)
  • Wrong order of libraries info in instrumentation (#1196) (c3942ea)
Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.6 (#1190) (01ebe33)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.17 (#1182) (d4f17ab)

November 14, 2022

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.3.1 (2022-11-07)

Bug Fixes
  • Switch instrumentation code to work with NODEJS_DEFAULT_LIBRARY_VERSION only (#1373) (32b22b4)

November 07, 2022

You can now dynamically include your log content in your alert notifications for easier troubleshooting. For more information about extracting log content into labels, see Create a log-based alert (Monitoring API).

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.3.0 (2022-11-04)

Features
  • Add support for instrumentation version annotations (#1370) (c039022)

10.2.3 (2022-11-03)

Bug Fixes

10.2.2 (2022-10-31)

Bug Fixes
  • Runtime package.json check causes breakage when bundled (#1364) (ec40231)

Java

Changes for google-cloud-logging

3.13.0 (2022-11-04)

Features
  • Add support for instrumentation version annotations (#1179) (0931446)
  • Update release-please.yml with correct path (#1184) (9e75fe4)
Dependencies
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.17 (#1181) (1830525)

3.12.1 (2022-11-02)

Bug Fixes
  • Make partialSuccess to be true by default (#1173) (123960a)

November 04, 2022

The Logs tab available for each cluster on the Kubernetes Engine > Clusters page now includes suggested queries for your logs. For more information about using your GKE logs, see Viewing your GKE logs.

November 03, 2022

You can now collect Aerospike logs from the Ops Agent, starting with version 2.22.0. For more information, see Monitoring third-party applications: Aerospike.

October 31, 2022

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.2.1 (2022-10-28)

Bug Fixes
  • Correct an order of instrumentation entries (#1362) (c6b11e3)

10.2.0 (2022-10-27)

Features
  • Add support for partialSuccess global configuration (#1359) (178b19f)

Java

Changes for google-cloud-logging

3.12.0 (2022-10-27)

Features

3.11.10 (2022-10-26)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.5 (#1156) (413fa54)
  • Update dependency org.easymock:easymock to v5.0.1 (#1159) (df8bfbe)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.16 (#1144) (4836c7e)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.16 (#1154) (a13ef9f)

October 24, 2022

You can now instrument gRPC applications to use Microservices observability.

Pricing for Microservices observability is the same as Cloud Operations Pricing. There are no separate charges for using Cloud Trace, Cloud Monitoring, or Cloud Logging Microservices observability plugins.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.11.9 (2022-10-17)

Dependencies
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.15 (#1145) (5bd000c)

October 21, 2022

To show or hide log entries similar to a log entry displayed in the Logs Explorer, expand the log entry and use the Similar entries menu.

October 17, 2022

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.1.11 (2022-10-11)

Bug Fixes

Java

Changes for google-cloud-logging

3.7.7 (2022-10-13)

Dependencies

3.11.8 (2022-10-15)

Dependencies
  • Update dependency org.easymock:easymock to v5 (#1139) (ad33e92)

3.11.7 (2022-10-12)

Bug Fixes
  • Add safe directory for environment tests (#1131) (a6ff3c6)

Python

Changes for google-cloud-logging

3.2.5 (2022-10-10)

Bug Fixes

3.2.5 (2022-10-10)

Bug Fixes

October 10, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.11.6 (2022-10-07)

Bug Fixes
  • Logging SDK not applying quota limits for project set using quotaProjectId (#1125) (70fc6ee)

3.11.5 (2022-10-03)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.4 (#1120) (17a6e26)

Python

Changes for google-cloud-logging

3.2.4 (2022-10-04)

Bug Fixes

October 04, 2022

You can now collect Oracle Database logs and metrics from the Ops Agent, starting with version 2.22.0. For more information, see Monitoring third-party applications: Oracle Database.

October 03, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.11.4 (2022-10-01)

Bug Fixes

Python

Changes for google-cloud-logging

3.2.3 (2022-09-30)

Bug Fixes
  • Mimic the pubsub test to clean up bigquery datasets (#639) (44deb1b)
  • Nested json with structured log handler (#636) (b840435)
  • Structured log handler drops reserved fields in json_fields (#634) (4ef38b3)

September 27, 2022

Using Log Analytics, you can run SQL queries that analyze your log data to generate useful insights. Log Analytics also let you use BigQuery to query your log data. For more information, see Log Analytics.

September 26, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.11.3 (2022-09-22)

Dependencies
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.14 (#1079) (c08c4da)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.14 (#1080) (50c979b)

3.11.2 (2022-09-21)

Dependencies
  • Update dependency org.junit.vintage:junit-vintage-engine to v5.9.1 (#1075) (d38e9e0)

September 20, 2022

The Cloud Logging API now supports the following region:

  • Israel: me-west1.

September 19, 2022

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.1.9 (2022-09-09)

Bug Fixes

10.1.10 (2022-09-14)

Bug Fixes
  • Preserve default values in x-goog-request-params header (#1337) (87c8d1f)

Java

Changes for google-cloud-logging

3.11.1 (2022-09-15)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.3 (#1067) (6d36ffc)

3.11.0 (2022-09-14)

Features
Bug Fixes
  • Fix a couple linter issues on my stderr update (#1061) (fa1a18f)

September 15, 2022

Support for adding custom indexed LogEntry fields to your Cloud Logging buckets is now Generally Available. These indexes make querying your logs data faster.

September 12, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.10.8 (2022-09-09)

Dependencies
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.2 (#1060) (b5dea1b)

3.10.7 (2022-09-07)

Bug Fixes
  • Apply Google Java Code Clarity suggestions (#1044) (79e9d8d)

September 08, 2022

Cloud Audit Logging no longer redacts the principal email associated with service accounts in audit logs. For more information, see Caller identities in audit logs.

September 05, 2022

A weekly digest of client library updates from across the Cloud SDK.

Node.js

Changes for @google-cloud/logging

10.1.8 (2022-09-03)

Bug Fixes
  • Correction for timestamp and instrumentation record severity fields format (#1328) (057431b)

10.1.7 (2022-09-02)

Bug Fixes

10.1.6 (2022-08-31)

Bug Fixes
  • use _gaxModule when accessing gax for bundling (#1322) (9cd207d)

Java

Changes for google-cloud-logging

3.10.6 (2022-08-29)

Dependencies
  • use error_prone_annotation via shared deps (#1049) (0998b9b)

August 29, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.10.5 (2022-08-25)

Bug Fixes
  • resource detection for 2nd gen of Cloud Functions works incorrectly (#1045) (dda1d0a)

August 22, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.10.4 (2022-08-19)

Dependencies
  • update dependency com.google.errorprone:error_prone_annotations to v2.15.0 (#1037) (b2731c7)

3.10.3 (2022-08-19)

Bug Fixes
Dependencies
  • update dependency org.junit.vintage:junit-vintage-engine to v5.9.0 (#1016) (e5f0b55)

Python

Changes for google-cloud-logging

3.2.2 (2022-08-12)

Bug Fixes
  • deps: allow protobuf < 5.0.0 (#600) (8495dac)
  • deps: require proto-plus >= 1.22.0 (8495dac)

August 15, 2022

Bucket-level log-based metrics are now available in Preview. You can now create log-based metrics that are computed from the logs routed to a specific log bucket. For more information, see Log-based metrics on log buckets.

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.10.2 (2022-08-08)

Dependencies
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v3 (#1018) (17efd5c)
  • update dependency org.graalvm.buildtools:junit-platform-native to v0.9.13 (#992) (3856e4f)
  • update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.13 (#993) (a94e428)

August 04, 2022

The Logs Explorer query results now show an icon for log entries that are part of error groups. You can click the icon to view details about the error group, exclude or show only log entries from the error group in the query results, or view related documentation. For more information, see Find log entries with error groups.

July 26, 2022

You can now collect Couchbase logs and metrics from the Ops Agent, starting with version 2.18.2. For more information, see Monitoring third-party applications: Couchbase.

July 18, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.10.1 (2022-07-13)

Bug Fixes
  • enable longpaths support for windows test (#1485 )(#995) (b2f68cb)
Dependencies
  • update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.12 (#977) (71dc1ee)

Python

Changes for google-cloud-logging

3.2.1 (2022-07-13)

Bug Fixes
  • deps: require google-api-core>=1.32.0,>=2.8.0 (#585) (de35eab)

3.2.0 (2022-07-11)

Features
  • add audience parameter (a2eed8c)
  • Add support for library instrumentation (#551) (8ba0023)
Bug Fixes
  • deps: require google-api-core >= 2.8.0 (#575) (a2eed8c)
  • deps: require google-cloud-core >= 2.0.0 (a2eed8c)
  • require python 3.7+ (#580) (0b3eb52)

You can now search your correlated log entries in the Logs Explorer. For more information, see Correlate log entries.

July 15, 2022

You can now collect SAP HANA logs and metrics from the Ops Agent, starting with version 2.18.1. For more information, see Monitoring third-party applications: SAP HANA.

You can now collect Vault logs from the Ops Agent, starting with version 2.18.1. For more information, see Monitoring third-party applications: Vault.

July 14, 2022

Log-based alerting is now generally available (GA). Log-based alerts match on the content of your logs. When triggered, a log-based alert notifies you that a match has appeared in your logs and opens an incident in Cloud Monitoring. The minimum autoclose duration for incidents is now 30 minutes. For more information, see Monitor your logs and Use log-based alerts.

June 29, 2022

You can now collect Apache Flink logs from the Ops Agent, starting with version 2.17.0. For more information, see Monitoring third-party applications: Flink.

June 27, 2022

A weekly digest of client library updates from across the Cloud SDK.

Java

Changes for google-cloud-logging

3.10.0 (2022-06-25)

Features
  • Add support for library instrumentation (#979) (2749974)
Documentation
  • sample: update README for native image sample (#974) (1512487)
Dependencies
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.13.0 (#980) (18acf1f)
  • update dependency org.graalvm.buildtools:junit-platform-native to v0.9.12 (#976) (01d3213)

The Cloud Logging agent version 1-18 for Windows is now available. This version updates the location of the position files so they are retained across upgrades. For installation information, see Installing the Cloud Logging agent.

May 30, 2022

The Logs Explorer has now replaced the Legacy Log Viewer.

The Logs Explorer is the updated version of the Logging interface, and lets you quickly and efficiently retrieve, view, and analyze logs from your queries. For a detailed tour of the Logs Explorer's features, see Using the Logs Explorer.

May 27, 2022

Support has been removed for two previously deprecated system metrics: logging.googleapis.com/excluded_log_entry_count and logging.googleapis.com/excluded_byte_count.

May 26, 2022

You can now collect IIS logs and additional metrics from the Ops Agent, starting with versions 2.14.0 (logs) and 2.15.0 (additional metrics). For more information, see Monitoring third-party applications: IIS.

You can now collect Varnish logs and metrics from the Ops Agent, starting with versions 2.16.0 (logs) and 2.15.0 (metrics). For more information, see Monitoring third-party applications: Varnish.

You can now collect Active Directory Domain Services logs and metrics from the Ops Agent, starting with version 2.15.0. For more information, see Monitoring third-party applications: Active Directory Domain Services.

You can now collect Jetty logs from the Ops Agent, starting with version 2.16.0. For more information, see Monitoring third-party applications: Jetty.

May 20, 2022

You can now see more log entries in the Logs Explorer as a result of several style changes.

May 05, 2022

You can now hide large amounts of similar log entries from your query results in the Logs Explorer. To learn more, see Hide similar logs.

April 28, 2022

You can now comment within your Logging queries. For more information, see Logging query language: comments.

April 26, 2022

You can now do the following in the improved Logs Explorer:

When querying your logs data in the Logs Explorer, you can now select queries from a library, making it easier to explore your data and find logs during time-critical troubleshooting sessions.

April 25, 2022

The Cloud Logging API now supports the following regions:

  • Europe:
    • europe-southwest1
    • europe-west6
    • europe-west8
    • europe-west9
  • South America:
    • southamerica-west1

For more information, see Data Regionality for Cloud Logging.

April 14, 2022

In the Logs Explorer, pinning log entries has been improved and new options to view pinned log entries in different resource contexts have been added. To learn more, see Pin log entries.

April 04, 2022

You can now add indexed LogEntry fields to your Cloud Logging buckets to make querying your logs data faster.

March 25, 2022

Cloud Logging now supports organization policies that can enforce CMEK protection. For information, see CMEK organization policies.

March 21, 2022

Customer-managed encryption keys (CMEK) for Logs Storage are now Generally Available (GA). CMEK lets you create, control, and manage encryption keys to meet your data compliance needs. For details, see Manage the keys that protect Logging storage data .

March 11, 2022

You can now collect RabbitMQ logs from the Ops Agent, starting with version 2.12.0. For more information, see Monitoring third-party applications: RabbitMQ.

February 22, 2022

You can now collect Apache CouchDB logs from the Ops Agent, starting with version 2.11.0. For more information, see Monitoring third-party applications: CouchDB.

You can now collect Apache Hadoop logs and metrics from the Ops Agent, starting with version 2.11.0. For more information, see Monitoring third-party applications: Hadoop.

You can now collect Apache HBase logs and metrics from the Ops Agent, starting with version 2.11.0. For more information, see Monitoring third-party applications: HBase.

You can now collect Apache ZooKeeper logs from the Ops Agent, starting with version 2.11.0. For more information, see Monitoring third-party applications: ZooKeeper.

You can now collect WildFly logs from the Ops Agent, starting with version 2.11.0. For more information, see Monitoring third-party applications: WildFly.

February 14, 2022

You can now configure default storage regions and disabled _Default sinks for your Google Cloud organizations and all of their new projects and folders. For details, see Configure default resource settings for Logging.

You can now collect Apache Solr metrics and logs from the Ops Agent, starting with version 2.10.0. For more information, see Monitoring third-party applications: Solr.

You can now collect Apache Kafka metrics and logs from the Ops Agent, starting with version 2.10.0. For more information, see Monitoring third-party applications: Kafka.

You can now collect MongoDB logs from the Ops Agent, starting with version 2.10.0. For more information, see Collect logs from third-party applications: MongoDB.

February 10, 2022

Your regional preferences, including date and time formatting, are now supported in the Logs Explorer.

February 09, 2022

Compute Engine resource names, alongside their corresponding resource IDs, are now supported in the Logs Explorer. For details, see View Compute Engine logs.

January 26, 2022

You can now collect Apache Tomcat metrics and logs from the Ops Agent, starting with version 2.9.0. For more information, see Monitoring third-party applications: Apache Tomcat.

You can now collect PostgreSQL metrics and logs from the Ops Agent, starting with version 2.9.0. For more information, see Monitoring third-party applications: PostgreSQL.

You can now collect Elasticsearch logs from the Ops Agent, starting with version 2.9.0. For more information, see Monitoring third-party applications: Elasticsearch.

Starting with Ops Agent version 2.9.0, you can use the exclude_logs logging processor to prevent the Ops Agent from ingesting specific logs. For more information, see Logging processors.

January 07, 2022

You can now collect MariaDB metrics and logs from the Ops Agent, starting with version 2.8.0. For more information, see Monitoring third-party applications: MariaDB.

November 22, 2021

On or after March 1, 2022, the Legacy Logs Viewer will be shut down and all users will be redirected to use the Logs Explorer.

October 20, 2021

You can now collect MySQL logs from the Ops Agent, starting with version 2.5.0. For more information, see Collecting logs from third-party applications: MySQL.

You can now collect Redis logs from the Ops Agent, starting with version 2.5.0. For more information, see Collecting logs from third-party applications: Redis.

You can now collect Cassandra logs from the Ops Agent, starting with version 2.5.0. For more information, see Collecting logs from third-party applications: Cassandra.

October 11, 2021

Cloud Logging now supports the asia-south2, asia-southeast2, australia-southeast2, northamerica-northeast2, and us-west4 regions. For a full list or regions, see Regionalization.

October 06, 2021

You can now collect Apache httpd logs from the Ops Agent, starting with version 2.4.0. For more information, see Collecting logs from third-party applications: Apache httpd.

The Ops Agent now supports collecting logs from the systemd-journald service, starting with Ops Agent version 2.4.0. For information on configuring the systemd_journald receiver, see Configuring the Ops Agent: Logging receivers.

August 31, 2021

You can now collect nginx metrics and logs from the Ops Agent, starting with version 2.1.0. For more information, see Monitoring third-party applications: nginx.

August 18, 2021

You can now use Chef to install and manage the Google Cloud operations suite agents across your fleet of Linux and Windows VMs. For more information, refer to the Chef Integration documentation.

August 02, 2021

You can now use Puppet to install and manage the Google Cloud operations suite agents across your fleet of Linux and Windows VMs. For more information, refer to the Puppet Integration documentation.

July 30, 2021

Cloud Logging now lets you control access to individual log entry fields using field-level access control. To learn more, see Field-level access control.

July 29, 2021

Cloud Logging now supports the asia-east2 and europe-central2 regions. For a full list or regions, see Regionalization.

July 26, 2021

Log entries that are exported to BigQuery that result in a schema mismatch are now being written to an error table. For more information, see Mismatches in schema.

July 23, 2021

You can now use Cloud External Key Manager keys for organization-level Log Router CMEK. For more information, see Enabling customer-managed encryption keys for Log Router.

July 15, 2021

You can now view Monitoring data and link to the resources in the Cloud Console for Compute Engine logs in the Logs Explorer. For more information, see Viewing Monitoring data.

July 13, 2021

The Cloud Console now supports creating Logging sinks at the organization or folder level. For information on creating sinks, see Exporting logs with the Google Cloud Console.

Starting on October 12, 2021, your Dataflow logs that are ingested and stored in Cloud Logging will be charged at the standard Cloud Logging prices. It's recommended that you review the volume of Dataflow logs ingested into Cloud Logging through Metrics Explorer in Cloud Monitoring. For information on optimizing the log volume for your Dataflow jobs, see Controlling log volume.

July 12, 2021

You can now install the Logging and Monitoring agents on multiple VMs from the Inventory tab on the Cloud Monitoring VM Instances page. You can select multiple VMs in your fleet for agent installation. The page generates the necessary installation command and provides a link to Cloud Shell, where you can run the command.

July 07, 2021

The Share link feature for queries in the Logs Explorer now lets you choose whether to include an absolute time range or a relative time range. With an absolute time range, the query includes static time values for the results, so the query always returns the same results. With a relative time range, you can set a value like "last 1 hour", and the results change as time passes.

Preview: Cloud Logging now supports alerts based on matching the content of your logs. When triggered, a log-based alert notifies you that a match has appeared in your logs and opens an incident in Cloud Monitoring. You can create log-based alerts by using the Logs Explorer or the Monitoring API. For more information, see Monitoring your logs and Using log-based alerts.

June 30, 2021

Cloud Logging lets you copy logs from a Cloud Logging bucket to a Cloud Storage bucket. To learn more, see Copying log entries.

The Ops Agent is now Generally Available as version 2.0.0. This agent combines logging and metrics into a single agent. The Ops Agent is targeted toward specialized logging workloads that require higher throughput and improved resource efficiency.

For installation information, see Installing the Ops Agent. For information about migrating from an earlier version, see the transition guide.

The GA version of the Ops Agent can be configured to collect specific sets of metrics, as described in Configuring the Ops Agent. There is a small number of metrics that the GA version of the Ops Agent handles differently from the Preview versions of the Ops Agent and the Monitoring agent; see Differences in metric collection.

June 25, 2021

Log entries viewed in JSON format in the Cloud Console are now displayed with the field names in alphabetical order.

June 15, 2021

You can now view Monitoring data and link to the resources in the Cloud Console for certain logs, such as Google Kubernetes Engine logs, in the Logs Explorer. For more information, see Viewing Monitoring data.

May 06, 2021

The Logs Explorer Histogram offers new time controls, including zooming and scrolling, to give you more in-depth analysis of your logs data. For details, see Analyzing logs using time controls.

May 03, 2021

You can now add custom fields in the Logs Explorer to better analyze logs and refine your queries. For more information, see Adding fields to Log fields pane .

April 27, 2021

You can now install the Cloud Logging agent, Cloud Monitoring agent, and Ops Agent on VMs running OpenSUSE Leap versions 15, 15.1, and 15.2.

April 21, 2021

You can now provision and manage the Cloud Logging agent on Windows using Ansible. For more information, refer to the Ansible Role for Cloud Ops documentation.

April 12, 2021

Shared queries are now generally available (GA). To learn more, see Shared queries.

April 08, 2021

The Google Cloud Ops Agent is now available in Preview. This agent combines logging and metrics into a single agent that is targeted toward specialized logging workloads that require higher throughput and improved resource efficiency. It supports both Linux and Windows Compute Engine VMs.

Cloud Operations now offers the ability to install the Google Cloud Ops Agent via Ansible on Linux and Windows Compute Engine VMs.

Cloud Operations now offers the ability to provision the Google Cloud Ops Agent via Terraform on Linux and Windows Compute Engine VMs.

April 06, 2021

Cloud Logging now supports 22 regions in which you can create a log bucket so that you can meet compliance and audit requirements when storing your logs.

March 29, 2021

Logs Views are now Generally Available (GA). Using Logs Views, you can control who has access to the logs within your Logs Buckets. For more information on this feature, refer to the Managing Logs Views guide.

March 18, 2021

Cloud Logging now shows the breakdown of log severity levels in the Histogram pane. To learn more, see the Histogram section on the Logs Explorer page.

March 12, 2021

Suggested queries is now generally available (GA). To learn more, go to Suggested queries.

March 04, 2021

Compute Engine's VM Instances dashboard now provides an Operations menu. The "View metrics" menu option brings you to the Infrastructure summary dashboard in Monitoring. The "View logs" menu option brings you to the Logs Explorer page in Logging.

Kubernetes Engine's Clusters and Workloads dashboards now provide an Operations menu. The "View metrics" menu option brings you to the GKE Dashboard in Monitoring. The "View logs" menu option brings you to the Logs Explorer page in Logging.

February 18, 2021

Cloud Logging agent for Windows version 1-14 is now available. This version changes the default Windows configuration from using gRPC to REST for sending logs to the Cloud Logging API. For more information, refer to the release information on GitHub.

February 08, 2021

Logging truncates oversized LogEntry label keys and values. For details, see Quotas and limits.

January 29, 2021

Cloud Logging has increased the number of entries.write API calls from 60,000 to 120,000 per minute. For more information on quotas and limits, see Quotas and limits.

January 26, 2021

The gcloud commands for managing Agent Policies are now available in beta. For more information, refer to the gcloud documentation for Agent Policies.

January 22, 2021

The Logs Explorer now provides a higher degree of contrast that improves readability.

January 14, 2021

Cloud Logging now lets you share your saved queries with other users of a project. To learn more, go to the Shared queries section on the Building queries page.

December 16, 2020

Logs regionalization is now generally available. You can set the region in which you want to store your logs data. For information about this feature, refer to the Regionalization documentation.

December 08, 2020

Cloud Logging calculates the system logs-based metrics byte_count and log_entry_count on stored logs only, unlike user-defined logs-based metrics which are calculated on both stored and excluded logs. For more information, see System logs-based metrics.

This change is currently rolling out and affects all users after December 11, 2020.

December 07, 2020

In the Logs Explorer, you can now stream your log entries in real time as Cloud Logging ingests them. To learn more, see Streaming logs.

November 13, 2020

You can now use the Share link button in the Logs Explorer to create and share a shortened URL of your current query. For more information, see Using the Logs Explorer.

November 06, 2020

By using the new gcloud command and API for live tailing, you can now stream your logs in real time as your applications write them to the Cloud Logging API. To learn more, see Live tailing log entries.

November 05, 2020

Beta release: You can set the region in which you want to store your logs data. For information about this feature, refer to the Regionalization documentation.

October 28, 2020

You can now create sinks from within the Logs Explorer and Logs Router pages. To learn more, see Exporting logs with the Google Cloud Console.

To help you understand your logs volume and usage within the context of your Logs Buckets, the Resource Usage page has been moved to the Logs Storage page, which now contains your resource usage information. To learn more, see Tracking logs usage.

October 22, 2020

Cloud Logging now calculates logs-based metrics from both ingested and excluded logs. In other words, you can now calculate logs-based metrics from logs without ingesting them into a Logs Bucket.

This change started rolling out October 18, 2020 and will finish rolling out October, 30 2020.

For more information, see Overview of logs-based metrics.

Logs Views are now available in Preview. Using Logs Views, you can control who has access to the logs within your Logs Buckets. For more information on this feature, refer to the Managing Logs Views guide.

October 20, 2020

Recent queries is now generally available (GA). To learn more, go to Recent queries.

October 19, 2020

In the Logs Explorer you can now download your logs in JSON and CSV to your computer, Google Drive, or view them in a new tab. To learn more, see Downloading logs.

October 15, 2020

The Ops Agent is now available in Preview. Ops Agent provides a single agent to collect logs and metrics on Compute Engine instances.

Note that the Ops Agent uses new configuration files that are not compatible with the standalone Cloud Monitoring and Cloud Logging agents.

October 13, 2020

We've renamed the Logs Viewer (Preview) to the Logs Explorer. The Logs Explorer offers a robust set of tools for analyzing your logs data and is now the default viewer for Cloud Logging. To learn more, see Using the Logs Explorer.

The Logs Viewer (Classic) is now called the Legacy Logs Viewer. It will continue to be available and maintained until March 2021, but won't be actively developed further.

October 12, 2020

Cloud Logging has deprecated the following two logs-based metrics related to exclusions:

  • logging.googleapis.com/excluded_log_entry_count
  • logging.googleapis.com/excluded_byte_count

Cloud Logging will stop populating these metrics on October 1, 2021.

September 22, 2020

The histogram panel in the Logs Viewer (Preview) now contains a viewport to help you quickly understand the time range of the log entries you're viewing within the Query results pane. To learn more, go to the Histogram panel.

September 21, 2020

Logs Buckets are now generally available. For information about this feature, refer to the Managing logs buckets guide.

September 17, 2020

In the Logs Viewer (Preview), you can now pin log entries within the Query results and Histogram panes. To learn more, go to Pinning logs.

In the Logs Viewer (Preview), you can now view a log entry in its resource context. To learn more, go to Viewing a pinned log entry in its resource context.

You can now copy a link to a log entry in the Logs Viewer (Preview). To learn more, go to Copy a link to a log entry.

September 14, 2020

Cloud Logging now offers the ability to view a history of your ran queries through the Recent queries tab. To learn more, go to the Recent queries section on the Building queries page.

September 01, 2020

Cloud Logging updated IAM custom role permissions. Users with custom roles should verify their permissions are correct. For a list of the permissions and roles, go to the Permissions and Roles section on the Access control page.

August 24, 2020

You can now view Cloud Trace information from within the Logs Viewer. To learn more, go to the Trace data section on the Using Logs Viewer (Preview) page.

August 17, 2020

To help you explore your logs more efficiently, Cloud Logging now provides suggested queries based on the context of your Google Cloud project. For more information, go to Suggested queries.

August 11, 2020

Users now manage logs exclusions through logs sinks. As a result, custom roles that have the logging.sinks.* permissions can now control the volume of logs ingested into Cloud Logging through logs sinks.

We recommend that you review any custom roles with the logging.sinks.* permissions so that you can make adjustments as needed.

Beta release: You can now use Logs Buckets to centralize or divide your logs based on your needs. For information about this feature, refer to the Managing logs buckets guide.

August 03, 2020

Alpha release: You can now use Logs Buckets to centralize or divide your logs based on your needs. For information about this feature, refer to the Managing logs buckets guide. To participate in the alpha or to get notified when Logs Buckets goes beta, fill out the sign up form.

July 30, 2020

The Logs field explorer panel is now generally available (GA). To learn more, see the Logs field explorer section on Logs Viewer (Preview) interface page.

June 30, 2020

Cloud Logging now contains a Logs Dashboard page that provides a high-level overview into the health of your systems running within a project. To learn more, see Logs Dashboard.

June 05, 2020

Custom retention is now generally available (GA). In order to have time to explore this feature, you won't be charged for extended retention of logs until March 31, 2021. To learn more, see the Logging pricing section on the Pricing for Google Cloud's operations suite page.

June 03, 2020

In the Logs Viewer (Preview), you can now save your queries, which can then be viewed and run from the Saved queries tab. For more information, see the Saved queries section on the Building queries page.

May 18, 2020

Logs Viewer now contains the Logs field explorer panel, which lets you view aggregation-based results for your project's log fields and makes it more efficient to refine queries. To learn more, go to the Logs Viewer (Preview) page.

May 11, 2020

You can now use regular expressions to query your logs data and create filters. For more information, go to Using regular expressions.

April 27, 2020

The Logs Viewer (Preview) is now GA. To learn more, go to the Logs Viewer (Preview) Overview page.

March 17, 2020

Incoming log entries must have timestamps that don't exceed the logs retention periods in the past, and that don't exceed 24 hours in the future. Log entries outside those time boundaries aren't ingested by Cloud Logging.

March 12, 2020

Cloud Logging Agent for Windows version 1-11 is now available. This version upgrades fluentd from 1.4.2 to 1.7.4. Go to Installing the Cloud Logging agent for information on installing this version of the agent.

March 10, 2020

Logs Viewer (Preview) now contains a histogram panel. The histogram panel lets you visualize your logs data to more easily spot patterns and troubleshoot issues. For more information, see Using Logs Viewer (Preview).

February 24, 2020

Beta release: You can now use the new Logs Viewer (Preview) to view, parse and analyze log data, and refine your query parameters. Go to Logs Viewer interface (Preview) for more information.

February 17, 2020

BETA: You can now configure the retention periods of your logs data. For more information, go to Storing logs.

January 17, 2020

Customer-managed encryption keys (CMEK) for the Logs Router are now Generally Available (GA). CMEK lets you create, control, and manage encryption keys to meet your data compliance needs. For details, go to Enabling customer-managed encryption keys for Logs Router.

December 16, 2019

GA release: You can now use partitioned tables for logs exports to BigQuery. For details, go to Partitioned tables.

December 13, 2019

Google Kubernetes Engine (GKE) version 1.15, which is now generally available, drops support for GKE versions 1.12 and earlier. As a result, the beta version of Stackdriver Kubernetes Engine Monitoring is no longer supported. If your GKE clusters are running version 1.12 or earlier, then you must upgrade them as soon as possible.

December 11, 2019

Legacy Stackdriver support for Google Kubernetes Engine (GKE) is deprecated. If you're using Legacy Stackdriver, then you must migrate to Stackdriver Kubernetes Engine Monitoring before Legacy Stackdriver is decommissioned. For more information, see Legacy Stackdriver support for GKE deprecation.

November 18, 2019

Customer-managed encryption keys (CMEK) for the Logs Router are now available in Beta. CMEK lets you create, control, and manage encryption keys to meet your data compliance needs. For details, go to Enabling customer-managed encryption keys for Logs Router.

September 20, 2019

Beta release: Stackdriver Logging now offers partitioned tables for exports to BigQuery. For details, go to Partitioned tables.

September 10, 2019

Stackdriver Logging now lets you save your advanced log queries to a Saved Searches library, where they can be managed and shared. Go to Saved searches for details.

When creating a new Google Kubernetes Engine (GKE) cluster, Stackdriver Kubernetes Engine Monitoring is now the default Stackdriver support option. This is a change from prior versions where Stackdriver Logging and Stackdriver Monitoring were the default Stackdriver support option. For more information, see Overview of Stackdriver support for GKE.

May 21, 2019

Stackdriver Kubernetes Engine Monitoring is now generally available. Users of the legacy Stackdriver support for monitoring and logging for Google Kubernetes Engine are encouraged to migrate to Stackdriver Kubernetes Engine Monitoring as soon as possible.

April 23, 2019

The maximum size of a log entry has been increased to 256 KB from 100 KB. For details on logging usage limits, go to Quotas and limits.

April 15, 2019

A new Windows version (v1-9) of the Stackdriver Logging agent is now available. The new version saves the agent service logs on disk for easier troubleshooting and supports the config.d configuration extension directory.

March 15, 2019

Stackdriver agents are subject to an updated deprecation policy. As part of this transition, the next major version of the Stackdriver Monitoring and Stackdriver Logging agents will stop supporting operating systems that are at the end of their lifecycle, as well as some third-party agent plugins.

February 22, 2019

You now have two choices for the access control model when creating a Cloud Storage bucket: bucket-only (new) and object-level. Select Set object-level and bucket-level permissions as the access control model during bucket creation if you intend to use the bucket as a sink destination. See Errors exporting to Cloud Storage for details.

January 22, 2019

In the Stackdriver Logging API, log sinks, metrics, and exclusions have two new output-only fields: create time and last update time. See LogSink for an example. If this information isn't available for older resources, these fields aren't present.

December 03, 2018

The Logs Viewer has a new option to display a log entry in its resource context. It can also pin a log entry while allowing you to change the display context. See Viewing Logs for details.

November 01, 2018

You can now view error and success metrics for your log sinks using export system metrics.

October 19, 2018

You can now link from certain App Engine request logs to a detailed trace that explains the request's latency. You can also filter log entries according to their latencies, and if they contain detailed trace data viewable by Stackdriver Trace. See Viewing latency in Trace for details.

October 01, 2018

The Logs Viewer can now download up to 300 log entries in JSON or CSV format. See Viewing Logs for details.

September 14, 2018

The format of service account names for older log sinks is being changed so that all log sinks will have consistent service account names. This naming format has already been applied to project-level sinks on BigQuery, Cloud Pub/Sub, and Cloud Storage permission pages. In the coming weeks, this naming format will be applied to organization-level sinks and folder-level sinks, and to sinks listed on the Logs Exports page in the Logs Viewer. There are no associated changes to functionality or granted permissions.

September 05, 2018

Access Transparency logging is now Generally Available. See Overview of Access Transparency for details.

July 25, 2018

Audit logs exports to BigQuery now feature a compact format. On March 1, 2019, the older extended format will be removed.

June 29, 2018

On July 1, 2018 at 00:00 PDT, Stackdriver switches to consumption-based pricing. For more information, see Stackdriver Pricing.

June 26, 2018

You can now immediately disable all logs ingestion. For instructions, see Stopping all logs ingestion.

June 19, 2018

Google Cloud Storage logs streaming time has been reduced from 12 hours to 3 hours. For details, see Using Exported Logs.

June 18, 2018

Between June 18, 2018 at 06:00 PDT and July 1, 2018 at 00:00 PDT, your use of Stackdriver is free. The service tiers have been removed, and you can experience all features without incurring costs. Thereafter, Stackdriver switches to consumption-based pricing. For more information, see Upcoming Pricing.

June 12, 2018

You can now enable and configure your Data Access audit logs using the Google Cloud console. For details, see Configuring Data Access logs.

May 17, 2018

You can now see your Logging usage and estimate your bill according to the new Stackdriver pricing and in advance of billing enforcement. See Estimating your bills for details.

May 08, 2018

You can now specify custom fields in your Logs Viewer log-entry summary lines. See Add custom fields for details.

May 02, 2018

Stackdriver Kubernetes Monitoring is released in Beta for Kubernetes 1.10 clusters running in Kubernetes Engine. The previous Stackdriver support is still available for those who do not opt into this Beta release. This release affects Logging by introducing new monitored resource types and new Kubernetes metrics.

April 10, 2018

You can now specify that the Stackdriver Logging agent converts your payloads to JSON format for certain log inputs. For details on enabling this feature, see Structured Logging.

March 12, 2018

Beginning on June 30, 2018, Stackdriver is switching to consumption-based pricing, including revised quotas. For more information, see Stackdriver Upcoming Pricing.

Logging data retention has been increased to 30 days for all projects.

February 01, 2018

The Logging agent now supports partial success for logs ingestion. Any invalid log entries in a full set will be dropped, and the valid log entries now will be successfully ingested into the Stackdriver Logging API; previously, the full set would have been dropped if it contained any invalid log entries. To enable partial success, upgrade your Logging agent to google-fluentd v1.5.27.

December 13, 2017

Filtering logs by time range is now available in the Logs Viewer. For more information, see Scroll to a time.

December 04, 2017

Logging agent recommendation: VM instances should have at least 1 GB of memory to run the Logging agent.

Google Cloud Platform HTTP(S) load balancing logging now includes logs for rejected requests, such as those due to invalid or expired URL signatures, and aligns httpRequest.requestSize with metrics from the Stackdriver Monitoring API. For more information, see HTTP(S) Load Balancing Logging.

November 29, 2017

Logs-based metrics are now Generally Available. For more information, see Overview of Logs-based Metrics.

Logging agent installation instructions: The checksum validation step for the installation script has been removed. You can see the new instructions on the logging agent installation page.

Logs Viewer update: Fixes a problem related to the daylight saving time transition in the U.K. If you see your logs displaying in the wrong time zone, you can set your default time zone by using the Jump to date drop-down menu to select a different time zone. For more information, see Logs Viewer user interfaces.

November 01, 2017

Pricing changes: Billing for logs overages will begin March 31, 2018. This date extends the one that was previously communicated to give Stackdriver customers more time to apply the exclusion filters feature to control which logs are stored in Logging. Billing for custom and user-defined logs-based metrics is still postponed. For more information, see Stackdriver Pricing.

October 30, 2017

Exclusion filters are now Generally Available. For more information, see Excluding Logs, and the Resource Usage page in the Logs Viewer.

October 24, 2017

The gcloud logging command group is now generally available. gcloud beta logging will be removed at the end of December 2017. For more information, see gcloud logging.

September 12, 2017

Admin Activity audit logs retention has been extended to 400 days for both the Stackdriver Basic and Premium service tiers. For more information, see Audit log retention.

Logging agent update to 1.5.18-1. Allows enabling JSON detection via configuration, fixes a problem with string-valued timestamps, and allows setting the following LogEntry fields: trace, sourceLocation, and operation.

August 31, 2017

Logs-based metrics now support extracting values from log entries to create distribution metrics and to populate user-defined metric labels. This lets you create multiple time series in a single logs-based metric. Also, the latency of logs-based metrics has dropped from approximately 5 minutes to 1 minute, so you can respond more quickly to the metrics. For more information, see Overview of Logs-based metrics.

Exclusion filters let you control which logs are kept in Stackdriver Logging. The Resource Usage page in the Logs Viewer breaks down log volume by resource type. For more information, see Excluding Logs.

Logging agent: The Stackdriver Logging agent package has been updated to version 1.5.17. The agent will now send smaller requests, improving log delivery latency and increasing queries per second, which may affect users with high log volumes. Also, the package's bundled Ruby has been updated to version 2.2.7. If you have configuration snippets or extra gems that depend on older Ruby features, you may have to update them.

Pricing changes: The free per-project allotment of logs is being increased from 5 GB to 50 GB. Beginning December 1, 2017, we will enforce the new limits and begin charging for logs kept in Stackdriver Logging above the limits. For more information, see Stackdriver Pricing.

August 23, 2017

Aggregated Exports: Organizations and folders can now export selected log entries from all of their projects with a single sink created in the organization or folder. For more information, see Aggregated Exports.

Timestamp handling. The following changes to log entry timestamps have been made or are planned. 1. Logging does not modify the user-provided timestamp field, except to set it to the current time if it is omitted. A second field, receivedTimestamp, is set to the time Logging receives the entry. 2. The timestamp field is used to compute the age of log entries and to enforce the log retention period. Prior to the change, the receivedTimestamp field is used for that purpose. 3. Logging discards log entries whose timestamps are more than 24 hours in the future or are further in the past than the log entry's retention period. Prior to the change, future timestamps and very old timestamps are handled in an unpredictable fashion. For more information, see LogEntry and entries.write.

July 10, 2017

IAM support for Logging now includes custom roles. For more information, see Logging Access Control.

API Migration. Information about the deprecated v1 API is being removed from general documentation. Note: Obsolete link to migration information removed on December 13, 2017. For updated information, see APIs & Reference.

June 05, 2017

Exported audit logs in BigQuery: The BigQuery schema for exported audit log entries changed on June 5, 2017. The following audit log components now have shortened field names when they are exported to BigQuery: protoPayload, protoPayload.serviceData, protoPayload.request, and protoPayload.response. This is a breaking change for queries involving these fields. For more information see Audit log field changes.

Apps Script: You can access your Apps Script logs in Logging.

Logs Viewer: You can more easily expand all fields in a log entry.

May 01, 2017

Data access logs are now available and are user-configurable. See Configuring Data Access Logs.

Aggregated exports of logs: You can now create log sinks in organizations, billing accounts, and folders. Those sinks can export log entries from all included projects. See Aggregated Exports.

v1 API turndown: writeLogEntries: As a final step in the v1 API turndown, the v1 WriteLogEntries method will be shut down on October 1, 2017. You must migrate any applications that write log entries using the v1 API. You must also upgrade any manually-installed Logging agents in your VM instances. Note: Obsolete link to migration information removed on December 13, 2017. For updated information, see APIs & Reference.

v1 API turndown: sinks and logs-based metrics: Migrate your remaining v1 export sinks and v1 logs-based metrics. If you do not, Logging will migrate them by mid-July, 2017. Note: Obsolete link to migration information removed on December 13, 2017. For updated information, see APIs & Reference.

April 01, 2017

Resource types: Several new resource types are added, including types for Cloud Bigtable, Cloud Dataflow, and Cloud Container Engine.

March 31, 2017

V1 API turndown: The date of the v1 API turndown has changed. See the release note for May 2017.

Logging agent for Windows: If you install the Logging agent on VM instances running Microsoft Windows, be aware that there are restrictions on the folders used for the installer and the installed agent. For details, Installing on Linux and Windows.

February 06, 2017

Exporting logs from organizations, folders, and billing accounts: The gcloud logging command-line tool now supports creating log sinks to export audit logs from organizations, folders, and billing accounts. This feature also supported in the API.

Viewing multiple logs: Previously in the Logs Viewer, you could view a single log or "all logs" from a single resource type. Now you can select any number of logs within a resource type to view, using the log name dropdown menu.

For example, when viewing App Engine applications, the default is now to display log entries from any of these logs: ngnix.request, stdout, request log, and stderr.

Resuming log streaming: The Logs Viewer now automatically resumes streaming logs when its browser window or tab is selected. You no longer have to restart streaming when returning to the page.

App Engine Flexible Environment: For App Engine Flexible Environment, the Logs Viewer can now display application log entries ("log lines") inside the log entry for the associated service request. This is similar to the functionality in the App Engine Standard Environment.

Deleting logs-based metrics in alerting policies: Attempting to delete a logs-based metric that is used in one or more Stackdriver Monitoring alerting policies now fails with the status FAILED_PRECONDITION. You must remove the metric from the alerting policies or delete the alerting policies prior to deleting the logs-based metric.

Remove daily API quotas: The Logging API no longer includes daily API quotas. The API still enforces short-term (per 100s) quotas on API calls, as displayed in the Stackdriver Logging API dashboard.

Logs retention and source restriction: With the implementation of the Basic and Premium service tiers in December 2016, Stackdriver Logging began enforcing retention and log source restrictions for projects that are in the Stackdriver Basic tier or are not associated with a Stackdriver account. In the Basic tier, log entries are visible for 7 days after they are received, and logs from non-Google Cloud sources, including Amazon Web Services, are rejected.

December 12, 2016

Logs Viewer v2: The Logs Viewer has been migrated to the Stackdriver Logging API v2. For the full documentation, Viewing Logs (v2). Note: Obsolete link to migration information removed on December 13, 2017. For updated information, see APIs & Reference.

List logs: the Stackdriver Logging API now has "list logs" methods: organizations.logs.list and projects.logs.list.

New LogEntry fields: Fields trace and sourceLocation were added to LogEntry.

November 21, 2016

Organizations: The Stackdriver Logging API now allows both projects and organizations to own logs. A log belonging to an organization is named "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]". See organizations.logs.delete.

Sinks: The Stackdriver Logging API now allows both projects and organizations to own sinks. In addition, sinks can now export log entries to destinations in other projects. See LogSink.

October 20, 2016

Logging is generally available to Google Cloud Platform customers. Individual features that are in Alpha or Beta release are marked as such in the documentation.

Pricing: Stackdriver is now available in Basic and Premium service tiers. All existing and new Stackdriver accounts are entered into a 30-day free trial of the Premium Tier. At the end of the trial period, you could lose some functionality you had during the Beta release unless you upgrade to the Premium Tier. For more details, see Pricing.

API v2: The Stackdriver Logging API v2 is generally available, providing a simplified log format. During a transition period, you can use the same API at either of these two endpoints: https://logging.googleapis.com/v2beta1/... or https://logging.googleapis.com/v2/....

API v1: The Stackdriver Logging API v1 (v1beta3) is deprecated. Users of this API should migrate to the v2 API. The v1 API will be removed from service on March 30, 2017. Note: Obsolete link to migration information removed on December 13, 2017. For updated information, see APIs & Reference.

September 09, 2016

The Google Cloud Logging API is now known as the Stackdriver Logging API. This change does not affect any code.

June 15, 2016

A change to the v2beta1 API might affect some existing code. In the following methods, the parameter projectName has been changed to parent: sinks.create, sinks.list, metrics.list, metrics.create.

The Google Logging API v2beta1 reference documentation now includes code snippets for each method. For example, see entries.list.

April 27, 2016

The user documentation has been reorganized. The documentation landing page and the left-side navigation entries have changed. Existing URLs to individual documentation pages will be redirected if necessary.

March 23, 2016

Google Cloud Logging is now Stackdriver Logging, part of the Google Stackdriver suite of products. You can now manage logs from Amazon EC2 virtual machine instances alongside your Google Cloud projects. See Logging agent for more details.

February 18, 2016

The logging agent authorization instructions now recommend storing private-key credentials as /etc/google/auth/application_default_credentials.json. You do not have to move your existing file at /root/.config/gcloud/application_default_credentials.json.

January 29, 2016

The Logs Viewer now lets you view the structure of log entries. You can also show or hide log entries with similar field values.

December 10, 2015

Version 2 of the Cloud Logging API is now available. Among other changes, the V2 API lets you retrieve log entries from Logging using the entries.list method.

October 22, 2015

The Logs Viewer now has cascading menus for selecting log entries from Google App Engine and Google Compute Engine.

October 13, 2015

See logs-based-metrics to learn how to create Google Cloud Monitoring metrics using logs filters.

The list of log types has been expanded.

September 15, 2015

Added Java examples of Logging API usage. Simplified the authorization code for Java and Python, and the same code now runs on App Engine, Compute Engine, and your development workstation.

September 09, 2015

The command-line interface in the Google Cloud SDK is now named gcloud beta logging.

August 12, 2015

The Cloud Logging API and command-line interface now support project sinks. A project sink can export log entries from any combination of logs, based on advanced logs filters.

August 03, 2015

Cloud Logging now has advanced logs filters that let you specify arbitrary Boolean expressions that match on log entries. See Using advanced logs filters in the Logs Viewer, and the Advanced Logs Filters guide.

June 15, 2015

The logging agent has new, simpler installation instructions You no longer have to edit the agent's configuration file to install private-key authorization.

The Logging documentation has been reorganized. The table of contents now groups all information about the logging agent, viewing logs, and exporting logs in individual sections.

May 21, 2015

A new Google Cloud Console UI panel for the logs export feature was released. The UI lets you export a subset of your logs from a logs service. For example, you could export syslog from Google Compute Engine without exporting activity_log.

April 28, 2015

You can now stream logs from Cloud Logging to Google Cloud Pub/Sub and from there to your own endpoints. This involves changes to logs export. For example, use Cloud Pub/Sub to route logs through Google Cloud Dataflow and into tools like Google BigQuery.

March 19, 2015

The Google Cloud Logging API is now available in Beta release. The API lets you write logs, create logs, and control the export of logs. Client libraries make it easy to use the API in your favorite programming language.

The glcoud logging command-line interface, which uses the API, is now available in Beta release. The commands provide an easy way to perform administrative tasks such configuring logs export.

Cloud Logging is now available in Beta release, allowing you to configure, visualize, analyze and export your Google Compute Engine and Google App Engine logs.

The google-fluentd logging agent runs with additional operating systems, including Debian, Ubuntu, Red Hat, and CentOS. A single script installs the agent on any supported operating system.

The google-fluentd logging agent supports two dozen third-party logs.

The Logs Viewer refresh brings more search options and quicker access to logs export configurations. Regex-search has been removed as part of this refresh.

The Cloud Logging documentation has been improved with more set-up options, simpler procedures and more examples.

January 15, 2015

Beta release: App Engine logs can be exported to Cloud Storage and BigQuery.