summaryrefslogtreecommitdiffstats
path: root/health/guides/httpcheck/httpcheck_web_service_unreachable.md
diff options
context:
space:
mode:
Diffstat (limited to 'health/guides/httpcheck/httpcheck_web_service_unreachable.md')
-rw-r--r--health/guides/httpcheck/httpcheck_web_service_unreachable.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/health/guides/httpcheck/httpcheck_web_service_unreachable.md b/health/guides/httpcheck/httpcheck_web_service_unreachable.md
new file mode 100644
index 00000000..bb6f51bf
--- /dev/null
+++ b/health/guides/httpcheck/httpcheck_web_service_unreachable.md
@@ -0,0 +1,33 @@
+### Understand the alert
+
+The Netdata agent monitors your HTTP endpoints. You can specify endpoints the Agent will monitor in the Agent's Go module under `go.d/httpcheck.conf`.
+
+If your system fails to connect to your endpoint, or if the request to that endpoint times out, then the Agent will mark the requests and log them as "unreachable".
+
+The Netdata Agent calculates the ratio of these requests over the last 5 minutes. This alert is escalated to warning when the ratio is greater than 10% and then raised to critical when it is greater than 40%.
+
+### Troubleshoot the alert
+
+To troubleshoot this error, check the following:
+
+- Verify that your system has access to the particular endpoint.
+
+ - Check for basic connectivity to known hosts.
+ - Make sure that requests and replies both to and from the endpoint are allowed in the firewall settings. Ensure they're allowed on both your end as well as the endpoint's side.
+
+- Verify that your DNS can resolve endpoints.
+ - Check your current DNS (for example in linux you can use the host command):
+
+ ```
+ host -v <your_endpoint>
+ ```
+
+ - If the HTTP endpoint is suppose to be public facing endpoint, try an alternative DNS (for example Cloudflare's DNS):
+
+ ```
+ host -v <your_endpoint> 1.1.1.1
+ ```
+
+### Useful resources
+
+1. [HTTP endpoint monitoring with Netdata](https://learn.netdata.cloud/docs/agent/collectors/go.d.plugin/modules/httpcheck) \ No newline at end of file