The Ops Agent is now Generally Available. The GA version incorporates fixes and improvements based on the feedback from Preview users. This guide provides migration steps for the following users:
Ops Agent Preview users to migrate to the GA version of the agent.
Users of the legacy Logging and Monitoring agents to migrate to the Ops Agent.
Migrating from Ops Agent Preview to the GA version
To install the latest version of the Ops Agent, complete the Upgrading the agent procedures.
If you edited the agent's default configuration to remove the
default_pipeline
, add the following snippet to the agent
configuration to
keep that pipeline disabled:
logging:
service:
pipelines:
default_pipeline:
receivers: []
exporters: []
metrics:
service:
pipelines:
default_pipeline:
receivers: []
exporters: []
Changes in commands for managing the Ops Agent
The following table lists the commands for managing the agent that changed for the GA release:
Procedure | GA version | Preview version |
---|---|---|
Starting the agent | sudo service google-cloud-ops-agent start |
N/A |
Stopping the agent | sudo service google-cloud-ops-agent stop |
N/A |
Restarting the agent | sudo service google-cloud-ops-agent restart |
sudo systemctl restart google-cloud-ops-agent.target |
Checking agent status | sudo service google-cloud-ops-agent status |
sudo systemctl status google-cloud-ops-agent.target |
Migrating from the legacy agents to the Ops Agent
To migrate from the legacy Logging and Monitoring agents, complete the following steps.
Uninstall the Logging and the Monitoring agents.
After you uninstall the agent, the Google Cloud console might take up to one hour to report this change.
Install the latest version of the Ops Agent on a single virtual machine.
You also have the option of installing and managing the Ops Agent on multiple VMs.
Configure the Ops Agent as needed.
Differences in how metrics are collected
The following table describes differences in the data ingested by the Ops Agent and the Monitoring agent.Metric type, omittingagent.googleapis.com |
Ops Agent (GA)† | Ops Agent (Preview)† | Monitoring agent |
---|---|---|---|
cpu_state |
The possible values for Windows are
idle , interrupt, system and user . |
The possible values for Windows are
idle , interrupt, system and user . |
The possible values for Windows are
idle and used .
|
disk/bytes_used anddisk/percent_used |
Ingested with the full path in the device label;
for example, /dev/sda15 .Not ingested for virtual devices like tmpfs and udev . |
Ingested without /dev in the path in the
device label; for example, sda15 .Ingested for virtual devices like tmpfs and udev . |
Ingested without /dev in the path in the
device label; for example, sda15 .Ingested for virtual devices like tmpfs and udev . |