Stay organized with collections Save and categorize content based on your preferences.
This is a legacy agent. While this agent is still supported, we recommend against using it for new Google Cloud workloads.Instead, we recommend that you use the Ops Agent for new Google Cloud workloads and eventually transition your existing Compute Engine VMs to use the Ops Agent. The Ops Agent, which combines the collection of metrics and logging into a single agent, is the eventual replacement for the legacy agents.
The Ops Agent is under active development, but there might be some use cases that it doesn't support. If the Ops Agent doesn't support your use case, then you can still use the Logging agent.
There will be no new feature development or support for new operating systems for the legacy Logging agent.
This guide provides basic information about the Logging agent, an application based on fluentd that runs on your virtual machine (VM) instances.
In its default configuration, the Logging agent streams logs from common third-party applications and system software to Logging; review the list of default logs. You can configure the agent to stream additional logs; go to Configure the Logging agent for details on agent configuration and operation.
It is a best practice to run the Logging agent on all your VM instances. The agent runs under both Linux and Windows.
To install the Logging agent, see Installing the Logging agent.
Supported operating systemsYou can run the Logging agent on the following operating systems on compatible virtual machine (VM) instances:
If you're running Container-Optimized OS VMs, then follow the Container-Optimized OS instructions for collecting logs from your VMs.
Supported environmentsThe Logging agent is compatible with the following environments:
Compute Engine instances. The Logging agent sends the logs to the project associated with each VM instance.
For instances without external IP addresses, you must enable Private Google Access to allow the Logging agent to send logs.
Amazon Elastic Compute Cloud (Amazon EC2) instances. The Logging agent sends the logs from AWS to a Google Cloud project.
Note:Use of AWS CloudWatch metrics in Connector projects in Cloud Monitoring was deprecated on August 21, 2023 and is no longer supported. On August 21, 2024, existing AWS Connector projects were turned down and metric ingestion was stopped. For more information about this change, see Deprecation: AWS CloudWatch metrics in Connector projects.
The legacy Monitoring agent and legacy Logging agent on Amazon Elastic Compute Cloud (Amazon EC2) are still supported and aren't being deprecated.
For the Logging agent to function correctly, the Amazon EC2 instance it runs on must be able to communicate with Google Cloud APIs, particularly the Logging API. This requires either an external IP address or a VPC internet gateway.
For these VM instances, a minimum of 250 MiB of resident (RSS) memory is required to run the Logging agent, but 1 GiB is recommended. For example, at a rate of 100 1-KB-sized log entries per second, the Logging agent with default configurations consumes 5% CPU on one core and 150 MiB memory.
The following VM instances support Logging using their own software, so manually installing the Logging agent on them is not supported:
App Engine standard environment instances. App Engine includes built-in support for Logging. For more information, go to Writing application logs.
App Engine flexible environment instances. Apps running in the App Engine flexible environment can write logs that are in addition to what is included in the App Engine standard environment. For more information, go to Writing application logs.
Google Kubernetes Engine node instances. Log collection with Logging is enabled by default for new container clusters, or you can enable it for your existing clusters. For information, see Configuring logging and monitoring for GKE.
For instances running on Google Distributed Cloud, the agent collects system logs but doesn't collect application logs.
Cloud Run container instances. Cloud Run includes built-in support for Logging. For more information, go to Logging and viewing logs.
Cloud Run functions HTTP and background functions. Cloud Run functions includes built-in support for Logging.
Google Cloud partners with Bindplane to provide logging services for on-premise and hybrid cloud platforms in a consistent and predictable way. Using Bindplane, you can collect your own data and send it to Logging for analysis. Bindplane integrates with Cloud Logging to capture data from your infrastructure and is included with your project at no additional cost.
For more information about Bindplane and Bindplane, see About Bindplane and Bindplane.
Agent access requirementsRunning the agent requires access to the following DNS names:
OAuth2 token server: oauth2.googleapis.com
Older versions of the agent may require access to www.googleapis.com (full URL: https://www.googleapis.com/oauth2/v3/token).
If you're using an older version of the agent, it's recommended that you upgrade your agent to the latest version.
Logging APIs: logging.googleapis.com
Installing the agent requires access to the following DNS names:
(Linux) Google Cloud package repository: packages.cloud.google.com
Google download server: dl.google.com
You don't need the information in this section unless you want to understand the source code or you have other special needs. The Logging agent is installed by the script described in the installation instructions.
The Logging agent, google-fluentd, is a modified version of the fluentd log data collector. google-fluentd is distributed in two separate packages. The source code is available from the associated GitHub repositories:
google-fluentd which includes the core fluentd program, the custom packaging scripts, and the output plugin for the Cloud Logging API.
google-fluentd package. It is also available separately at the Ruby gem hosting service at fluent-plugin-google-cloud.google-fluentd-catch-all-config which includes the configuration files for the Logging agent for ingesting the logs from various third-party software packages.The release notes for the google-fluentd Linux package can be found at google-fluentd/releases, where the release tags follow the [Major].[Minor].[Patch] semantic versioning format.
The release notes for the Windows installers can be found at the same location: google-fluentd/releases. But the release tags are prefixed with Windows instead.
The release notes for the stand-alone gem fluent-plugin-google-cloud can be found at fluent-plugin-google-cloud/releases, where the release tags follow the [Major].[Minor].[Patch] semantic versioning format.
The Logging agent is subject to the Google Cloud Observability agents deprecation policy.
Next stepsAfter installing the agent, view your logs in the Logs Explorer.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-11 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-11 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4