diff --git a/CRM/Core/Error.php b/CRM/Core/Error.php
index 1e0a7184013a..92f14f1d9a62 100644
--- a/CRM/Core/Error.php
+++ b/CRM/Core/Error.php
@@ -566,6 +566,10 @@ public static function debug_var($variable_name, $variable, $print = TRUE, $log
    * Provided the user has the 'view debug output' the output should be displayed. In all
    * cases it should be logged.
    *
+   * @deprecated see https://docs.civicrm.org/dev/en/latest/framework/logging/
+   *
+   * Use (e.g) `Civi::log()->error()` (priority dependent).
+   *
    * @param string $message
    * @param bool $out
    *   Should we log or return the output.