xymongen - מקוון בענן

תָכְנִית:

שֵׁם

xymongen - מחולל דפי אינטרנט של Xymon

תַקצִיר

xymongen -?
xymongen - עזרה
xymongen --גִרְסָה
xymongen [אפשרויות] [ספריית פלט]
(עיין בסעיף אפשרויות לתיאור של אפשרויות שורת הפקודה הזמינות).

תיאור

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

הערה: הנתונים עבור דפי האינטרנט מאוחזרים מה- קסימונד(8) שימוש ב-damon ו-xymonen
הערכים של משתני הסביבה XYMSRV / XYMSERVERS כדי לקבוע את הרשת
כתובת שבה ניתן להגיע ל-xymond. אם יש לך יותר משרת אחד רשום
XYMSERVERS, ודא שהראשון הוא שרת ה-Xymon המקומי - זה זה
xymongen יבקש מידע.

אפשרויות

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

כללי אפשרויות

--עזרה או -?
ספק סיכום של אפשרויות שורת הפקודה הזמינות.

--גִרְסָה
מדפיס את מספר הגרסה של xymongen

--docurl=כתובת אתר
אפשרות זו הוצאה משימוש, השתמש בהגדרה HOSTDOCURL ב xymonserver.cfg(5)
במקום.

--doccgi=כתובת אתר
אפשרות זו הוצאה משימוש, השתמש בהגדרה HOSTDOCURL ב xymonserver.cfg(5)
במקום.

--doc-window
גורם לקישורים לתיעוד למארחים ולשירותים להיפתח בחלון חדש. ה
ברירת המחדל היא להציג תיעוד באותו חלון דפדפן כמו סטטוס Xymon.

--htmlextension=.EXTENSION
מגדיר את סיומת שם הקובץ המשמשת עבור דפי האינטרנט שנוצרו על ידי xymongen. על ידי
ברירת מחדל, נעשה שימוש בסיומת ".html". שים לב שאתה צריך לציין את ה"נקודה".

--report[=COLUMNNAME]
עם אפשרות זו, xymongen ישלח הודעת סטטוס עם פרטים של כמה
המארחים עובדו, כמה דפים נוצרו, כל שגיאה שהתרחשה
במהלך הריצה, וכמה סטטיסטיקות תזמון. שם העמודה המוגדר כברירת מחדל הוא "xymongen".

--htaccess[=htaccess-filename]
צור קובצי .htaccess בעת יצירת ספריות חדשות של דפי אינטרנט. התוכן של
קובצי ה-.htaccess נקבעים על ידי משתנה הסביבה XYMONHTACCESS (עבור
הספרייה ברמה העליונה עם xymon.html ו-nongreen.html); דרך
משתנה XYMONPAGEHTACCESS (עבור הספריות ברמת העמוד); ועל ידי ה
משתנה XYMONSUBPAGEHTACCESS עבור ספריות ברמת עמוד המשנה ורמת המשנה. ה
שם הקובץ של קבצי ה-.htaccess ברירת המחדל הוא ".htaccess" אם לא ניתן שם קובץ עם
אפשרות זו. המשתנה XYMONHTACCESS מועתק מילה במילה לרמה העליונה
קובץ .htaccess. המשתנה XYMONPAGEHTACCESS עשוי להכיל "%s" שבו השם
של הדף מוכנס. המשתנה XYMONSUBPAGEHTACCESS עשוי להכיל שני "%s"
מופעים: הראשון מוחלף בשם העמוד, השני ב-
שם משנה.

--max-eventcount=N
הגבל את יומן האירועים בדף "הכל לא ירוק" ל-N אירועים בלבד. ברירת מחדל: 100.

--max-eventtime=N
הגבל את יומן האירועים בדף "הכל לא ירוק" לאירועים שהתרחשו בתוך
N דקות האחרונות. ברירת מחדל: 240.

--No-Eventlog
השבת את יומן האירועים המוצג בדרך כלל בדף "הכל לא ירוק".

--max-account=N
הגבל את יומן האישורים בדף "הכל לא ירוק" ל-N אירועים בלבד. בְּרִירַת מֶחדָל:
25.

--max-acktime=N
הגבל את יומן האישורים בדף "הכל לא ירוק" לתקיפות שקרו
ב-N הדקות האחרונות. ברירת מחדל: 240.

--אין אישור
השבת את יומן האישורים המוצג בדרך כלל בדף "הכל לא ירוק".

--cricitcallog[=עמודת יומן קריטי]
זה יוצר יומן מבוסס טקסט של מה שמוצג בדף המצב critical.html,
ושולחת הודעת סטטוס עבור שרת ה-Xymon עצמו המשקפת את הצבע של
דף סטטוס קריטי. זה מאפשר לך לעקוב אחר מתי הופיעו בעיות ב-
דף סטטוס קריטי. קובץ היומן מאוחסן ב-$XYMONSERVERLOGS/criticalstatus.log

--loadhostsfromxymond
במקום לקרוא את הקובץ hosts.cfg, xymongen יטען את הקובץ hosts.cfg
תצורה מהדמון xymond. זה מבטל את הצורך בקריאת
hosts.cfg, ואם יש לך xymond ו-xymongen שפועלים על מארחים שונים, זה גם
מבטל את הצורך בהעתקת קובץ hosts.cfg בין מערכות. שימו לב שה-
האפשרות "dispinclude" ב-hosts.cfg מתעלמת כאשר אפשרות זו מופעלת.

עמוד מערך אפשרויות

אפשרויות אלו משפיעות על האופן שבו דפי האינטרנט שנוצרו על ידי xymongen מופיעים בדפדפן.

--עמודים-אחרונים
שים קישורי עמודים ודפי משנה אחרי מארחים.

--עמודים-ראשון
הצב קישורי עמודים ודפי משנה לפני מארחים (ברירת מחדל).

שתי האפשרויות הללו מחליטות אם לדף עם קישורים לדפי משנה ולמארחים יש את
תחילה מארחים או דפי המשנה.

--subpagecolumns=N
קובע את מספר העמודות המשמשות לקישורים לדפים ולדפי משנה. ברירת המחדל
הוא N=1.

--maxrows=N
כותרות עמודות בדף מוצגות כברירת מחדל רק בתחילת העמוד,
עמוד משנה או קבוצת מארחים. אפשרות זו גורמת לחזור על כותרות העמודות
כל N מארחים המוצגים.

--להראות קבוצות ריקות

--ללא הופעות ריקות
כאשר נוצרות קבוצות מארחים, הצג את שמות הטבלה והמארחים גם אם קיימים
אין מבחנים עבור אף אחד מהמארחים המדוברים. השתמש ב--no-showemptygroups כדי
להתחבא. (ברירת מחדל: כן)

--קישורי כותרת דף
בדרך כלל, רק ה"נקודות" הצבעוניות לצד דף או דף משנה פועלות כקישורים ל-
הדף עצמו. עם אפשרות זו, כותרת העמוד תקשר גם לדף.

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

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

--recentgifs[=MINUTES]
השתמש בתמונות בשם COLOR-recent.gif עבור בדיקות, שבהן סטטוס הבדיקה השתנה
ב-24 השעות האחרונות. יש להתקין קבצי GIF אלה ב-
ספריית $XYMONHOME/www/gifs/. כברירת מחדל, הסף מוגדר ל-24 שעות - אם
אתה רוצה את זה אחרת, אתה יכול לציין גם את מגבלת הזמן. לְמָשָׁל
"--recentgifs=3h" יציג את קובצי ה-GIF האחרונים למשך 3 שעות בלבד לאחר שינוי הסטטוס.

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

--dialupskin=URL
אם אתה רוצה להראות חזותית שבדיקה היא מבחן חיוג, אתה יכול להשתמש במחליף
סט סמלים עבור הירוק/אדום/צהוב>/וכו'. תמונות על ידי ציון אפשרות זו. ה
פרמטר כתובת האתר שצוין כאן עוקף את ההגדרה הרגילה מ-XYMONSKIN
משתנה סביבה, אבל רק עבור מבחני חיוג.

--reverseskin=URL
זהה ל-"--dialupskin", אבל עבור בדיקות הפוכות (בדיקות עם '!' מלפנים).

--tooltips=[always, never, main]
קובע אילו דפים משתמשים בטיפים כדי להציג את התיאור של המארח (מתוך
ערך תגובה ב- hosts.cfg(5) קוֹבֶץ). אם מוגדר ל תמיד, עצות כלים משמשות בכל
דפים. אם מוגדר ל לעולם לא, עצות כלים לעולם אינן בשימוש. אם מוגדר ל ראשי, נעשה שימוש בטיפים של כלים
בעמודים הראשיים, אך לא בעמודים "הכל לא ירוק" או "מערכות קריטיות".

COLUMN בחירת אפשרויות

אפשרויות אלו משפיעות על אילו עמודות (בדיקות) נכללות בדפי האינטרנט שנוצרו על ידי
xymongen.

--ignorecolumns=test[,test]
העמודות הנתונות יתעלמו לחלוטין על ידי xymongen בעת יצירת דפי אינטרנט.
יכול לשמש להפקת דוחות שבהם אתה מבטל כמה מהבדיקות הרועשות יותר,
כמו "msgs".

--קריטי-אדומים-בלבד
רק עמודות סטטוס אדומות ייכללו בדף קריטי. כברירת מחדל, ה
עמוד קריטי יכיל מארחים עם סטטוס אדום, צהוב וברור.

--nongreen-colors=COLOR[,COLOR]
מגדיר אילו צבעים גורמים לבדיקה להופיע בדף המצב "הכל לא ירוק".
COLOR הוא אדום, צהוב או סגול. ברירת המחדל היא לכלול את שלושתם.

--nongreen-ignorecolumns=test[,test]
זהה לעמודות --ignore, אך חל על מארחים בדף "הכל לא ירוק" בלבד.

--לא ירוק-מתעלם סגולים
הוצא משימוש, השתמש במקום זאת ב-"--nongreen-colors".

--לא-גרין-ignoredialups
התעלם מכל מארחי החיוג בדף "הכל לא ירוק", כולל יומן האירועים.

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

--לא-לא ירוק
אל תיצור את הדף "הכל לא ירוק".

--includecolumns=test[,test]
כלול תמיד עמודות אלו בדף "הכל לא ירוק" יכלול עמודות מסוימות
בדף nongreen.html, ללא קשר לצבע שלו. בדרך כלל, nongreen.html מוריד את a
עמודת הבדיקה, אם כל הבדיקות ירוקות. זה יכול לשמש למשל כדי שיהיה תמיד קישור אליו
עמודת המגמות (עם גרפי RRD) מהדף nongreen.html שלך.

--eventignore=test[,test]
התעלם מבדיקות אלו בתצוגת יומן האירועים "הכל לא ירוק".

סטָטוּס רְבִיָה אפשרויות

אפשרויות אלו מדכאות את ההפצה הרגילה של סטטוס כלפי מעלה בהיררכיית הדפים.
כך, אתה יכול לערוך מבחן בסטטוס צהוב או אדום, אך עדיין יש לירוק את כל העמוד.
זה שימושי עבור בדיקות שאינן צריכות לגרום לאזעקה, אך שבהן אתה עדיין רוצה לדעת את
מצב בפועל. אפשרויות אלה קובעות ברירות מחדל גלובליות עבור כל המארחים; אתה יכול להשתמש ב-NOPROPRED
ותגיות NOPROPYELLOW ב- hosts.cfg(5) קובץ כדי להחיל מגבלות דומות על מארח
בסיס.

--nopropyellow=test[,test] או --noprop=test[,test]
השבת את הפצת המצב כלפי מעלה כאשר הוא צהוב. האפשרות "--noprop" הוצאה משימוש
ואין להשתמש בו.

--noproppurple=test[,test]
השבת את הפצת המצב כלפי מעלה כאשר הוא סגול.

--nopropred=test[,test]
השבת את הפצת המצב כלפי מעלה כאשר הוא אדום או צהוב.

--nopropack=test[,test]
השבת את הפצת הסטטוס כלפי מעלה כאשר הסטטוס אושר. אם אתה רוצה
כדי לבטל את הפצת כל הבדיקות המקושרות, השתמש ב---nopropack=*.

סגול סטָטוּס אפשרויות

סטטוסים סגולים מתרחשים כאשר הדיווח על מצב בדיקה מפסיק. סטטוס בדיקה תקף עבור א
פרק זמן מוגבל - בדרך כלל 30 דקות - ולאחר זמן זה, הבדיקה הופכת
סָגוֹל.

--purplelog=FILENAME
צור קובץ יומן של כל הודעות המצב הסגול.

להחליף ערכת דפים אפשרויות

--pageset=PAGESETNAME
בנו דפי אינטרנט עבור ערכת דפים חלופית מברירת המחדל. עיין בסעיף הגדרות דפים
לְהַלָן.

--template=template
השתמש בתבנית חלופית לקובצי כותרות עליונות ותחתונות. בדרך כלל משמש יחד את
האפשרות "--pageset"; עיין בסעיף הגדרות דפים למטה.

להחליף תפוקה פורמטים

--wml[=test1,test2,...]
אפשרות זו גורמת ל-xymongen ליצור קבוצה של קבצי "כרטיס" WML שיכולים להיות
גישה אליו באמצעות מכשיר WAP (טלפון סלולרי, מחשב כף יד וכו') הקבצים שנוצרו מכילים את
מארחים בעלי סטטוס אדום או צהוב בבדיקות שצוינו. אפשרות זו יכולה להגדיר
בדיקות ברירת המחדל שיש לכלול - ניתן לעקוף או לתקן את ברירות המחדל באמצעות
תגיות "WML:" או "NK:" ב- hosts.cfg(5) קוֹבֶץ. אם לא צוינו בדיקות, כל הבדיקות
יהיה כלול.

--nstab=שם קובץ
צור קובץ HTML המתאים לערך בסרגל הצד של Netscape 6/Mozilla. למעשה
לאפשר למשתמשים שלך להשיג ערך כזה בסרגל הצד, אתה צריך את קוד ה-Javascript הזה
דף אינטרנט (למשל אתה יכול לכלול אותו בקובץ $XYMONHOME/web/stdnormal_header):


<!--
function addNetscapePanel() {
if ((typeof window.sidebar == "אובייקט") &&
(typeof window.sidebar.addPanel == "פונקציה"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
אחר
alert("סרגל צד רק עבור Mozilla או Netscape 6+");
}
// ->


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

הוסף לסרגל הצד

או אם אתה מעדיף להשתמש בכפתור "הוסף כרטיסייה" הסטנדרטי של Netscape, תעשה זאת
עם


<IMG SRC="/gifs/add-button.gif" HEIGHT=45 WIDTH=100
ALT="[הוסף סרגל צד]" STYLE="border:0">


ה-"add-button.gif" זמין מ-Netscape בכתובת
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

אם FILENAME לא מתחיל בקו נטוי, קובץ סרגל הצד של Netscape ימוקם ב-
ספריית $XYMONHOME/www/.

--nslimit=COLOR
הצבע המינימלי לכלול בסרגל הצד של Netscape - ברירת המחדל היא "אדום", כלומר
רק התראות קריטיות כלולות. אם אתה רוצה לכלול גם אזהרות, השתמש
"--nslimit=צהוב".

--rss צור זרם אספקת תוכן RSS/RDF של התראות Xymon שלך. פורמט פלט זה
ניתן להטמיע באופן דינמי בדפי אינטרנט אחרים, בדומה לעדכוני החדשות החיים לעתים קרובות
נראה באתרי אינטרנט. יווצרו שני קבצי RSS, אחד משקף את ה-"כל לא-
ירוק", הדף השני משקף את הדף "קריטי". הם יהיו ב-
קבצי "nongreen.rss" ו-"critical.rss", בהתאמה. בנוסף, קובץ RSS
יווצר עבור כל עמוד ו/או עמוד משנה המפרט את המארחים הנוכחים בו
עמוד או עמוד משנה.
הפרמטר FILENAME שהותר בעבר באפשרות --rss מיושן כעת.
למידע נוסף על הזנות תוכן RSS/RDF, ראה
http://www.syndic8.com/.

--rssextension=.EXTENSION
מגדיר את סיומת שם הקובץ המשמשת עבור קובצי ה-RSS שנוצרו על ידי xymongen. על ידי
ברירת מחדל, נעשה שימוש בסיומת ".rss". שים לב שאתה צריך לציין את ה"נקודה".

--rssversion={0.91|0.92|1.0|2.0}
פורמט הפלט הרצוי של הזנת RSS/RDF. נראה שגרסה 0.91 היא הכי הרבה
פורמט נפוץ, והוא ברירת המחדל אם אפשרות זו מושמטת.

--rsslimit=COLOR
הצבע המינימלי לכלול בהזנת ה-RSS - ברירת המחדל היא "אדום", כלומר בלבד
התראות קריטיות כלולות. אם אתה רוצה לכלול גם אזהרות, השתמש
"--rsslimit=צהוב".

אפשרויות מְשׁוּמָשׁ BY CGI קצוות חזית

--reportopts=START:END:DYNAMIC:STYLE
הפעל xymongen במצב יצירת דוחות. זה משמש בדרך כלל על ידי
report.cgi(1) סקריפט CGI, אך ניתן להשתמש בו ישירות בעת יצירה מראש
דיווחים. הפרמטר START הוא שעת ההתחלה של הדוח ב-Unix time_t
פורמט (שניות מאז 1 בינואר 1970 00:00 UTC); END הוא שעת הסיום של הדוח;
DYNAMIC הוא 0 עבור דוח בנוי מראש ו-1 עבור דוח דינמי (מקוון); STYLE הוא
"crit" לכלול רק אירועים קריטיים (אדומים), "nongr" כדי לכלול את כל האירועים שאינם ירוקים
אירועים, ו"הכל" כדי לכלול את כל האירועים.

--csv=FILENAME
בשימוש יחד עם --reportopts, זה גורם ל-xymongen ליצור זמינות
דוח בצורה של קובץ ערכים מופרדים בפסיקים (CSV). פורמט זה נפוץ
משמש לייבוא ​​לגיליונות אלקטרוניים לעיבוד נוסף.
קובץ ה-CSV כולל חותמות זמן של Unix. כדי להציג את אלה כזמנים קריא אנושיים ב
אקסל, הנוסחה =C2/86400+DATEVALUE(1-jan-1970) (אם יש לך את חותמת הזמן של יוניקס
בתא C2) ניתן להשתמש. יש לעצב את תא התוצאה כתאריך/שעה
שדה. שים לב שחותמות הזמן הן ב-UTC, כך שייתכן שתצטרך לטפל גם מקומית
בעיות אזור זמן ו-DST בעצמך.

--csvdelim=DELIMITER
כברירת מחדל, נעשה שימוש בפסיק כדי להפריד בין שדות בפלט CSV. חלקם לא באנגלית
גיליונות אלקטרוניים משתמשים במפריד שונה, בדרך כלל נקודה-פסיק. כדי ליצור CSV
קובץ עם המפריד המתאים, תוכל להשתמש באפשרות זו כדי להגדיר את התו המשמש
בתור תוחם. למשל "--csvdelim=;" - שים לב שבדרך כלל זה צריך להיות כפול
מרכאות, כדי למנוע ממעטפת יוניקס לפרש את תו המפריד כ-a
מפריד שורת פקודה.

--snapshot=זמן
צור תמונת מצב של דפי Xymon, כפי שהופיעו ב-TIME. TIME ניתן כ
שניות מאז 1 בינואר 1970 00:00 UTC. משמש בדרך כלל דרך ה snapshot.cgi(1) CGI
תַסרִיט.

פיתרון אפשרויות

--לנפות
גורם ל-xymongen לזרוק כמויות גדולות של פלט ניפוי באגים ל-stdout, אם כן
הידור כשה-DDEBUG מופעל. כאשר מדווחים על בעיה עם xymongen, בבקשה
נסה לשחזר את הבעיה ולספק את הפלט מהפעלת xymongen עם זה
אוֹפְּצִיָה.

--תִזמוּן
זרוק מידע על הזמן המושקע בחלקים שונים של xymongen ל-stdout. זֶה
שימושי כדי לראות איזה חלק מהעיבוד אחראי לזמן הריצה של
xymongen.
הערה: מידע זה מסופק גם בפלט שנשלח לתצוגה של Xymon
בעת שימוש באפשרות "--rapport".

בנייה להחליף ערכות דפים

עם גרסה 1.4 של xymongen מגיעה האפשרות ליצור מספר קבוצות של דפים
אותם נתונים.
נניח שיש לך שתי קבוצות של אנשים שמסתכלות על דפי האינטרנט של Xymon. קבוצה א' רוצה
יש לקבץ את המארחים לפי הלקוח, שהם שייכים אליהם. כך הגדרת את Xymon -
ערכת הדפים המוגדרת כברירת מחדל. כעת קבוצה ב' רוצה לקבץ את המארחים לפי מערכת הפעלה -
תן לנו לקרוא לזה סט "OS". אז תוסיף את פריסת העמוד ל-hosts.cfg כך:

ospage win Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
osgroup NT4 שרתי קבצים
שרתי דואר של osgroup NT4
ossubpage win-xp MS Windows XP
ospage unix יוניקס
ossubpage unix-sun Solaris
ossubpage unix-linux לינוקס

זה מגדיר קבוצה של דפים עם דף אחד ברמה העליונה (דף xymon.html), שני דפים
מקושרים מ-xymon.html (win.html ו-unix.html), ומהדף win.html, למשל, יש
דפי משנה win-nt4.html ו-win-xp.html
התחביר זהה להנחיות הרגילות "עמוד" ו"תת-עמוד" ב-hosts.cfg, אבל
הקידומת של ההנחיה היא שם ערכת הדפים. אל תכניס מארחים בין הדף
והנחיות דף משנה - פשוט הוסף את כל ההנחיות בחלק העליון של הקובץ hosts.cfg.
אז איך מוסיפים מארחים לדפים? פשוט - פשוט שים תג "OS:win-xp" על המארח
קו הגדרה. "מערכת ההפעלה" חייבת להיות זהה לקידומת המשמשת עבור שמות ערכות הדפים, אבל ב
אותיות רישיות. ה-"win-xp" חייב להתאים לאחד מהעמודים או מדפי המשנה שהוגדרו בתוכו
ערכת דפים. לְמָשָׁל

207.46.249.190 www.microsoft.com # OS:win-xp http://www.microsoft.com/
64.124.140.181 www.sun.com # OS:unix-sun http://www.sun.com/

אם אתה רוצה שהמארח יופיע בתוך קבוצה שהוגדרה בדף זה, עליך לזהות את
קבץ לפי מספר, החל מ-1. למשל כדי להכניס מארח לקבוצת "שרתי דואר של NT4".
בדוגמה למעלה, השתמש ב-"OS:win-nt4,2" (הקבוצה השנייה בדף "win-nt4").
אם אתה רוצה שהמארח יופיע בעמוד הראשי במקום בדף משנה, השתמש ב-"OS:*" .

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

#!/ Bin / sh

XYMONWEB="/xymon/os" $XYMONHOME/bin/xymongen \
--pageset=os --template=os \
$XYMONHOME/www/os/

שמור את זה ב-$XYMONHOME/ext/os-display.sh, והגדר את זה לפעול בתור הרחבה של Xymon;
המשמעות היא הוספת קטע נוסף ל-tasks.cfg כדי להפעיל אותו.

זה מייצר את הדפים. ישנן כמה אפשרויות חשובות המשמשות כאן:
* משתנה הסביבה XYMONWEB="/xymon/os" וה-
האפשרות "$XYMONHOME/www/os/" פועלת יחד, וממקמת את
קובצי HTML חדשים של ערכת דפים בספריית משנה לא מהרגיל
Xymon webroot. אם אתה בדרך כלל ניגש לדפי Xymon כ
"http://xymon.acme.com/xymon/", לאחר מכן תיגש
ערכת הדפים החדשה בתור "http://xymon.acme.com/xymon/os/"
הערה: הספרייה הניתנת כ-XYMONWEB חייבת להכיל סמל
קישור לספרייה $XYMONHOME/www/html/, או קישורים אל
הודעות סטטוס בודדות לא יעבדו. קישורים דומים
צריך להיעשות עבור הגיפים/, עזרה/ והערות/
ספריות.
* "--pageset=os" אומר ל-xymongen לבנות את דפי האינטרנט
באמצעות פריסת "OS", במקום פריסת ברירת המחדל.
* "--template=os" אומר ל-xymongen להשתמש בסט אחר של
תבניות כותרות עליונות ותחתונות. בדרך כלל xymongen משתמש ב-
תבנית סטנדרטית ב-$XYMONHOME/web/stdnormal_header ו
.../stdnormal_footer - עם אפשרות זו, הוא ישתמש במקום זאת
הקבצים "os_header" ו-"os_footer" מה-
ספריית $XYMONHOME/web/. זה מאפשר לך להתאים אישית
כותרות עליונות ותחתונות עבור כל ערכת דפים. אם אתה רק רוצה
כדי להשתמש בתבנית הרגילה, אתה יכול להשמיט את האפשרות הזו.

משתמש XYMONGEN עבור דיווחים

דיווח ה-xymonen מיושם באמצעות תחליפים נפתחים עבור ה-Xymon הסטנדרטי
סקריפטים לדיווח (report.sh ו-reportlog.sh) המותקנים בשרתי האינטרנט שלך cgi-bin
במדריך.

שני תסריטי מעטפת אלו הוחלפו בשני כתבי מעטפת קטנים מאוד, שפשוט
הגדר את משתני הסביבה של Xymon, והפעל את report.cgi(1) or reportlog.cgi(1)
סקריפטים ב-$XYMONHOME/bin/

אתה יכול להשתמש באפשרויות שורת הפקודה xymongen בעת הפקת דוחות, למשל כדי לא לכלול חלק
סוגי בדיקות (למשל "--ignorecolumns=msgs") מהדוחות, כדי לציין את השם של
עמודות מגמות ומידע שלא צריכות להיות בדוח, או כדי לעצב את הדוח
אחרת (למשל "--subpagecolumns=2"). אם ברצונך להשתמש באפשרויות מסוימות כאשר א
הדוח מופק מממשק האינטרנט, הכנס את האפשרויות האלה לתוך שלך
קובץ $XYMONHOME/etc/xymonserver.cfg במשתנה הסביבה XYMONGENREPOPTS.

קבצי הדוחות שנוצרו על ידי xymongen מאוחסנים בספריות בודדות (אחת לכל
דוח) מתחת לספריית $XYMONHOME/www/rep/. יש לנקות אותם באופן אוטומטי
- ככל שנוצרים דוחות חדשים, הישנים יוסרו.

לאחר ההתקנה, נסה להפיק דוח. סביר להניח שתראה שהקישורים ב-
הפינה השמאלית העליונה (to ack.html, nongreen.html וכו') כבר לא עובדת. כדי לתקן את אלה, שנה
הקובץ $XYMONHOME/web/repnormal_header שלך כך שהקישורים האלה אינם מתייחסים ל"&XYMONWEB" אלא
לקידומת כתובת האתר הרגילה עבור דפי ה-Xymon שלך.

צד"ל דיווח

דיווח xymongen מאפשר ליצור SLA אמיתי (הסכם רמת שירות)
דוחות, גם לתקופות שירות שאינן 24x7. זה מתאפשר על ידי הגדרת א
תג "REPORTTIME:timespec" עבור המארחים להגדרת תקופת השירות, ובאופן אופציונלי א
תג "WARNPCT:level" להגדרת הזמינות המוסכמת.

הערה: ראה hosts.cfg(5) עבור התחביר המדויק של אפשרויות אלה.

"REPORTTIME:timespec" מציין את השעה ביום שבה השירות צפוי להיות פתוח ו
רץ. כברירת מחדל זה 24 שעות ביממה, בכל ימות השבוע. אם ה-SLA שלך מכסה רק
שני-שישי 7:8 - 0700:2000, אתה מגדיר זאת כ"REPORTTIME=W:XNUMX:XNUMX", ואת מחולל הדוחות
לאחר מכן יחשב גם את הזמינות הרגילה של 24x7 אבל גם "זמינות SLA" אשר
לוקח בחשבון רק את סטטוס המארח במהלך תקופת ה-SLA.

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

דוגמה: למארח יש "DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200" מכיוון שהוא מופעל מחדש
כל יום בין השעות 7:7.30-6:10, אך השירות חייב להיות זמין מ-XNUMX:XNUMX עד XNUMX:XNUMX. ל
ביום הדיווח, הוא ירד מ-7:10 בבוקר ל-7:15 בבוקר (האתחול המתוכנן), אבל גם
מ-9:53 עד 10:15. אז האירועים להיום הם:

0700: ירוק למשך 10 דקות (600 שניות)
0710: כחול למשך 5 דקות (300 שניות)
0715: ירוק למשך 14 שעות 38 דקות (52680 שניות)
2153: אדום למשך 22 דקות (1320 שניות)
2215: ירוק

השירות זמין עבור 600+52680 = 53280 שניות. זה למטה (אדום) למשך 420 שניות
(השעה מ-21:53 עד 22:00 שבה מסתיימת תקופת ה-SLA). הזמן הכולל הכלול ב-
הדוח הוא 15 שעות (7 בבוקר - 10:5) מלבד 53700 הדקות הכחול = XNUMX שניות. אז ה-SLA
הזמינות היא 53280/53700 = 99,22%

התג "WARNPCT:level" נתמך בקובץ hosts.cfg, כדי להגדיר את הזמינות
סף על בסיס מארח מארח. סף זה קובע אם בדיקה מדווחת כ
ירוק, צהוב או אדום בדוחות. ניתן להגדיר ערך ברירת מחדל עבור כל המארחים עם ה-via
משתנה הסביבה XYMONREPWARN, אך נדחק על ידי תג זה. הרמה ניתנת כ
אחוז, למשל "WARNPCT:98.5"

נוצר מראש דיווחים

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

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

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

התחביר הוא:

xymongen --reportopts=starttime:endtime:nodynamic:style

"זמן התחלה" ו"זמן סיום" מצוינים כערכי Unix time_t, כלומר שניות מאז ה-1 בינואר
1970 00:00 GMT. למרבה המזל, ניתן לחשב זאת בקלות עם כלי השירות לתאריך של GNU אם אתה
השתמש באפשרות הפלט "+%s". אם אין לך את תוכנית השירות לתאריך של GNU, או שתרים את זה
מתוך www.gnu.org; או שאתה יכול להשתמש בכלי השירות "etime" לאותה מטרה, כלומר
זמין מהארכיון בכתובת www.deadcat.net.

"nodynamic" הוא 0 (עבור דפים דינמיים, ברירת המחדל) או 1 (ללא דינמי, כלומר מראש
שנוצרו, דפים).

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

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

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

אז קריאה טיפוסית של xymongen עבור דוח סטטי תהיה:

START=`date +%s --date="22 יוני 2003 00:00:00"`
END=`date +%s --date="22 יוני 2003 23:59:59"`
XYMONWEB=/reports/bigbrother/daily/2003/06/22 \
XYMONHELPSKIN=/xymon/help \
XYMONNOTESSKIN=/xymon/notes \
xymongen --reportopts=$START:$END:1:crit \
--subpagecolumns=2 \
/var/www/docroot/reports/xymon/daily/2003/06/22

ההגדרה "XYMONWEB" פירושה שהדוח יהיה זמין עם כתובת URL של
"http://www.server.com/reports/xymon/daily/2003/06/22"הדוח מכיל פנימי
קישורים המשתמשים בכתובת האתר הזו, כך שלא ניתן להעביר אותה בקלות למיקום אחר.

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

שים לב כיצד נתונים(1) כלי השירות משמש לחישוב פרמטרי ההתחלה והסיום.

הסביבה וריאציות

BOARDFILTER
מסנן משמש לבחירת המארחים/בדיקות הכלולים בדפי האינטרנט, על ידי סינון
הנתונים שאוחזרו מ-xymond vi הפקודה xymondboard. לִרְאוֹת xymon(1) לפרטים
על תחביר המסנן. כברירת מחדל, לא נעשה סינון.

השתמש ב-xymongen באינטרנט באמצעות שירותי onworks.net