rrdcached - מקוון בענן

תָכְנִית:

שֵׁם

rrdcached - שרת שמירת נתונים במטמון עבור rrdtool

תַקצִיר

rrdcached [-a גודל_הקצאה] [-b base_dir [-B]] [-F] [-f פסק זמן] [-G קבוצה]] [-g]
[-j journal_dir] [-L] [-l כתובת] [-m מצב] [-O] [-P הרשאות] [-p pid_file] [-R]
[-s קבוצה] [-t write_threads] [-U המשתמש]] [-w פסק זמן] [-z עיכוב]

תיאור

rrdcached הוא דמון שמקבל עדכונים לקבצי RRD קיימים, אוסף אותם ו...
אם התקבלו מספיק עדכונים או שחלף זמן מוגדר, כותב את העדכונים ל-RRD
קוֹבֶץ. א סומק ניתן להשתמש בפקודה כדי לאלץ כתיבה של ערכים לדיסק, כך שניתן יהיה ליצור גרפים
מתקנים ודומיהם יכולים לעבוד עם נתונים עדכניים.

הדמון נכתב תוך מחשבה על הגדרות גדולות. הגדרות אלו בדרך כלל נתקלות בבעיות הקשורות ל-IO.
בעיות במוקדם או במאוחר מסיבות שאינן קשורות לתחום של מסמך זה. בדוק את
ויקי בדף הבית של RRDtool לפרטים. עיינו גם ב"שיקולי אבטחה" למטה.
לפני השימוש בדמון הזה! ניתן למצוא תיאור מפורט של אופן פעולתו של הדמון
בסעיף "איך זה עובד" למטה.

אפשרויות

-l כתובת
אומר לדמון להיקשר ל כתובת ולקבל חיבורי TCP נכנסים על זה
שקע. אם כתובת מתחיל ב-"unix:", כל מה שבא אחרי הקידומת הזו הוא
מתפרש כנתיב לשקע תחום של יוניקס. אחרת הכתובת או שם הצומת
נפתרים באמצעות "getaddrinfo()".

עבור שקעי רשת, ניתן לציין פורט באמצעות הטופס "[כתובת]:נָמָל". אם
הכתובת היא כתובת IPv4 או שם מתחם מלא (כלומר, הכתובת
מכיל לפחות נקודה אחת (".")), ניתן להשמיט את הסוגריים המרובעים, וכתוצאה מכך
(פשוט יותר)"כתובת:נָמָל" תבנית. יציאת ברירת המחדל היא 42217אם תציין רשת
שקע, חובה לקרוא את הסעיף "שיקולי אבטחה".

הפורמטים הבאים מתקבלים. שימו לב שכתובת הדומיין של יוניקס
שקע צריך תתחילו עם קו נטוי במקרה השני!

יוניקס:
/

[ ]:
:

בהינתן פורט ללא מארח (למשל "-l :42217") הדמון יאזין לפורט זה ב-
כל ממשקי הרשת. השתמש ב-"-L" כדי להימנע מהצורך לספק במפורש את הפורט אם
יציאת ברירת המחדל הרצויה.

אם לא -l לא צוין אפשרות, כתובת ברירת המחדל, "unix:/tmp/rrdcached.sock", תעשה זאת.
ניתן להשתמש בו. מרובים -l ייתכן שיינתנו אפשרויות.

-L מורה ל-daemon להיקשר ליציאת TCP המוגדרת כברירת מחדל בכל הממשקים הזמינים. זה
שווה ערך ל-"-l ''" ללא הבלבול של פרמטר המחרוזת הריקה.

-s שם קבוצה|gid
הגדר את הרשאות הקבוצה של socket תחום UNIX. האפשרות מקבלת מספר
מזהה קבוצה או שם קבוצה. לקבוצה זו יהיו הרשאות קריאה וכתיבה (ה-
ל-socket יהיו הרשאות קובץ 0760) עבור ה-socket ולכן הוא יוכל לשלוח
פקודות לדמון. זה עשוי להיות שימושי במקרים בהם אינך יכול להריץ בקלות את כל
תהליכי RRD עם אותן הרשאות משתמש (למשל, סקריפטי CGI ליצירת גרפים ש
בדרך כלל פועל בהקשר של הרשאות של שרת האינטרנט).

אפשרות זו משפיעה על הבא כתובות שקע יוניקס (הבאות -l אפשרויות) או
שקע ברירת המחדל (אם אין -l אפשרויות שצוינו), כלומר, אתה רשאי לציין
הגדרות שונות עבור שקעים שונים.

ברירת המחדל היא לא לשנות בעלות או הרשאות של השקע, ולכן, להשתמש ב-
ברירת מחדל של המערכת.

-m מצב
הגדר את הרשאות הקובץ של socket תחום UNIX. האפשרות מקבלת מספר אוקטלי
המייצג את תבנית הביטים עבור המצב (ראה chmod(1) לפרטים).

שימו לב שלא כל המערכות מכבדות הגדרה זו. בלינוקס, הרשאות קריאה/כתיבה
נדרשים להתחבר לשקע יוניקס. עם זאת, מערכות רבות הנגזרות מ-BSD מתעלמות מ-
הרשאות עבור שקעי יוניקס. ראה יוניקס(7) לפרטים.

אפשרות זו משפיעה על הבא כתובות שקע יוניקס (הבאות -l אפשרויות) או
שקע ברירת המחדל (אם אין -l אפשרויות שצוינו), כלומר, אתה רשאי לציין
הגדרות שונות עבור שקעים שונים.

ברירת המחדל היא לא לשנות בעלות או הרשאות של השקע, ולכן, להשתמש ב-
ברירת מחדל של המערכת.

-P הפקודה[,הפקודה[,...]]
מציין את הפקודות המתקבלות הן דרך רשת והן דרך שקע יוניקס. זה מאפשר
מנהלי RRDCacheD כדי לשלוט בפעולות המתקבלות ממקורות שונים.

הטיעונים שניתנו בפני ה- -P האפשרות היא רשימה של פקודות מופרדות בפסיקים. עבור
לדוגמה, כדי לאפשר את הפקודות "FLUSH" ו-"PENDING" ניתן לציין:

rrdcached -P ניקוי, ממתין לעוד $ARGUMENTS

השמיים -P אפשרות משפיעה על הבא כתובות שקע (הבאות -l אפשרויות) או ה
שקע ברירת מחדל (אם אין -l אפשרויות צוינו). בדוגמה הבאה, רק
שקע הרשת IPv4 (כתובת 10.0.0.1) יוגבל ל-"FLUSH" ו-
פקודות "ממתינות":

rrdcached -l unix:/some/path -P ניקוי,ממתין -l 10.0.0.1

רשימה מלאה של פקודות זמינות ניתן למצוא בסעיף "פקודות תקפות"
להלן. ישנם שני יוצאים מן הכלל קטנים ומיוחדים:

· הפקודות "HELP" ו-"QUIT" מותרות תמיד.

· אם הפקודה "BATCH" מתקבלת, ה- . הפקודה תתקבל אוטומטית,
מדי.

אנא קראו גם את "שיקולי אבטחה" להלן.

-w פסק זמן
נתונים נכתבים לדיסק כל פסק זמן שניות. ניתן להשתמש בסיומת אופציונלית (לדוגמה
"5 דקות" במקום 300 שניות). אם אפשרות זו לא צוינה, מרווח ברירת המחדל של
ייעשה שימוש ב-300 שניות.

-z עיכוב
אם צוין, rrdcached יעכב את כתיבת כל RRD למספר אקראי של שניות.
בטווח [0,עיכוב). זה ימנע יותר מדי כתיבות שיהיו בתור בו זמנית.
ערך זה לא צריך להיות גדול מהערך שצוין ב -wסיומת אופציונלית
ניתן להשתמש ב-(לדוגמה, "3 דקות" במקום 180 שניות). כברירת מחדל, אין עיכוב.

-f פסק זמן
כל פסק זמן שניות, כל המטמון נחפש אחר ערכים ישנים שנכתבים אליהם
דיסק. זה נוגע רק לקבצים שהעדכונים שלהם הופסקו, לכן הגדרת זה ל-
ערך גבוה, כגון 3600 שניות, מקובל ברוב המקרים. סיומת אופציונלית עשויה להיות
ניתן להשתמש בו (לדוגמה "שעה אחת" במקום 1 שניות). זמן קצוב זה מוגדר כברירת מחדל ל-3600 שניות.

-p פילה
קובע את השם והמיקום של קובץ ה-PID. אם לא צוין, ברירת המחדל,
""‎$localstatedir/run/rrdcached.pid" יהיה בשימוש.

-t write_threads
מציין את מספר השלבים המשמשים לכתיבת קבצי RRD. ברירת המחדל היא 4.
הגדלת מספר זה תאפשר ל-rrdcached לקבל יותר בקשות קלט/פלט בו זמנית
לתוך הליבה. זה עשוי לאפשר לליבה לסדר מחדש את כתיבות הדיסק, וכתוצאה מכך
תפוקת דיסק טובה יותר.

-j dir
כתיבת עדכונים ליומן ב dirבמקרה של קריסת תוכנית או מערכת, זה
יאפשר לדמון לכתוב כל עדכון שהיו ממתינים בזמן הקריסה.

בעת ההפעלה, הדמון יבדוק אם יש קבצי יומן בספרייה זו. אם יימצאו, כל
עדכונים בהם ייקראו לזיכרון לפני שהדמון יתחיל לקבל חדשים
קשרים.

היומן יסתובב באותה תדירות כמו טיימר השטיפה שניתן על ידי -f.

כאשר רישום יומן מופעל, הדמון ישתמש בהליך כיבוי מהיר.
מאשר ריקון כל הקבצים לדיסק, זה יבטיח שהיומן נכתב כראוי
צא באופן מיידי. למרות שקבצי הנתונים של RRD אינם מעודכנים במלואם, לא
המידע אבד; כל העדכונים הממתינים יופעלו מחדש מהיומן בפעם הבאה
הדמון מתחיל לפעול.

כדי להשבית את הכיבוי המהיר, השתמשו ב- -F אוֹפְּצִיָה.

-F תמיד יש לנקות את כל העדכונים לקבצי הנתונים של RRD כאשר הדמון כבוי,
ללא קשר להגדרת היומן.

-g רוץ בחזית. הדמון לא יפעל מזלג().

-b dir
הדמון ישתנה לספרייה ספציפית בעת ההפעלה. כל הקבצים המועברים אל
דמון, שצוינו על ידי קרוב משפחה נתיב, יתפרש כיחסי ל
ספרייה זו. אם לא נקבעה ברירת המחדל, "/ Tmp", ישמש.

+--------------------------+------------------------+
שורת פקודה! הקובץ עודכן!
+--------------------------+------------------------+
! foo.rrd ! /tmp/foo.rrd !
! foo/bar.rrd ! /tmp/foo/bar.rrd !
! /var/lib/rrd/foo.rrd ! /var/lib/rrd/foo.rrd !
+--------------------------+------------------------+
נתיבים שניתנו בשורת הפקודה והנתיבים בפועל
עודכן על ידי הדמון, בהנחה שזו ספריית הבסיס
"/ Tmp".

אזהרה: הנתיבים עד לספריית הבסיס וכוללים אותה חובה לא BE קישורים סמליים.
במילים אחרות, אם ספריית הבסיס מוגדרת כך:

-b /base/dir/אי שם

... אז אף לא אחד מהבאים צריכים להיות קישורים סמליים:

/בסיס
/base/dir
/base/dir/somewhere

-B אפשר רק כתיבה לתוך ספריית הבסיס שצוינה ב -b (וכל תת-הספריות).
זה עושה לא לזהות קישורים סמליים. נתיבים המכילים "../" ייחסמו גם הם.

-R אפשר יצירת תת-ספריות רקורסיביות בספריית הבסיס שצוינה ב -b (וכל
(ספריות משנה). ניתן להשתמש בו רק כאשר -B גם מוגדר.

-a גודל_הקצאה
הקצאת מצביעי ערך בקטעים של גודל_הקצאהזה עשוי לשפר את ניצול המעבד ב
מכונות עם מימושים איטיים של "realloc()", בתמורה לזיכרון מעט גבוה יותר
ניצול. ברירת המחדל היא 1. אין להגדיר זאת יותר מה- -w ערך חלקי
גודל הצעד הממוצע שלך ב-RRD.

-O מניעת החלפת קבצים קיימים מהפקודה CREATE, גם כאשר ניתנה לה הוראה
לעשות זאת. זה למען אבטחה נוספת.

-G -קבוצה
בעת הפעלה כ-daemon וקריאה מחשבון מורשה, איפוס הרשאות קבוצה
לאלה של קבוצהניתן לציין את הקבוצה כשם או כמזהה קבוצה. הדמון
ייסגר עם אבחון אם לא ניתן לעבור בהצלחה למצב שצוין
קבוצה.

-U -המשתמש
בעת הפעלה כ-daemon והפעלה מחשבון מורשה, יש לאפס את הרשאות המשתמש ל-
אלה של המשתמשניתן לציין את המשתמש כשם או כמזהה משתמש. הדמון יעשה זאת.
יציאה עם אבחון אם לא ניתן לעבור בהצלחה למשתמש שצוין.

מושפע RRDTOOL פקודות

הפקודות הבאות עשויות להיות מודעות ל- rrdcached באמצעות ארגומנט שורת הפקודה
--דימון או משתנה הסביבה RRDCACHED_ADDRESS:

· שפיכה

· אחזור

· סומק

· גרף

· גרף

· מידע

· ראשון

· אחרון

· עדכון אחרון

· עדכון

· ייצוא

· ליצור

השמיים עדכון הפקודה יכולה לשלוח ערכים לדמון במקום לכתוב אותם לדיסק
עצמו. כל שאר הפקודות יכולות לשלוח סומק פקודה (ראה להלן) לדמון לפני
גישה לקבצים, כך שהם עובדים עם נתונים עדכניים גם אם זמן הקצוב של המטמון ארוך.

ERROR דיווח

הדמון מדווח על שגיאות באחת משתי דרכים: במהלך ההפעלה, מודפסות הודעות שגיאה
ל-"STDERR". אחד השלבים בעת ההפעלה הוא מעבר לרקע וסגירה
"STDERR" - לאחר מכן כתיבה ישירה למשתמש אינה אפשרית עוד. ברגע שזה קרה
קרה, הדמון ישלח הודעות יומן לדמון רישום המערכת באמצעות syslog(3).
המתקן בו נעשה שימוש הוא "LOG_DAEMON".

איך IT עבודות

בעת קבלת עדכון, rrdcached לא כותב לדיסק אבל מחפש ערך עבור זה
קובץ בעץ הפנימי שלו. אם לא יימצא, נוצר ערך הכולל את השעה הנוכחית
(נקרא "ראשון" בתרשים למטה). הפעם הוא לֹא הזמן שצוין בפקודה
שורה אלא הזמן שמערכת ההפעלה מחשיבה כ"עכשיו". הערך והזמן של
ערך (הנקרא "זמן" בתרשים למטה) מצורפים לצומת העץ.

בעת הוספת ערך לצומת עץ, נבדק האם הגיע הזמן לכתוב את הערכים
לדיסק. ערכים נכתבים לדיסק אם "now() - First >= timeout", כאשר "timeout" הוא ה-
פסק זמן שצוין באמצעות -w אפשרות, ראה "אפשרויות". אם הערכים "ישנים מספיק" הם
יוכנסו לתור "תור העדכונים", כלומר הם יתווספו לרשימה המקושרת
מוצג להלן. מכיוון שצמתי העץ ואלמנטי הרשימה המקושרת הם אותם נתונים
מבנים בזיכרון, כל עדכון לקובץ שכבר הוכנס לתור ייכתב
גם עם הכתיבה הבאה לקובץ RRD.

"שרשור עדכון" נפרד מסיר כל הזמן את האלמנט הראשון בתור העדכונים מהתור ו...
כותב את כל הערכים שלו לקובץ המתאים. כל עוד תור העדכון אינו ריק
קבצים נכתבים בקצב הגבוה ביותר האפשרי.

מכיוון שזמן הקצוב של קבצים נבדק רק כאשר ערכים חדשים מתווספים לקובץ, "מת"
קבצים, כלומר קבצים שאינם מעודכנים עוד, לעולם לא ייכתבו לדיסק.
לכן, מדי פעם, נשלט על ידי -f אפשרות, כל העץ עובר הליכה ו
כל הערכים ה"ישנים" מוכנסים לתור. מכיוון שזה משפיע רק על קבצים "מתים" ועל הליכה על העץ
יקר יחסית, עליך להגדיר את "מרווח השטיפה" לערך גבוה למדי.
ברירת המחדל היא 3600 שניות (שעה אחת).

החיסרון של שמירת ערכים במטמון הוא שהם לא יופיעו בגרפים שנוצרו מה-
קבצי RRD. כדי לעקוף זאת, הדמון מספק את הפקודה "flush" כדי לרוקן קבצים ספציפיים
קבצים. משמעות הדבר היא שהקובץ מוכנס ב- ראש של תור העדכונים או הועבר לשם
אם הוא כבר בתור. פקודת ה"ריקון" תחזור רק לאחר שהקובץ יהפוך לממתין.
עדכונים נכתבו לדיסק.

+------+ +------+ +------+
! ראש ! שורש ! זנב !
+---+--+ +---+--+ +---+--+
! /\ !
! / \ !
! /\ /\ !
! /\/\ \ `------------------ ... --------, !
ו / `-------, ! ו
+---+----+---+ +------+-----+ +---+----+---+
! קובץ: foo ! ! קובץ: bar ! ! קובץ: qux !
! ראשון: 101 ! ! ראשון: 119 ! ! ראשון: 180 !
! הבא:&bar -+--->! הבא:&... -+---> ... --->! הבא:NULL !
| Prev:NULL !<---+-Prev:&foo !<--- ... ----+-Prev: &... !
+============+ +=============+ +=============+
! זמן: 100 ! ! זמן: 120 ! ! זמן: 180 !
! ערך: 10 ! ! ערך: 0.1 ! ! ערך: 2,2 !
+------------+ +------------+ +------------+
! זמן: 110 ! ! זמן: 130 ! ! זמן: 190 !
! ערך: 26 ! ! ערך: 0.1 ! ! ערך: 7,3 !
+------------+ +------------+ +------------+
: : : : : : :
+------------+ +------------+ +------------+
! זמן: 230 ! ! זמן: 250 ! ! זמן: 310 !
! ערך: 42 ! ! ערך: 0.2 ! ! ערך: 1,2 !
+------------+ +------------+ +------------+

התרשים לעיל מדגים:

· קבצים/ערכים מאוחסנים בעץ (מאוזן).

· צמתי העץ והערכים בתור העדכון הם אותו מבנה נתונים.

· ייתכן שהשעה המקומית ("First") והשעה המצוינת בעדכונים ("Time") יהיו שונים.

ערכים שפג תוקפם מוכנסים ב"זנב".

ערכים שהוסרו במפורש מוכנסים ב"כותרת".

· סלעי אמנות ASCII.

אבטחה שיקולים

אימות
אם התקנת rrdtool שלך נבנתה ללא libwrap, אין כל צורה של אימות.
עבור לקוחות שמתחברים לדמון rrdcache!

אם התקנת rrdtool שלך נבנתה באמצעות libwrap, תוכל להשתמש ב-hosts_access כדי
הגבל את גישת הלקוח לדמון rrdcache (rrdcached). למידע נוסף על אופן
השתמש ב-hosts_access כדי להגביל את הגישה לדמון rrdcache עליך לקרוא את
hosts_access(5) דפי מדריך.

עדיין מומלץ מאוד להתקין מסנן חבילות או מנגנון דומה כדי למנוע
חיבורים לא מורשים. אלא אם כן יש לך VLAN או VPN ייעודיים לכך, שימוש ברשת
שקעים זה כנראה רעיון גרוע!

הרשאה
יש הרשאה מינימלית לכל שקע.

הרשאה מתבצעת כרגע על בסיס כל שקע. משמעות הדבר היא שלכל שקע יש רשימה
של פקודות שהוא יקבל והוא יקבל. הוא יקבל רק את הפקודות האלה
רשום במפורש אך הוא (כרגע) יקבל פקודות אלו מכל מי שמגיע אל
שקע.

אם יש להשתמש בשקעי הרשת, יש צורך להגביל את המקובל
פקודות לאלו הדרושות ללקוחות חיצוניים. אם, לדוגמה, לקוחות חיצוניים רוצים
לצייר גרפים של הנתונים המאוחסנים במטמון, יש לאפשר להם להשתמש רק בפקודה "FLUSH".

הרשאה אינה פועלת כאשר rrcached מופעל ב-socket על ידי systemd.

הצף
אין הצפנה.

שוב, ייתכן שזה יתווסף בעתיד, אבל לעת עתה זו העבודה שלך לשמור על שלך
נתונים פרטיים פרטיים. התקן VPN או מנהרה מוצפנת אם הנתונים הסטטיסטיים שלך
סוֹדִי!

שְׁפִיוּת בדיקה
אין בדיקת שפיות.

הדמון יכתוב באופן עיוור לכל קובץ שהוא מקבל הוראות, אז באמת כדאי לך ליצור
משתמש נפרד רק עבור הדמון הזה. בנוסף, הוא לא מבצע בדיקות שפיות, כך שאם הוא מקבל
נאמר לך לכתוב ערכים לזמן רחוק בעתיד, הקבצים שלך יהיו דפוקים, טוב!

סיכום
· אבטחה היא תפקידו של המנהל.

· אנו ממליצים לאפשר גישת כתיבה דרך שקעי תחום של UNIX בלבד.

· הוזהרתם.

נוהל

הדמון מתקשר עם לקוחות באמצעות פרוטוקול ASCII מבוסס שורות שקל לתרגם.
קריא וקל להקלדה. זה מקל על סקריפטים ליישם את הפרוטוקול ו
אפשרי עבור משתמשים להשתמש בטלנט כדי להתחבר לדמון ולבדוק דברים "בידנית".

הפרוטוקול מבוסס על שורות, משמעות הדבר היא שכל רשומה מורכבת משורה אחת או יותר.
שורה מסתיימת בתו הזנת השורה 0x0A, הנכתב בדרך כלל כ-"\n". ב-
דוגמאות למטה, תו זה ייכתב כ-" " ("הזנת שורה").

לאחר יצירת החיבור, הלקוח צפוי לשלוח "פקודה". א
הפקודה מורכבת ממילת המפתח של הפקודה, אולי כמה ארגומנטים, ומקטע סיום
תו שורה חדשה. לרשימת פקודות, ראה "פקודות תקפות" להלן.

דוגמא:

ריקון /tmp/foo.rrd

הדמון עונה עם שורה המורכבת מקוד סטטוס והודעת סטטוס קצרה,
מופרדים על ידי תו רווח אחד או יותר. קוד סטטוס שלילי מסמן שגיאה, א
קוד סטטוס חיובי או אות אפס להצלחה. אם קוד הסטטוס גדול מאפס, זה
מציין את מספר השורות הבאות לאחר שורת הסטטוס.

דוגמאות:

0 הצלחה

2 שני קווים עוקבים אחריהם
זוהי השורה הראשונה
וזו השורה השנייה

תקף פקודות
הפקודות הבאות מובנות על ידי הדמון:

סומק שם הקובץ
גורם לדמון לשים שם הקובץ אל ה ראש של תור העדכונים (אולי העברתו
שם אם הצומת כבר בתור). התשובה תישלח לאחר לצומת יש
הוסרה מהתור.

פלאשול
גורם ל-daemon להתחיל לרוקן את כל הערכים הממתינים לדיסק. פעולה זו מחזירה
באופן מיידי, למרות שהכתיבה עשויה לקחת זמן רב.

ממתין ל שם הקובץ
מציג עדכונים "ממתינים" עבור קובץ, לפי הסדר. העדכונים המוצגים טרם בוצעו.
נכתב לקובץ RRD הבסיסי.

לְהָבִיא שם הקובץ CF [התחלה [סוף] [ds ...]]
קורא ל-"rrd_fetch" עם הארגומנטים שצוינו ומחזיר את התוצאה בצורת טקסט. אם
במידת הצורך, הקובץ נמחק תחילה לדיסק. פונקציית צד הלקוח "rrdc_fetch"
(מוצהר ב-"rrd_client.h") מנתח את הפלט ומתנהג בדיוק כמו "rrd_fetch_r" עבור
שילוב קל של שאילתות מרוחקות. ds מגדיר את העמודות ל-dump - אם אין כאלה.
בהינתן, כולם מוחזרים

אחזור שם הקובץ CF [התחלה [סוף] [ds ...]]
קורא ל-"rrd_fetch" עם הארגומנטים שצוינו ומחזיר את התוצאה בפורמט טקסט/בינארי
טופס כדי למנוע תקורה מיותרת של פירוק/ארגון. במידת הצורך, הקובץ נמחק
לדיסק תחילה. פונקציית צד הלקוח "rrdc_fetch" (מוצהרת ב-"rrd_client.h")
מנתח את הפלט ומתנהג בדיוק כמו "rrd_fetch_r" לשילוב קל של פונקציות מרוחקות
שאילתות. ds מגדיר את העמודות לdump - אם לא ניתנות עמודות, כולן מוחזרות

לִשְׁכּוֹחַ שם הקובץ
מסיר שם הקובץ מהמטמון. כל העדכונים הממתינים WILL BE LOST.

תוֹר
מציג את הקבצים הנמצאים בתור הפלט. מחזיר אפס שורות או יותר ב-
הפורמט הבא, שבו הוא מספר הערכים שיש לכתוב עבור ה-
:



עזרה [הפקודה]
מחזירה הודעת שימוש קצרה. אם לא ניתנת פקודה, או הפקודה is עזרה, רשימה של
פקודות הנתמכות על ידי הדמון מוחזרות. אחרת תיאור קצר, אולי
המכיל מצביע לדף מדריך, מוחזר. ברור שזה נועד עבור
שימוש אינטראקטיבי והפורמט שבו הפקודות וסיכומי השימוש מוצגים
הפונקציה המוחזרת אינה מוגדרת היטב.

STATS
מחזירה רשימה של מדדים בהם ניתן להשתמש כדי למדוד את ביצועי הדמונים.
בדוק את הסטטוס שלו. לתיאור הערכים המוחזרים, ראה "ערכי ביצועים"
לְהַלָן.

הפורמט שבו הערכים מוחזרים דומה לפורמטים רבים אחרים המבוססים על שורות
פרוטוקולים: כל ערך מודפס בשורה נפרדת, כאשר כל שורה מורכבת משם של
הערך, נקודתיים, רווח אחד או יותר והערך בפועל.

דוגמא:

9 סטטיסטיקות עוקבות
אורך תור: 0
עדכונים שהתקבלו: 30
שטיפות שהתקבלו: 2
עדכונים שנכתבו: 13
מערכי נתונים שנכתבו: 390
מספר צמתי עץ: 13
עומק עץ: 4
בייטס של יומן: 190
סיבוב יומן: 0

PING
פינג-פונג, זה מאוד שימושי בעת שימוש בבריכת חיבורים בין משתמש לקוח ו
מטמון.

דוגמא:

0 פונג

עדכון שם הקובץ ערכים [ערכים ...]
מוסיף נתונים נוספים לשם קובץ. זהו מה היא הפעולה שהדמון נועד לה, אז
תיאור נוסף של המנגנון אינו הכרחי. קראו את "איך זה עובד" לעיל לקבלת מידע נוסף.
הסבר מפורט.

שים לב ש-rrdcached מקבל רק חותמות זמן מוחלטות בערכי העדכון.
מחרוזות כמו "N:1:2:3" מומרות אוטומטית לזמן מוחלט על ידי לקוח RRD
ספרייה לפני שליחה אל rrdcached.

כתב שם הקובץ
פקודה זו נכתבת ליומן לאחר שקובץ נכתב בהצלחה אל
דיסק. הוא משמש במהלך שידור מחדש של יומן כדי לקבוע אילו עדכונים כבר בוצעו
יושם. זה רק תקף ביומן; הוא לא מתקבל מהפקודה האחרת
ערוצים.

ראשון שם הקובץ [רנום]
החזר את חותמת הזמן עבור ה-CDP הראשון ב-RRA שצוין. ברירת המחדל היא להשתמש ב-RRA
אפס אם לא צוין כלום.

אחרון שם הקובץ
החזר את חותמת הזמן של העדכון האחרון ל-RRD שצוין. שים לב שהמטמון הוא
לֹא יש לשטוף לפני הבדיקה, מכיוון שהלקוח צפוי לבקש זאת בנפרד אם
זה נדרש.

מידע שם הקובץ
החזר את מידע התצורה עבור ה-RRD שצוין. שים לב שהמטמון הוא לֹא
יש לשטוף לפני הבדיקה, מכיוון שהלקוח צפוי לבקש זאת בנפרד אם זה
נדרש.

המידע מוחזר, פריט אחד בכל שורה, בפורמט:

אֲנִי אֲנִי אֲנִי

ליצור שם הקובץ [-ס גודל הצעד] [-ב זמן התחלה] [-O] הגדרות DS ... הגדרות RRA ...
פעולה זו תיצור את קובץ ה-RRD בהתאם לפרמטרים שסופקו, בתנאי ש-
הפרמטרים תקפים, ו-(אם האפשרות -O ניתנת או אם rrdcached הופעל
עם הדגל -O) את הערך שצוין שם הקובץ לא קיים כבר.

אצווה
פקודה זו מתחילה טעינה בכמות גדולה של פקודות מרובות. זה מיועד עבור
התקנות עם קצבי עדכון גבוהים במיוחד, מכיוון שהן מאפשרות יותר מפקודה אחת
שיונפק לפי לקרוא() ו לִכתוֹב().

כל הפקודות מבוצעות בדיוק כפי שהיו מבוצעות אם היו ניתנות בנפרד, למעט
פלט למשתמש. הודעות המציינות הצלחה מושתקות, והודעות שגיאה
מתעכבים עד שהלקוח יסיים.

עיבוד הפקודה מסתיים כאשר הלקוח שולח נקודה (".") בשורה משלו.
לאחר שהלקוח סיים, השרת מגיב עם ספירת שגיאות ורשימה של
הודעות שגיאה (אם ישנן). כל הודעת שגיאה מציינת את מספר הפקודה שיש לבצע.
אשר היא מתאימה לה, והודעת השגיאה עצמה. פקודת המשתמש הראשונה לאחר מכן
אצווה היא פקודה מספר אחת.

לקוח: BATCH
שרת: 0 קדימה. סיים בנקודה '.' בשורה נפרדת.
לקוח: עדכון x.rrd 1223661439:1:2:3 <--- פקודה #1
לקוח: עדכון y.rrd 1223661440:3:4:5 <--- פקודה #2
לקוח: וכן הלאה...
לקוח: .
שרת: 2 שגיאות
שרת: הודעה אחת עבור פקודה 1
שרת: הודעה אחת עבור פקודה 12

תיכנע
התנתק מ-rrdcached.

ביצוע ערכים
הסופרים הבאים מוחזרים על ידי STATS פקודה:

אורך התור (לא חתום 64bit מספר שלם)
מספר הצמתים שנמצאים כעת בתור העדכונים.

עדכונים שהתקבלו (לא חתום 64bit מספר שלם)
מספר פקודות UPDATE שהתקבלו.

שטיפות שהתקבלו (לא חתום 64bit מספר שלם)
מספר פקודות FLUSH שהתקבלו.

עדכונים שנכתבו (לא חתום 64bit מספר שלם)
המספר הכולל של עדכונים, כלומר קריאות ל-"rrd_update_r", מאז שהדמון הופעל.

מערכי נתונים שנכתבו (לא חתום 64bit מספר שלם)
המספר הכולל של "מערכי נתונים" שנכתבו לדיסק מאז שהדמון הופעל. מערך נתונים
האם ערך אחד או יותר מועברים אל עדכון פקודה. לדוגמה: "1223661439:123:456"
הוא מערך נתונים אחד עם שני ערכים. המונח "מערך נתונים" משמש למניעת בלבול
האם סופרים ערכים בודדים או קבוצות של ערכים.

מספר צמתי עץ (לא חתום 64bit מספר שלם)
מספר הצמתים במטמון.

עומק עץ (לא חתום 64bit מספר שלם)
עומק העץ המשמש לחיפוש מקשים מהירים.

JournalBytes (לא חתום 64bit מספר שלם)
מספר הבייטים הכולל שנכתבו ליומן מאז ההפעלה.

סיבוב יומן (לא חתום 64bit מספר שלם)
מספר הפעמים שהיומן סוובב מאז ההפעלה.

איתותים

סיגינט וסיגטרם
הדמון נסגר כרגיל עם קבלת אחד מהאותות הללו. עדכונים ממתינים הם
מטופל בהתאם ל- -j ו -F אפשרויות.

SIGUSR1
הדמון נסגר לאחר ניקוי כל העדכונים לדיסק. זה עשוי לקחת זמן מה.

SIGUSR2
הדמון נסגר באופן מיידי, מבלי לרוקן עדכונים לדיסק. עדכונים ממתינים
יופעל מחדש מהיומן כאשר הדמון יופעל שוב. אזהרה: if
יומן (-י) is לא מאופשר, כל תלוי ועומד עדכונים WILL BE LOST.

השתמש ב-rrdcached באופן מקוון באמצעות שירותי onworks.net