---
title: Agent Troubleshooting
description: >-
  Comprehensive troubleshooting guide for common Datadog Agent issues including
  installation, connectivity, and configuration problems.
breadcrumbs: Docs > Agent > Agent Troubleshooting
---

# Agent Troubleshooting

If you have not yet installed the Datadog Agent, go [to the dedicated Agent integration page](https://app.datadoghq.com/account/settings/agent/latest) for installation instructions. If you just installed the Agent, it may take a few moments before you start seeing metrics appear. The first place you should check for metrics is the [Metrics Explorer](https://app.datadoghq.com/metric/explorer).

If you think you might be experiencing issues, follow this checklist first:

- Is your Agent container stopping right after starting? It can be a [hostname](https://docs.datadoghq.com/agent/troubleshooting/hostname_containers/) detection issue.
- Is your host connected to the internet or able to access it through a proxy?
- If using a proxy: is your [Agent configured for this proxy](https://docs.datadoghq.com/agent/configuration/proxy/)?
- Is the Datadog API key set up in your `datadog.yaml` configuration file [the API key corresponding to your Datadog platform](https://app.datadoghq.com/organization-settings/api-keys)?
- Is the site configured in your `datadog.yaml` configuration file [matching the one from your organization](https://docs.datadoghq.com/agent/troubleshooting/site/)?
- Is there only one Datadog Agent running on your host?
- Did you restart the Datadog Agent after editing a yaml configuration file?

If the answer to all questions above is `yes`, then [run the status command](https://docs.datadoghq.com/agent/configuration/agent-commands/#agent-status-and-information) for more details about your Agent and its integrations status. You can also check the [Agent logs](https://docs.datadoghq.com/agent/configuration/agent-log-files/) directly and enable debug mode to [get more logging from the Agent](https://docs.datadoghq.com/agent/troubleshooting/debug_mode/).

If you're still unsure about the issue, you may reach out to the [Datadog support team](https://docs.datadoghq.com/help/) with [a flare](https://docs.datadoghq.com/agent/troubleshooting/send_a_flare/) from your Agent.

## Further Reading{% #further-reading %}

- [Agent hostname resolution in containers](https://docs.datadoghq.com/agent/troubleshooting/hostname_containers/)
- [Agent Debug Mode](https://docs.datadoghq.com/agent/troubleshooting/debug_mode/)
- [Send an Agent Flare](https://docs.datadoghq.com/agent/troubleshooting/send_a_flare/)
- [Agent Permission Issues](https://docs.datadoghq.com/agent/troubleshooting/permissions/)
- [Check Agent Site](https://docs.datadoghq.com/agent/troubleshooting/site/)
- [Agent NTP issues](https://docs.datadoghq.com/agent/troubleshooting/ntp/)
- [Get the Status of an Agent Check](https://docs.datadoghq.com/agent/troubleshooting/agent_check_status/)
- [High CPU or memory consumption](https://docs.datadoghq.com/agent/troubleshooting/high_memory_usage/)