For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/google-stackdriver-logging.md. A documentation index is available at /llms.txt.

Google StackDriver Logging

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [email protected].

Overview

The Google Cloud Logging product allows you to store, search, analyze, monitor, and alert on log data and events from Google Cloud Platform.

Datadog pulls metrics from Google Cloud Logging to:

  • Visualize the performance of your Google Cloud logs.
  • Correlate the performance of your Google Cloud logs with your applications.

Setup

Installation

Metrics from Google Cloud logs are included as part of the Google Cloud Platform integration. There are no additional installation steps required.

Log collection

Google Cloud logs are collected with Google Cloud Logging and sent to a Dataflow job through a Cloud Pub/Sub topic. If you haven’t already, set up logging with the Datadog Dataflow template.

Data Collected

Metrics

gcp.logging.billing.bytes_ingested
(count)
Number of bytes streamed into log buckets for indexing, querying, and analysis; includes up to 30 days of storage.
Shown as byte
gcp.logging.billing.monthly_bytes_ingested
(gauge)
Month-to-date number of bytes streamed into log buckets for indexing, querying, and analysis; includes up to 30 days of storage.
Shown as byte
gcp.logging.byte_count
(count)
Total bytes of log entries, either written directly or routed to this project via project-sink, that are stored in at least one log bucket.
Shown as byte
gcp.logging.dropped_log_entry_count
(count)
(Deprecated) Number of log entries that did not contribute to user defined metrics.
Shown as entry
gcp.logging.excluded_byte_count
(count)
Number of bytes in log entries that were excluded.
Shown as byte
gcp.logging.excluded_log_entry_count
(count)
Number of log entries that were excluded.
Shown as entry
gcp.logging.exports.byte_count
(count)
Number of bytes in log entries that were exported.
Shown as byte
gcp.logging.exports.error_count
(count)
Number of log entries that failed to be exported.
gcp.logging.exports.log_entry_count
(count)
Number of log entries that were exported.
gcp.logging.log_entry_count
(count)
Number of log entries, either written directly or routed to this project via project-sink, that are stored in at least one log bucket. By default, log entries are stored for 30 days. Excluded logs are not counted.
gcp.logging.logs_based_metrics_error_count
(count)
Number of log entries, either written directly or routed to this project via project-sink, and are stored in a log bucket but excluded from any system or user-defined logs-based metrics. This condition can occur if the timestamp of a log entry is more than 24 hours older, or 10 minutes newer, than the actual receive time.
gcp.logging.metric_throttled
(gauge)
Indicates if labels or points are being dropped for logs-based metrics due to exceeding active time series (cardinality) limits.
gcp.logging.time_series_count
(gauge)
Active time series (cardinality) estimates for logs-based metrics. Only metric labels are counted and the estimate is computed over approximately 25 hours.

Note: Datadog collects Google Cloud Logging user-defined metrics with the prefix gcp.logging.user.

Events

The Google Cloud Logging integration does not include any events.

Service Checks

The Google Cloud Logging integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles: