From 798fa9de2c8fb214c28f53659156ba63ea544cf9 Mon Sep 17 00:00:00 2001
From: appliedprivacy <33653399+appliedprivacy@users.noreply.github.com>
Date: Mon, 25 Oct 2021 10:56:25 +0000
Subject: [PATCH] docs: describe resource-limits metric

information taken from @rgacogne 's email:
https://mailman.powerdns.com/pipermail/pdns-users/2021-October/027446.html
---
 pdns/recursordist/docs/metrics.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/pdns/recursordist/docs/metrics.rst b/pdns/recursordist/docs/metrics.rst
index 1cf9492ace..340d580d8f 100644
--- a/pdns/recursordist/docs/metrics.rst
+++ b/pdns/recursordist/docs/metrics.rst
@@ -487,6 +487,8 @@ failed-host-entries
 ^^^^^^^^^^^^^^^^^^^
 number of servers that failed to resolve
 
+.. _stat-fd-usage:
+
 fd-usage
 ^^^^^^^^
 Number of currently used file descriptors.
@@ -661,7 +663,10 @@ number of contended record cache lock acquisitions
 
 resource-limits
 ^^^^^^^^^^^^^^^
-counts number of queries that could not be   performed because of resource limits
+Counts the number of queries that could not be performed because of resource limits. 
+This counter is increased when Recursor encounters a network issue that does not seem to be caused by the remote end. 
+For example when it runs out of file descriptors (monitor :ref:`stat-fd-usage`) or when there is no route to a
+given IP address.
 
 security-status
 ^^^^^^^^^^^^^^^
-- 
2.47.2