From fbadd22930e9dae3794720e912aa8d1d8af840f7 Mon Sep 17 00:00:00 2001 From: Ray Colletti Date: Thu, 2 Jan 2014 16:27:13 -0500 Subject: [PATCH 1/2] added troubleshooting section to agent usage home page --- content/guides/basic_agent_usage/index.html | 58 +++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/content/guides/basic_agent_usage/index.html b/content/guides/basic_agent_usage/index.html index e6999cb6f9087..031aff9fe20b8 100644 --- a/content/guides/basic_agent_usage/index.html +++ b/content/guides/basic_agent_usage/index.html @@ -19,3 +19,61 @@

What is the Agent?

The source code for the Datadog Agent can be found here. + + + +

Agent Troubleshooting

+ +

Issues getting the Agent installed

+ +If you encounter any issues during agent installation, please reach out to support@datadoghq.com. +Please let us know your OS and version, as well as how you are installing the Agent (and which agent version). +Also, please include any errors you may have encountered along the way. + + +

Issues getting the Agent reporting

+ +If you get the Agent installed but are not seeing any data in Datadog, you can troubleshoot in the following manner. +First, run the info command. Select your OS in the nav column on the left of this page to see how to run this. +Does running the info command show any errors? + +If not, you should also check the logs (location of the logs again depends on OS). Errors in the logs may also reveal the cause of any issue. + +If not, please send both the full output of the info command and the logs as attachments to support@datadoghq.com. + + + +

Check your machine's time

+We have also seen a few cases where machines have their clock set further in the future or the past, which can sometimes cause problem with metric submission. +To check for this, run: + +date -u && curl -s -v https://app.datadoghq.com/intake 2>&1 | grep Date +

+This will output the current system’s date, and then make a request to our endpoint and grab the date on our end. +If these are more than a few minutes apart, you may want to look at the time settings on your server. +

+ + +

Issues getting integrations working

+ +Datadog has quite a few integrations which are set +up through YAML files in the Agent. + +Here is a quick guide for troubleshooting getting integrations installed: + +1. Run the info command (find this based on your OS in the left column above). +
+2. Is the integration showing up in the info command? + + + No, it's not. + * Check the configuration file, make sure it is in the right location and named correctly. + * Check it in a YAML parser to make sure it has the correct syntax. Example files can be found here. + * If you moved or changed the file, restart the agent and then rerun the info command to see if it is now showing up. + + Yes, it's there. + * Check the Metric's Explorer to see if system metrics are showing up from the host. + * If there are still no metrics, check the logs for errors and please send them along, with the info command output, to support@datadoghq.com. + From 4eae251f84ab1bb8f574c6f1ff9287c47c2c5a95 Mon Sep 17 00:00:00 2001 From: Ray Colletti Date: Thu, 2 Jan 2014 17:12:07 -0500 Subject: [PATCH 2/2] updates from mike and oli- including tags, grammar, mailto, intro --- content/guides/basic_agent_usage/index.html | 35 +++++++++++++-------- 1 file changed, 22 insertions(+), 13 deletions(-) diff --git a/content/guides/basic_agent_usage/index.html b/content/guides/basic_agent_usage/index.html index 031aff9fe20b8..c1c9a4d09c7f1 100644 --- a/content/guides/basic_agent_usage/index.html +++ b/content/guides/basic_agent_usage/index.html @@ -26,29 +26,38 @@

What is the Agent?

====================================================== --> -

Agent Troubleshooting

+

Agent Troubleshooting

+

+If you ended up at this page and have not yet installed the Datadog Agent, please go here for installation instructions. +If you just installed the Agent, it might take a few moments before you start seeing metrics appear. +The first place you can check for metrics is the Metrics Explorer. +

+

+If you think you might be experiencing issues, the first thing to do is run the info command and check the Agent logs. +The info command and the log locations are dependent on your OS, which you can select from the navigation to the left for further information. +

-

Issues getting the Agent installed

+

Issues getting the Agent installed

-If you encounter any issues during agent installation, please reach out to support@datadoghq.com. +If you encountered an issue during the Agent installation that prevented any installation whatsoever from occurring, please reach out to support@datadoghq.com. Please let us know your OS and version, as well as how you are installing the Agent (and which agent version). -Also, please include any errors you may have encountered along the way. +Also, please include the errors you encountered along the way. -

Issues getting the Agent reporting

+

Issues getting the Agent reporting

If you get the Agent installed but are not seeing any data in Datadog, you can troubleshoot in the following manner. First, run the info command. Select your OS in the nav column on the left of this page to see how to run this. Does running the info command show any errors? -If not, you should also check the logs (location of the logs again depends on OS). Errors in the logs may also reveal the cause of any issue. +If not, you should also check the logs (location of the logs again depends on OS). Errors in the logs may also reveal the cause of any issues. -If not, please send both the full output of the info command and the logs as attachments to support@datadoghq.com. +If not, please send both the full output of the info command and the logs as attachments to support@datadoghq.com. -

Check your machine's time

-We have also seen a few cases where machines have their clock set further in the future or the past, which can sometimes cause problem with metric submission. +

Check your machine's time

+We have also seen a few cases where machines have their clock set further in the future or the past, which can sometimes cause problems with metric submission. To check for this, run: date -u && curl -s -v https://app.datadoghq.com/intake 2>&1 | grep Date @@ -58,7 +67,7 @@

Check your machine's time

-

Issues getting integrations working

+

Issues getting integrations working

Datadog has quite a few integrations which are set up through YAML files in the Agent. @@ -72,8 +81,8 @@

Issues getting integrations working

+ No, it's not. * Check the configuration file, make sure it is in the right location and named correctly. * Check it in a YAML parser to make sure it has the correct syntax. Example files can be found here. - * If you moved or changed the file, restart the agent and then rerun the info command to see if it is now showing up. + * If you moved or changed the file, restart the Agent and then rerun the info command to see if it is now showing up. + Yes, it's there. - * Check the Metric's Explorer to see if system metrics are showing up from the host. - * If there are still no metrics, check the logs for errors and please send them along, with the info command output, to support@datadoghq.com. + * Check the Metrics Explorer to see if system metrics are showing up from the host. For example, look for system.cpu.user from the host that is running the Agent and has that integration setup. + * If there are still no metrics, check the logs for errors and please send them along, with the info command output, to support@datadoghq.com.