نام (NAME)

rrddump - استخراج محتویات یک RRD به قالب XML

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

rrdtool dump filename.rrd [filename.xml] [--header|-h {none,xsd,dtd}] [--no-header|-n] [--daemon|-d address] [> filename.xml]

توضیحات (DESCRIPTION)

تابع dump محتویات یک RRD را در یک قالب XML خوانا برای انسان (؟) درون یک فایل یا در خروجی استاندارد (stdout) می‌نویسد. این قالب توسط rrdrestore قابل خواندن است. این دو در کنار یکدیگر به شما امکان می‌دهند تا فایل‌های خود را از یک معماری رایانه به معماری دیگر انتقال داده و همچنین محتویات یک فایل RRD را به شیوه‌ای تا حدودی آسان‌تر دستکاری کنید.

filename.rrd

نام فایل RRD که می‌خواهید محتویات آن را استخراج کنید.

filename.xml

نام فایل (اختیاری) که می‌خواهید خروجی XML در آن نوشته شود. در صورت عدم تعیین، XML در خروجی استاندارد چاپ خواهد شد.

--header|-h {none,xsd,dtd}

به‌طور پیش‌فرض، RRDtool یک هدر dtd به فایل xml اضافه می‌کند. در اینجا می‌توانید آن را به یک هدر xsd یا بدون هیچ هادری تغییر دهید.

--no-header|-n

میانبری برای --header=none.

اگر می‌خواهید داده‌های استخراج‌شده را با RRDtool 1.2 بازیابی کنید، باید از گزینهٔ --no-header استفاده کنید؛ زیرا نسخهٔ 1.2 توانایی پردازش هدرهای xml را ندارد.

--daemon|-d address

آدرس دیمن rrdcached. در صورت تعیین، پیش از خواندن فایل‌های RRD، یک دستور "flush" به سرور ارسال می‌شود. این کار به rrdtool اجازه می‌دهد داده‌های تازه را بازگرداند، حتی اگر دیمن برای کش کردن طولانی‌مدت مقادیر پیکربندی شده باشد. هنگام تعیین این گزینه، نام فایل RRD نمایانگر فایلی در سمت سرور است، اما نام فایل خروجی (XML) به سمت محلی اشاره دارد. برای مشاهدهٔ فهرستی از قالب‌های پذیرفته‌شده، به گزینهٔ -l در راهنمای rrdcached مراجعه کنید.

rrdtool dump --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd

مثال‌ها (EXAMPLES)

برای انتقال یک RRD میان معماری‌های مختلف، مراحل زیر را دنبال کنید:

1.: در همان سیستمی که RRD ایجاد شده است، از rrdtool dump برای برون‌ریزی داده‌ها به قالب XML استفاده کنید.
2.: فایل XML استخراج‌شده را به سیستم مقصد انتقال دهید.
3.: دستور rrdtool restore را اجرا کنید تا یک RRD جدید از فایل XML استخراج‌شده ایجاد شود. برای جزئیات بیشتر به rrdrestore مراجعه کنید.

محیط (ENVIRONMENT)

از متغیرهای محیطی زیر می‌توان برای تغییر رفتار "rrdtool dump" استفاده کرد:

RRDCACHED_ADDRESS: اگر این متغیر محیطی تنظیم شده باشد، همان اثری را خواهد داشت که تعیین گزینهٔ "--daemon" در خط فرمان دارد. در صورت وجود هر دو، آرگومان خط فرمان اولویت دارد.

نویسندگان (AUTHORS)

Tobias Oetiker <tobi@oetiker.ch>