summaryrefslogtreecommitdiffstats
path: root/health/guides/haproxy
diff options
context:
space:
mode:
Diffstat (limited to 'health/guides/haproxy')
-rw-r--r--health/guides/haproxy/haproxy_backend_server_status.md46
-rw-r--r--health/guides/haproxy/haproxy_backend_status.md49
2 files changed, 95 insertions, 0 deletions
diff --git a/health/guides/haproxy/haproxy_backend_server_status.md b/health/guides/haproxy/haproxy_backend_server_status.md
new file mode 100644
index 000000000..3d95921ec
--- /dev/null
+++ b/health/guides/haproxy/haproxy_backend_server_status.md
@@ -0,0 +1,46 @@
+### Understand the alert
+
+The `haproxy_backend_server_status` alert is triggered when one or more backend servers that are managed by HAProxy are inaccessible or offline. HAProxy is a reverse-proxy that provides high availability, load balancing, and proxying for TCP and HTTP-based applications. If you receive this alert, it means that there may be a problem with your backend server(s), and incoming requests could face delays or not be processed correctly.
+
+### Troubleshoot the alert
+
+1. **Check the HAProxy backend server status**
+
+ You can check the status of each individual backend server by accessing the HAProxy Statistics Report. By default, this report can be accessed on the HAProxy server using the URL:
+
+ ```
+ http://<Your-HAProxy-Server-IP>:9000/haproxy_stats
+ ```
+
+ Replace `<Your-HAProxy-Server-IP>` with the IP address of your HAProxy server. If you have configured a different port for the statistics report, use that instead of `9000`.
+
+ In the report, look for any backend server(s) with a `DOWN` status.
+
+2. **Investigate the problematic backend server(s)**
+
+ For each of the backend servers that are in a `DOWN` status, check the availability and health of the server. Make sure that the server is running, and check its resources (CPU, memory, disk space, network) to identify any potential issues.
+
+3. **Validate the HAProxy configuration**
+
+ As mentioned in the provided guide, it is essential to validate the correctness of the HAProxy configuration file. If you haven't already, follow the steps in the guide to check for any configuration errors or warnings.
+
+4. **Check for recent changes**
+
+ If the backend servers were previously working correctly, inquire about any recent changes to the infrastructure, such as software updates or configuration changes.
+
+5. **Restart the HAProxy service**
+
+ If the backend server(s) seem to be healthy, but the alert still persists, try restarting the HAProxy service:
+
+ ```
+ sudo systemctl restart haproxy
+ ```
+
+6. **Monitor the alert and backend server status**
+
+ After applying any changes or restarting the HAProxy service, monitor the alert and the backend server status in the HAProxy Statistics Report to see if the issue has been resolved.
+
+### Useful resources
+
+1. [HAProxy Configuration Manual](https://cbonte.github.io/haproxy-dconv/2.0/configuration.html)
+2. [HAProxy Log Customization](https://www.haproxy.com/blog/introduction-to-haproxy-logging/)
diff --git a/health/guides/haproxy/haproxy_backend_status.md b/health/guides/haproxy/haproxy_backend_status.md
new file mode 100644
index 000000000..47be09c73
--- /dev/null
+++ b/health/guides/haproxy/haproxy_backend_status.md
@@ -0,0 +1,49 @@
+### Understand the alert
+
+This alert monitors the average number of failed HAProxy backends over the last 10 seconds. If you receive this alert in a critical state, it means that one or more HAProxy backends are inaccessible or offline.
+
+HAProxy is a reverse-proxy that provides high availability, load balancing, and proxying for TCP and HTTP-based applications. A backend in HAProxy is a set of servers that receive forwarded requests and are defined in the backend section of the configuration.
+
+### Troubleshoot the alert
+
+- Check the HAProxy configuration file for errors
+
+ Making changes in the configuration file may introduce errors. Always validate the correctness of the configuration file. In most Linux distros, you can run the following check:
+
+ ```
+ haproxy -c -f /etc/haproxy/haproxy.cfg
+ ```
+
+- Check the HAProxy service for errors
+
+ 1. Use `journalctl` and inspect the log:
+
+ ```
+ journalctl -u haproxy.service --reverse
+ ```
+
+- Check the HAProxy log
+
+ 1. By default, HAProxy logs under `/var/log/haproxy.log`:
+
+ ```
+ cat /var/log/haproxy.log | grep 'emerg\|alert\|crit\|err\|warning\|notice'
+ ```
+
+ You can also search for log messages with `info` and `debug` tags.
+
+- Investigate the backend servers
+
+ 1. Verify that the backend servers are online and accepting connections.
+ 2. Check the backend server logs for any errors or issues.
+ 3. Ensure that firewall rules or security groups are not blocking traffic from HAProxy to the backend servers.
+
+- Review the HAProxy load balancing algorithm and configuration
+
+ 1. Analyze the load balancing algorithm used in the configuration to ensure it is suitable for your setup.
+ 2. Check for any misconfigurations, such as incorrect server addresses, ports, or weights.
+
+### Useful resources
+
+1. [The Four Essential Sections of an HAProxy Configuration](https://www.haproxy.com/blog/the-four-essential-sections-of-an-haproxy-configuration/)
+2. [HAProxy Explained in DigitalOcean](https://www.digitalocean.com/community/tutorials/an-introduction-to-haproxy-and-load-balancing-concepts) \ No newline at end of file