نام (NAME)

rrdinfo - استخراج اطلاعات سرآیند از یک فایل RRD

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

rrdtool info filename [--daemon|-d address [--noflush|-F]]

توضیحات (DESCRIPTION)

تابع info اطلاعات سرآیند یک RRD را در قالبی مناسب برای تجزیه و پردازش چاپ می‌کند.

اگر درباره معنای هر یک از کلیدها اطمینان ندارید، صفحه راهنمای rrdcreate را بررسی کنید.

filename

نام فایل RRD که می‌خواهید بررسی کنید.

--daemon|-d address

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

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

--noflush|-F

صرف‌نظر کردن از ارسال دستور "flush" که معمولاً پیش از دریافت داده به دیمن فرستاده می‌شود. اگر فقط ساختار RRD برای شما اهمیت دارد و نیازی به زمان آخرین به‌روزرسانی یا مقادیر فعلی ندارید، این گزینه کارایی را بهبود می‌بخشد.

مثال (EXAMPLE)

این خروجی حاصل از اجرای info روی یک RRD ساده شامل دو منبع داده و یک RRA است. توجه کنید که عدد پس از کلیدواژه last_update بر حسب ثانیه از ابتدای سال ۱۹۷۰ است. رشته NaN نمایانگر داده‌های نامشخص (*UNKNOWN*) است. در این مثال، به این معنی است که برای هیچ‌یک از منابع داده این RRD مقدار حداقل یا حداکثر تعریف نشده است.

filename = "random.rrd"
rrd_version = "0001"
step = 300
last_update = 955892996
header_size = 2872
ds[a].type = "GAUGE"
ds[a].minimal_heartbeat = 600
ds[a].min = NaN
ds[a].max = NaN
ds[a].last_ds = "UNKN"
ds[a].value = 2.1824421548e+04
ds[a].unknown_sec = 0
ds[b].type = "GAUGE"
ds[b].minimal_heartbeat = 600
ds[b].min = NaN
ds[b].max = NaN
ds[b].last_ds = "UNKN"
ds[b].value = 3.9620838224e+03
ds[b].unknown_sec = 0
rra[0].cf = "AVERAGE"
rra[0].pdp_per_row = 1
rra[0].cdp_prep[0].value = nan
rra[0].cdp_prep[0].unknown_datapoints = 0
rra[0].cdp_prep[1].value = nan
rra[0].cdp_prep[1].unknown_datapoints = 0

متغیرهای محیطی (ENVIRONMENT VARIABLES)

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

RRDCACHED_ADDRESS

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

نویسنده (AUTHOR)

Tobias Oetiker <tobi@oetiker.ch>