BIND9_QUERY2DLF.IN(1) LogReport's Lire Documentation BIND9_QUERY2DLF.IN(1)

bind9_query2dlf - تبدیل گزارش‌های پرسمان BIND9 به قالب dlf

bind9_query2dlf

دستور bind9_query2dlf فایل‌های لاگ پرسمان (query log) نسخه BIND 9 را از ورودی استاندارد (stdin) دریافت می‌کند.

اگر در فایل named.conf خود پیکربندی زیر را داشته باشید:

channel query_logging {
        file "/var/log/named_querylog"
        versions 3 size 100M;
        print-time yes;                 // timestamp log entries
};

فایل‌های لاگ تولیدشده پشتیبانی می‌شوند. همچنین در صورت تمایل می‌توانید خطوط زیر را به این کانال اضافه کنید:

print-category yes;             // print category name
print-severity yes;             // print severity level

لاگ‌های پرسمان تولیدشده توسط BIND وصله‌شده (پچ‌شده - بخش «نکات» در زیر را ببینید) نیز پشتیبانی می‌شوند.

همچنین لاگ‌های Bind 9.3 که از قالب تاریخ جدید (15-Jul-2002) به جای قالب قدیمی syslog استفاده می‌کنند، پشتیبانی می‌شوند.

در صورت فعال بودن گزینه‌های print-time، print-category و print-severity:

Feb 25 11:09:43.651 queries: info: client 10.0.0.3#1035:
 query: 3.example.com.nl IN A
Feb 25 11:09:48.739 queries: info: client 10.0.0.3#1035:
 query: 3.example.com.nl IN A
Feb 25 12:50:32.476 queries: info: client 10.0.0.3#1035:
 query: 21.example.com.co.uk IN A
Feb 25 12:50:34.110 queries: info: client 10.0.0.3#1035:
 query: 22.example.com IN A
Feb 25 12:50:34.525 lame-servers: info: lame server on
 '22.example.com' (in '23.example.com'?): 10.0.0.4#53
Feb 25 12:50:34.715 queries: info: client 10.0.0.3#1035:
 query: 24.example.com IN A
Feb 26 07:30:08.211 queries: info: client 10.0.0.1#1050:
 query: 1.0.0.10.in-addr.arpa IN PTR
Feb 26 12:26:55.455 queries: info: client 10.0.0.1#1051:
 query: 28.example.com.nl IN MX
Feb 04 04:02:00.932 general: info: loading configuration
 from '/etc/336.example.com'
Feb 18 04:02:01.023 security: warning: zone
 '337.example.com.nl' allows updates by IP address, which
 is insecure
Feb 18 04:02:01.049 config: warning: option 'use-id-pool'
 is obsolete
Feb 18 04:02:01.049 config: warning: option 'check-names'
 is not implemented
Feb 18 04:02:01.049 config: warning: option
 'statistics-interval' is not yet implemented
Feb 18 04:02:01.049 network: info: no IPv6 interfaces found
Feb 04 16:47:18.289 security: info: client 10.0.0.201#137:
 query denied
Feb 20 07:26:53.731 general: info: running
Feb 13 08:01:56.138 general: info: shutting down
Feb 13 08:01:56.140 network: info: no longer listening on
 10.0.0.3#53
Feb 14 08:02:13.983 general: info: refresh_callback: zone
 384.example.com/IN: failure for 10.0.0.204#53: timed out

فقط با تنظیم بودن گزینه print-time:

Aug 27 04:07:13.361 client 127.0.0.1#3123: query: foo.com IN ANY
Aug 27 04:07:13.438 client 127.0.0.1#3123: query: fu.bar.nl IN AAAA
Aug 27 04:07:13.443 client 127.0.0.1#3123: query: fu.bar.nl IN A

برای پردازش یک لاگ تولیدشده توسط bind9:

$ bind9_query2dlf < dns-query

دستور bind9_query2dlf به‌ندرت به‌تنهایی استفاده می‌شود و بیشتر توسط lr_log2report فراخوانی می‌گردد:

$ lr_log2report bind9_query < /var/log/dns-query

نسخه‌های BIND 9 قبل از 9.3 مشخص نمی‌کردند که آیا پرسمان بازگشتی (recursive) بوده است یا خیر، بنابراین آخرین فیلد dlf یعنی (DLF_RESOLVER) مقدار '-' خواهد بود. با این حال، با اعمال وصله زیر ارائه‌شده توسط Wytze van der Raay:

# patch bin/named/query.c to log recursive/non-recursive query indication
SRC=bin/named/query.c
if [ -f ${SRC}.org ]
then
        echo "Patched ${SRC} already in place"
else
        echo "Patch ${SRC} for recursive/non-recursive query indication"
        cp -p ${SRC} ${SRC}.org
        patch -p0 ${SRC} <<\!
--- bin/named/query.c.org       Mon Sep 24 22:57:48 2001
+++ bin/named/query.c   Tue Sep 25 09:55:21 2001
@@ -3272,7 +3272,8 @@
        dns_rdatatype_format(rdataset->type, typename, sizeof(typename));
        ns_client_log(client, NS_LOGCATEGORY_QUERIES, NS_LOGMODULE_QUERY,
-                     level, "query: %s %s %s", namebuf, classname, typename);
+                     level, "query: %s %s %s%s", namebuf, classname, typename,
+                     WANTRECURSION(client) ? "+" : "-");
 }
 void
!
fi

خطوط لاگی مشابه نمونه زیر تولید خواهند شد:

Nov 11 12:06:42.829 queries: info: client 10.0.0.1#3664:
  query: 6.example.com.nl IN A+

علامت '+' نشان‌دهنده پرسمان بازگشتی (recursive) و علامت - نشان‌دهنده پرسمان غیربازگشتی است؛ عدم وجود + یا - نشان‌دهنده نسخه وصله‌نشده پیش از 9.3 در bind9 است. به پیام Wytze در تاریخ جمعه ۲۸ دسامبر ۲۰۰۱ در bind9-workers@isc.org که در نشانی http://www.mail-archive.com/bind9-workers@isc.org/msg00501.html آرشیو شده است مراجعه نمایید.

این نوع فایل‌های لاگ توسط این اسکریپت شناسایی و پشتیبانی می‌شوند.

نسخه BIND 9.3 یا بالاتر پشتیبانی کاملی از این قابلیت لاگ‌گیری ارائه می‌دهد. علاوه بر این، اطلاعات view، امضاکننده (signer) و EDNS را نیز ثبت می‌کند که همگی در این نسخه از اسکریپت نادیده گرفته می‌شوند.

در یک گفتگوی خصوصی در تاریخ پنجشنبه ۱۸ ژوئیه ۲۰۰۲، Wytze نوشت:

This contains the "ISC-compatible" version of  the patch for getting a
recursive/non-recursive request logged. ISC decided there should be a space
between the type and the recursion indicator in the logfile, so be it.

اگر مایلید BIND 9.2.1 شما به سبک سازگار با ISC در نسخه 9.3 لاگ‌گیری کند، این وصله را روی سورس‌های BIND خود اعمال کنید:

--- bin/named/query.c.org       Thu Mar 28 06:10:09 2002
+++ bin/named/query.c   Wed Jul 17 08:14:41 2002
@@ -3279,7 +3279,8 @@
        dns_rdatatype_format(rdataset->type, typename, sizeof(typename));
        ns_client_log(client, NS_LOGCATEGORY_QUERIES, NS_LOGMODULE_QUERY,
-                     level, "query: %s %s %s", namebuf, classname, typename);
+                     level, "query: %s %s %s %s", namebuf, classname, typename,
+                     WANTRECURSION(client) ? "+" : "-");
 }
 void

این اسکریپت هر دو سبک نشانگر بازگشتی Wytze و ISC را به خوبی درک و پشتیبانی می‌کند.

با تشکر از Wytze van der Raay برای ارائه پچ لاگ پرسمان BIND 9.

bind8_query2dlf(1)، مستندات آنلاین bind9 که همراه با BIND توزیع شده است (البته در نشانی http://isc.org در دسترس نیست، اما مستندات در نشانی http://doc.mdcc.cx/doc/bind/html/logging.html می‌تواند مفید باشد).

$Id: bind9_query2dlf.in,v 1.7 2006/07/23 13:16:33 vanbaal Exp $

کپی‌رایت (C) 2001 Joost Bekkers <joost@jodocus.org>، کپی‌رایت (C) 2000, 2001, 2002 Stichting LogReport Foundation LogReport@LogReport.org

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد (نسخه ۲ یا به انتخاب خود هر نسخه بالاتر) بازتوزیع کرده یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی تجاری بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.

شما باید همراه با این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت به نشانی http://www.gnu.org/copyleft/gpl.html مراجعه نمایید.

Joost Bekkers <joost@jodocus.org> بر پایه کارهای Edwin Groothuis و Joost van Baal، و در حال حاضر توسط تیم LogReport نگهداری می‌شود.

2025-09-28 Lire 2.1.1