| RRDPYTHON(1) | rrdtool | RRDPYTHON(1) |
نام (NAME)
rrdpython - درباره اتصالهای پایتون RRD
خلاصه دستور (SYNOPSIS)
import rrdtool
rrdtool.create('/tmp/test.rrd', 'DS:foo:GAUGE:20:0:U')
توضیحات (DESCRIPTION)
توابع rrdtool مستقیماً از طریق زبان برنامهنویسی پایتون (Python) قابل فراخوانی هستند. این پیادهسازی لفاف (wrapper) از ابتدا (بدون استفاده از SWIG) نوشته شده است.
این رابط برنامهنویسی (API) رشتهها و/یا فهرستی از رشتهها را بهعنوان پارامترهای توابع میپذیرد. لطفاً برای مشاهده توابع و آرگومانهای معتبر به سایر مستندات rrdtool مراجعه کنید.
مثالها (EXAMPLES)
مثال ۱ (Example 1)
import sys
sys.path.append('/path/to/rrdtool/lib/python2.6/site-packages/')
import rrdtool, tempfile
DAY = 86400
YEAR = 365 * DAY
fd,path = tempfile.mkstemp('.png')
rrdtool.graph(path,
'--imgformat', 'PNG',
'--width', '540',
'--height', '100',
'--start', "-%i" % YEAR,
'--end', "-1",
'--vertical-label', 'Downloads/Day',
'--title', 'Annual downloads',
'--lower-limit', '0',
'DEF:downloads=downloads.rrd:downloads:AVERAGE',
'AREA:downloads#990033:Downloads')
info = rrdtool.info('downloads.rrd')
print info['last_update']
print info['ds[downloads].minimal_heartbeat']
مثال ۲ (Example 2)
import sys
sys.path.append('/path/to/rrdtool/lib/python2.6/site-packages/')
import rrdtool
# in real life data_sources would be populated in loop or something similar
data_sources=[ 'DS:speed1:COUNTER:600:U:U',
'DS:speed2:COUNTER:600:U:U',
'DS:speed3:COUNTER:600:U:U' ]
rrdtool.create( 'speed.rrd',
'--start', '920804400',
data_sources,
'RRA:AVERAGE:0.5:1:24',
'RRA:AVERAGE:0.5:6:10' )
اگر از تارگت ساخت site-python-install استفاده کنید، میتوانید خط اول مربوط به sys.path.append را حذف کنید؛ زیرا ماژول RRDtool در همهجا در دسترس خواهد بود.
اگر RRDtool با مشکلی مواجه شود، یک استثنا (exception) ایجاد میکند که ممکن است بخواهید آن را مدیریت (catch) کنید.
همچنین ببینید (SEE ALSO)
rrdcreate, rrdupdate, rrdgraph, rrddump, rrdfetch, rrdtune, rrdlast, rrdxport, rrdinfo
نویسندگان (AUTHORS)
Hye-Shik Chang <perky@i18n.org>
Alan Milligan <alan.milligan@last-bastion.net>
| 2026-08-08 | 1.11.0 |