نام (NAME)

dqtool - ابزار بررسی و دستکاری صف‌های دیسک در syslog-ng

خلاصه دستور (SYNOPSIS)

dqtool [دستور] [گزینه‌ها]

توضیحات (DESCRIPTION)

نکته: برنامه dqtool همراه با برنامه ثبت وقایع سیستمی syslog-ng OSE توزیع می‌شود و معمولاً بخشی از بسته syslog-ng OSE است. آخرین نسخه برنامه syslog-ng OSE در صفحه وب syslog-ng OSE در دسترس است.

این صفحه راهنما صرفاً یک چکیده است.

برنامه dqtool ابزاری است که می‌تواند برای نمایش و قالب‌بندی پیام‌های ذخیره‌شده در یک فایل بافر دیسک (disk-buffer) استفاده شود.

دستور CAT (THE CAT COMMAND)

cat [options] [file]

از دستور cat برای نمایش پیام‌های ثبت وقایع ذخیره‌شده در فایل بافر دیسک (که صف دیسک یا disk-queue نیز نامیده می‌شود) و همچنین اطلاعات سربرگ فایل صف دیسک استفاده کنید. پیام‌ها در خروجی استاندارد (stdout) چاپ می‌شوند، بنابراین امکان استفاده از grep و سایر ابزارها برای یافتن پیام‌های وقایع خاص وجود دارد؛ برای مثال: dqtool cat /var/log/messages.lgs | grep 192.168.1.1.

دستور cat دارای گزینه‌های زیر است:

--debug یا -d
چاپ پیام‌های تشخیصی و اشکال‌زدایی در stderr.

--help یا -h
نمایش یک پیام راهنمای خلاصه.

--template=<template> یا -t
قالب‌بندی پیام‌ها با استفاده از الگوی مشخص‌شده.

--verbose یا -v
چاپ پیام‌های مشروح در stderr.

--version یا -V
نمایش اطلاعات نسخه.

dqtool cat ../var/syslog-ng-00000.qf

Disk-buffer state loaded;
filename='../var/syslog-ng-00000.qf', qout_length='65', qbacklog_length='0', qoverflow_length='9205', qdisk_length='0'
Mar  3 10:52:05 tristram localprg[1234]: seq: 0000011630, runid: 1267609923, stamp: 2010-03-03T10:52:05 PADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADD
Mar  3 10:52:05 tristram localprg[1234]: seq: 0000011631, runid: 1267609923, stamp: 2010-03-03T10:52:05 PADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADD

دستور RELOCATE (THE RELOCATE COMMAND)

relocate [options] [files]

از دستور relocate برای انتقال یا تغییر نام فایل‌های بافر دیسک (صف دیسک) استفاده کنید. توجه داشته باشید که این گزینه فایل persist را تغییر می‌دهد. پیش از استفاده از این دستور، اجرای syslog-ng OSE را متوقف کنید.

دستور relocate دارای گزینه‌های زیر است:

--all یا -a
انتقال تمامی فایل‌های بافر دیسک که در فایل persist مربوط به syslog-ng OSE فهرست شده‌اند.

--new_path یا -n
دایرکتوری مقصدی که می‌خواهید فایل‌های بافر دیسک را به آن منتقل کنید. برای مثال: /var/disk-buffers

--persist یا -p
مسیر فایل persist مربوط به syslog-ng OSE. دستور relocate به طور خودکار ورودی‌های فایل‌های بافر دیسک را در فایل persist به‌روزرسانی می‌کند.

dqtool relocate --new_path /tmp/dq --persist var/syslog-ng.persist /tmp/syslog-ng-00000.rqf

dqtool relocate --new_path /tmp/dq --persist var/syslog-ng.persist /tmp/syslog-ng-00000.rqf /tmp/syslog-ng-00001.rqf

dqtool relocate --new_path /tmp/dq --persist var/syslog-ng.persist --all

فایل‌ها (FILES)

/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/dqtool

نکته: اگر با هرگونه مشکلی مواجه شدید یا به راهنمایی درباره syslog-ng OSE نیاز دارید، به راهنمای مدیریت syslog-ng OSE[1] مراجعه کنید یا از لیست ایمیل syslog-ng OSE[2] دیدن فرمایید. برای اخبار و اطلاعیه‌های مربوط به syslog-ng OSE، از وبلاگ‌های syslog-ng OSE[3] بازدید نمایید.

نویسنده (AUTHOR)

این صفحه راهنما از راهنمای مدیریت syslog-ng OSE[1] تولید شده است که توسط چندین مشارکت‌کننده نوشته شده و از آن‌ها صمیمانه قدردانی می‌کنیم.

حق نشر (COPYRIGHT)

نکات (NOTES)

[1] syslog-ng OSE Administration Guide
⟨https://syslog-ng.github.io/admin-guide/README⟩

[2] syslog-ng OSE mailing list
⟨https://lists.balabit.hu/mailman/listinfo/syslog-ng⟩

[3] syslog-ng OSE blogs
⟨https://syslog-ng.com/blog⟩