Stay organized with collections
Save and categorize content based on your preferences.
Note: The localhost:2020/api/v1/metrics
endpoint mentioned at 3:18 in this video is no longer available in the
Ops Agent. For other options, see
Agent
is running but data is not ingested.
This document describes resoures available to help you troubleshoot problems
with the installation, start-up, and running of the Ops Agent. Troubleshooting
information is organized into the following sections:
Find troubleshooting information:
This document describes where can you find information that
can help you determine what the problem is.
Troubleshoot credentials :
This document describes what to do when you encounter authorization or
credentials problems with the Ops Agent running on Compute Engine VMs.
Troubleshoot installation and start-up:
This document describes what to do if the installation of the agent fails, or
if the agent installs but fails to start.
Troubleshoot data ingestion:
This document describes what to do when the Ops Agent is running, but logs or
metrics are not being ingested into Cloud Logging or Cloud Monitoring
as you expect.
[[["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-25 UTC."],[],[],null,["# Troubleshoot the Ops Agent\n\n**Note:** The `localhost:2020/api/v1/metrics` endpoint mentioned at 3:18 in this video is no longer available in the Ops Agent. For other options, see [Agent\nis running but data is not ingested](/stackdriver/docs/solutions/agents/ops-agent/troubleshoot-run-ingest#data-not-ingested).\n\nThis document describes resoures available to help you troubleshoot problems\nwith the installation, start-up, and running of the Ops Agent. Troubleshooting\ninformation is organized into the following sections:\n\n- [Find troubleshooting information](/stackdriver/docs/solutions/agents/ops-agent/troubleshoot-find-info):\n This document describes where can you find information that\n can help you determine what the problem is.\n\n- [Troubleshoot credentials](/stackdriver/docs/solutions/agents/ops-agent/troubleshoot-credentials):\n This document describes what to do when you encounter authorization or\n credentials problems with the Ops Agent running on Compute Engine VMs.\n\n- [Troubleshoot installation and start-up](/stackdriver/docs/solutions/agents/ops-agent/troubleshoot-install-startup):\n This document describes what to do if the installation of the agent fails, or\n if the agent installs but fails to start.\n\n- [Troubleshoot data ingestion](/stackdriver/docs/solutions/agents/ops-agent/troubleshoot-run-ingest):\n This document describes what to do when the Ops Agent is running, but logs or\n metrics are not being ingested into Cloud Logging or Cloud Monitoring\n as you expect.\n\nFor information about using the Ops Agent on Bare Metal Solution servers, see\n[Set up Ops Agent for Bare Metal Solution](/bare-metal/docs/set-up-ops-agent-for-bms)."]]