xymon - מקוון בענן

תָכְנִית:

שֵׁם

xymon - תוכנת תקשורת לקוח Xymon

תַקצִיר

xymon [אפשרויות] מקבל הודעה

תיאור

xymon(1) היא תוכנית הלקוח המשמשת לתקשורת עם שרת Xymon. זה לעתים קרובות
בשימוש על ידי מערכות לקוח Xymon לשליחת הודעות סטטוס והתראות ביפר בבדיקות מקומיות.

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

אפשרויות ו פרמטרים

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

--פרוקסי=http://PROXYSERVER:PROXYPORT/
בעת שליחת הודעות המצב באמצעות HTTP, השתמש בשרת זה כפרוקסי HTTP במקום זאת
של התחברות ישירות לשרת Xymon.

--פסק זמן=N
מציין את הזמן הקצוב לחיבור לשרת Xymon, בשניות. ברירת המחדל
הוא 5 שניות.

--תְגוּבָה
כלי השירות של xymon יודע בדרך כלל מתי לצפות לתגובה מהשרת, אז זה
אפשרות לא נדרשת. עם זאת, זה יגרום לכל תגובה מהשרת להיות
מוצג.

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

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

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

אל האני מקבל הפרמטר עשוי להיות כתובת אתר עבור שרת אינטרנט שיש לו את ה-xymoncgimsg.cgi
או סקריפט דומה מותקן. זה מעביר את הודעות Xymon לשרת Xymon
באמצעות פרוטוקול HTTP סטנדרטי. ה xymoncgimsg.cgi(8) כלי CGI (כלול ב-Xymon)
חייב להיות מותקן בשרת האינטרנט כדי שהעברת ה-HTTP תפעל.

הודעה
אל האני הודעה פרמטר הוא ההודעה שיש לשלוח לשרת Xymon.
הודעות חייבות להיות מוקפות במרכאות, אך על ידי כך הן יכולות להשתרע על פני מספר שורות.
הגודל המרבי של הודעה מוגדר על ידי האורך המרבי המותר שלך
שורת הפקודה של shell, והיא בדרך כלל 8-32 KB.

אם אתה צריך לשלוח הודעות סטטוס ארוכות יותר, אתה יכול לציין "@" בתור ההודעה:
לאחר מכן, xymon יקרא את הודעת הסטטוס מהסטדין שלו.

XYMON הודעה תחביר

סעיף זה מפרט את ההודעות הנפוצות ביותר בפרוטוקול Xymon.

כל הודעה חייבת להתחיל באחת מפקודות Xymon. היכן שצוין HOSTNAME, זה
חייבות לשנות נקודות בשם המארח לפסיקים אם הגדרת Xymon FQDN מופעלת
(שזו ברירת המחדל). אז המארח "www.foo.com", למשל, ידווח בתור
"www,foo,com".

סטטוס[+LIFETIME][/group:GROUP] HOSTNAME.TESTNAME COLOR
זה שולח הודעת סטטוס עבור בדיקה בודדת (עמודה) על מארח יחיד.
TESTNAME הוא שם העמודה שבה יופיע בדיקה זו; כל שם תקף
אלא ששימוש בנקודות בשם הבדיקה לא יעבוד. COLOR חייב להיות אחד מה
צבעים תקפים: "ירוק", "צהוב", "אדום" או "צלול". הצבעים "כחול" ו"סגול"
- למרות שצבעים תקפים - אין לשלוח בהודעת סטטוס, שכן אלו
מטופל במיוחד על ידי שרת Xymon. כמקרה מיוחד (לתמיכה במבוגרים
לקוחות), "לקוח" יכול לשמש כשם הצבע. זה גורם לסטטוס
הודעה שתטופל על ידי Xymon כהודעת נתונים של "לקוח", וה-TESTNAME
הפרמטר משמש כ"מזהה אספן".
ה"טקסט הנוסף" כולל בדרך כלל חותמת זמן מקומית וסיכום של המבחן
תוצאה בשורה הראשונה. כל השורות העוקבות אחר השורות הראשונות הן בצורה חופשית ויכולות
לכלול כל מידע שעשוי להיות שימושי לאבחון הבעיה המדווחת.
ה-LIFETIME מגדיר כמה זמן סטטוס זה תקף לאחר קבלתו על ידי
שרת Xymon. ברירת המחדל היא 30 דקות, אבל אתה יכול להגדיר כל תקופה שתרצה. לְמָשָׁל
עבור בדיקה מותאמת אישית שפועלת פעם בשעה, תרצה להגדיר זאת ל-60 לפחות
דקות - אחרת הסטטוס יעבור לסגול לאחר 30 דקות. זה רעיון טוב
כדי להגדיר את LIFETIME לקצת יותר מהמרווח בין הבדיקות שלך, כדי
לאפשר שינויים בזמן שלוקח לבדיקה שלך להשלים. ה-LIFETIME כבר בפנים
דקות, אלא אם תוסיף "h" (שעות), "d" (ימים) או "w" (שבועות) מיד לאחר מכן
המספר, למשל "סטטוס+5h" עבור סטטוס שתקף ל-5 שעות.
האפשרות GROUP משמשת להפניית התראות מהסטטוס לקבוצה ספציפית. זה
משמש כרגע לסטטוס שנוצר מנתוני לקוחות Xymon, למשל להנחות
התראות על סטטוס "פרוקס" לאנשים שונים, תלוי בדיוק באיזה תהליך
כבוי.

הודע ל-HOSTNAME.TESTNAME
זה מפעיל הודעת מידע שתישלח למי שמקבל התראות
שילוב זה של HOSTNAME+TESTNAME, בהתאם לכללים המוגדרים ב alerts.cfg(5)
זה משמש את enadis.cgi(1) כלי להודיע ​​לאנשים על השבתת מארחים
או מופעל, אך יכול לשמש גם כדרך כללית להודיע ​​למנהלי שרתים.

נתונים HOSTNAME.DATANAME
הודעת "נתונים" מאפשרת לכלים לשלוח נתונים על מארח, מבלי שזה יופיע בתור
עמודה בדפי האינטרנט של Xymon. זה משמש, למשל, לדיווח סטטיסטיקה
על מארח, למשל נתוני vmstat, שאינו מייצג כשלעצמו משהו ש
בעל זהות אדומה, צהובה או ירוקה. הוא משמש על ידי מודולי מזין תחתון של RRD, בין היתר
אחרים. ב-Xymon, הודעות נתונים מעובדות כברירת מחדל רק על ידי xymond_rrd(8)
מודול. אם אתה רוצה לטפל בהודעות נתונים באמצעות יישום חיצוני, אתה יכול
רוצה לאפשר את xymond_filestore(8) מודול להודעות נתונים, לאחסון נתונים-
הודעות בפורמט התואם את אופן הפעולה של דמון האח הגדול.

השבת את HOSTNAME.TESTNAME DURATION
משבית בדיקה ספציפית למשך DURATION דקות. זה יגרום למצב של זה
הבדיקה תהיה רשומה כ"כחול" בשרת Xymon, וללא התראות עבור המארח/הבדיקה הזו
יווצר. אם DURATION ניתן כמספר ואחריו s/m/h/d, הוא כן
מתפרש כאילו הוא בשניות/דקות/שעות/ימים בהתאמה. כדי להשבית את א
בדוק עד שהוא הופך להיות תקין, השתמש ב-"-1" בתור DURATION. כדי להשבית את כל הבדיקות עבור א
מארח, השתמש בכוכבית "*" עבור TESTNAME.

הפעל את HOSTNAME.TESTNAME
מפעיל מחדש בדיקה שהושבתה.

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

תצורה FILENAME
אחזר אחד מקבצי התצורה של Xymon מהשרת. פקודה זו מאפשרת
לקוח למשוך קבצים מהספרייה $XYMONHOME/etc/ בשרת, מה שמאפשר
עבור עדכונים חצי אוטומטיים של תצורת הלקוח. מאז התצורה
קבצים מתוכננים כך שיהיה להם קובץ משותף לתצורה של כל המארחים ב-
מערכת - וזו למעשה הדרך המומלצת להגדיר את הלקוחות שלך - זו
מקל על שמירת קבצי התצורה מסונכרנים.

שחרר את HOSTNAME
מסיר את כל הנתונים המאוחסנים על המארח HOSTNAME. ההנחה היא שיש לך
כבר מחק את המארח מקובץ התצורה hosts.cfg.

שחרר את HOSTNAME TESTNAME
הסר נתונים על בדיקה בודדת (עמודה).

שנה את שם OLDHOSTNAME NEWHOSTNAME
שנה את השם של כל הנתונים עבור מארח ששמו שונה. אתה צריך לעשות את זה אחרי
שינוי שם המארח בקובץ התצורה hosts.cfg.

שנה את שם HOSTNAME OLDTESTNAME NEWTESTNAME
שנה שם נתונים לגבי בדיקה בודדת (עמודה).

xymondlog HOSTNAME.TESTNAME
אחזר את יומן המצב של Xymon לבדיקה בודדת. השורה הראשונה של התגובה
מכיל סדרה של שדות מופרדים באמצעות סימן צינור:

המארח שם המארח

שם המבחן שם המבחן

צֶבַע צבע סטטוס (ירוק, צהוב, אדום, כחול, שקוף, סגול)

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

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

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

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

acktime חותמת -1 או Unix כאשר תוקף אישור פעיל יפוג.

זמן השבתה חותמת זמן -1 או Unix כאשר הסטטוס אינו מושבת יותר.

שולח כתובת IP שממנה התקבל הסטטוס.

עוגייה או -1 או ערך ה-cookie המשמש לאשר התראה.

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

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

לאחר השורה הראשונה מגיע יומן המצב המלא בפורמט טקסט רגיל.

xymondxlog HOSTNAME.TESTNAME
מאחזר מחרוזת XML המכילה את יומן המצב כמו בפקודה "xymondlog".

xymondboard [CRITERIA] [fields=FIELDLIST]
מאחזר סיכום של המצב של כל הבדיקות המוכרות הזמינות לדמון ה-Xymon.

כברירת מחדל - אם לא מסופק CRITERIA - הוא מחזיר שורה אחת עבור כל הסטטוסים
הודעות שנמצאות ב-Xymon. אתה יכול לסנן את התגובה לפי בחירה ספציפית
עמוד, מארח, מבחן, צבע או שדות שונים אחרים. ה-PAGEPATH, NETWORK, HOSTNAME,
פרמטרים TESTNAME ו-*MSG מתפרשים לביטויים רגולריים תואמי perl;
הפרמטר COLOR מקבל מספר צבעים מופרדים בפסיקים; ערכי *TIME
קבל חותמות זמן של עידן יוניקס. משתנים אחרים שזוהו ב xymon-xmh(5) עשוי גם
לשמש.

מכיוון שסינון המארח נעשה לפני סינון הבדיקה, הוא יעיל יותר (עם
ערכות נתונים גדולות מאוד) כדי להשתמש במסנני PAGEPATH, HOSTNAME, NETWORK ומסנני XMH_ אחרים
במידת האפשר, לפני סינון גלובלי עם COLOR, *MSG, *TIME או TESTNAME.

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

page=PAGEPATH כלול רק בדיקות ממארחים שנמצאו בדף PAGEPATH ב-
קובץ hosts.cfg.

net=NETWORK כלול רק בדיקות ממארחים עם תג NET: זה

ip=IPכתובת כלול רק בדיקות ממארחים עם כתובת IP זו. זה רקס,
לא CIDR.

host=HOSTNAME כלול רק בדיקות מהמארח HOSTNAME

test=TESTNAME כלול רק בדיקות עם שם הבדיקה TESTNAME

color=COLORNAME כלול רק בדיקות שבהן צבע הסטטוס הוא COLORNAME

tag=TAGNAME כלול רק מארחים עם תג מסוים שצוין ב- hosts.cfg(5)
קַו. שימו לב שרק פריטים המוכרים לרכיבי xymon כלולים כאן; שרירותי
טקסט אינו כלול

XMH_string=VALUE כלול רק מארחים עם א xymon-xmh(5) משתנה המתאים לזה
ערך

סינון מתקדם

msg=הודעה כלול רק בדיקות עם תוכן מלא התואם ל-MESSAGE. השתמש ב-"\s" כדי
מרחבי בריחה (או מחרוזות PCRE אחרות)

ackmsg=הודעה כלול רק בדיקות עם הודעת אישור. השתמש ב-"\s" כדי
מרחבי בריחה (או מחרוזות PCRE אחרות)

dismsg=הודעה כלול רק בדיקות שהושבתו עם התאמת מחרוזות
הוֹדָעָה. השתמש ב-"\s" כדי להימלט מרווחים (או מחרוזות PCRE אחרות). (זה הכי יעיל
כדי לשלב את זה עם צבע=כחול.)

מסנני חותמת זמן

ניתן לסנן שדות מסוימים (הסבר בהמשך) באמצעות חותמות זמן של unix ועם
אי השוויון הבאים: >= > <= < = !=

מסננים אלה הם: lastchange, logtime, validtime, acktime, disabletime

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

המארח שם המארח

שם המבחן שם המבחן

צֶבַע צבע סטטוס (ירוק, צהוב, אדום, כחול, שקוף, סגול)

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

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

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

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

acktime חותמת -1 או Unix כאשר תוקף אישור פעיל יפוג.

זמן השבתה חותמת זמן -1 או Unix כאשר הסטטוס אינו מושבת יותר.

שולח כתובת IP שממנה התקבל הסטטוס.

עוגייה או -1 או ערך ה-cookie המשמש לאשר התראה.

קו 1 שורה ראשונה ביומן המצב.

ackmsg ריק (אם אין אישור פעיל), או הטקסט של האישור
הוֹדָעָה.

dismsg ריק (אם המצב מופעל כעת), או הטקסט של השבתה
הוֹדָעָה.

msg הטקסט המלא של הודעת המצב הנוכחית.

לקוחות מראה "Y" אם יש נתוני לקוח זמינים, "N" אם לא.

clntstamp חותמת זמן מתי התקבלה הודעת הלקוח האחרונה, ב"תקופה" של יוניקס
פורמט.

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

flapinfo אומר אם הסטטוס מתנופף. 5 שדות, מופרדים ב-"/": "0" אם ה-
הסטטוס אינו מתנופף ו"1" אם הוא מתנופף; חותמת זמן כאשר הסטטוס האחרון
השינוי נרשם ומתי נרשם שינוי הסטטוס הראשון; והשניים
צבעים שהסטטוס מתנופף ביניהם.

סטטיסטיקות מספר שינויי הסטטוס שנרשמו עבור הסטטוס הזה מאז xymond
התחיל.

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

XMH_* תגי ה-XMH מתייחסים ל-Xymon hosts.cfg(5) הגדרות תצורה. מלא
רשימה של אלה ניתן למצוא ב xymon-xmh(5) דף אדם.

בשדות ackmsg, dismsg ו- msg יש תווים מסוימים מקודדים: קו חדש הוא "\n",
TAB הוא "\t", החזרת כרכרה היא "\r", סימן צינור הוא "\p", ולוכסן אחורי הוא "\\".

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

xymondxboard
מאחזר מחרוזת XML עם סיכום כל יומני הסטטוס כמו עבור
פקודת "xymondboard".

מידע מארח [CRITERIA]
מאחזר את התצורה הנוכחית של מארח (כלומר את hosts.cfg(5) הַגדָרָה).
CRITERIA בוחר על אילו מארח(ים) לדווח, וזהה ל-CRITERIA ב-
פקודת xymondboard.

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

הורד את FILENAME
הורד קובץ מספריית ההורדות של שרת Xymon.

לקוח[/COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
משמש לשליחת הודעת "לקוח" לשרת Xymon. נוצרות הודעות לקוח
על ידי לקוח Xymon; כאשר נשלחים לשרת ה-Xymon הם מתאימים ל-
כללים ב analysis.cfg(5) קובץ התצורה, והודעות סטטוס נוצרות
עבור הבדיקות בצד הלקוח. ה-COLLECTORID משמש בעת שליחת נתוני לקוח
הם תוספות לנתוני הלקוח הסטנדרטיים. הנתונים יהיו משורשרים עם
נתוני לקוח רגילים.

client log HOSTNAME [section=SECTIONNAME[,SECTIONNAME...]]
מאחזר את הודעת הלקוח הגולמית הנוכחית שנשלחה לאחרונה על ידי HOSTNAME. האופציונלי
מסנן "קטע" משמש לבחירת קטעים ספציפיים של נתוני הלקוח.

ping ניסיונות ליצור קשר עם שרת Xymon. אם זה מצליח, מזהה הגרסה של שרת Xymon הוא
דיווח.

pullclient
הודעה זו משמשת בעת שליפת נתוני לקוח באמצעות מנגנון ה"משיכה" המיושם
by xymonfetch(8) ו msgcache(8) עבור לקוחות שאינם יכולים להתחבר ישירות ל-
שרת Xymon.

רשימת רפאים
דווח על רשימה של רוּחַ לקוחות שנראו על ידי שרת Xymon. רוחות רפאים הן מערכות ש
דווח על נתונים לשרת Xymon, אך אינם רשומים בקובץ hosts.cfg.

תזמון [TIMESTAMP COMMAND]
מתזמן פקודה שנשלחה לשרת Xymon לביצוע במועד מאוחר יותר. לְמָשָׁל
משמש לתזמן השבתה של מארח או שירות מתישהו בעתיד. פקודה
היא פקודת Xymon שלמה כמו אלה המפורטות למעלה. TIMESTAMP הוא ה-Unix
תקופה שבה הפקודה תתבצע.
אם לא ניתנים פרמטרים, המשימות המתוזמנות כעת רשומות ב-
תְגוּבָה. התגובה היא שורה אחת לכל פקודה מתוזמנת, עם מזהה התפקיד, ה
הזמן שבו הפקודה תתבצע, כתובת ה-IP שממנה זה נשלח,
ואת מחרוזת הפקודה המלאה.
כדי לבטל פקודה שתוזמנה בעבר, "לוח זמנים לבטל עבודה" יכול לשמש.
JOBID הוא מספר המסופק כפריט הראשון בפלט מרשימת לוח הזמנים.

הערות FILENAME
טקסט ההודעה יאוחסן ב-$XYMONHOME/notes/FILENAME אשר לאחר מכן משמש בתור
היפר-קישורים משמות מארחים או שמות עמודות. זה מחייב את המשימה "storenotes".
מופעל ב-tasks.cfg (הוא מושבת כברירת מחדל). FILENAME לא יכול להכיל אף אחד
נתיב ספרייה - אלה נמחקים אוטומטית.

מזהה usermsg
הודעות אלו יועברו ישירות למודולים שמאזינים בערוץ "משתמש".
של דמון הקסימון. זה מיועד לתקשורת מותאמת אישית בין צד הלקוח
מודולים ושרת Xymon.

שנה את HOSTNAME.TESTNAME COLOR SOURCE סיבה
שנה את הצבע של סטטוס מסוים, מבלי ליצור סטטוס שלם
הוֹדָעָה. זה מיועד למעבדי קצה אחורי (למשל גרפי RRD) שיכולים לעקוף את
צבע של סטטוס מבוסס על כמה קריטריונים שנקבעו מחוץ לזרימה הרגילה של a
סטָטוּס. לדוגמה, המצב הרגיל של "חיבור" עשוי להיראות ירוק מכיוון שהוא רק בודק
האם ניתן לעשות פינג'ינג למארח או לא; המטפל RRD יכול להשתמש ב-"שינוי"
הפקודה לעקוף זאת היא שזמן תגובת הפינג בפועל חורג מסף נתון.
(ראה את הגדרת התצורה "DS" ב analysis.cfg(5) כיצד לעשות זאת). מָקוֹר
הוא זיהוי כלשהו של המודול שיוצר את הודעת ה"שנה" - עתיד
שינויים חייבים להשתמש באותו מקור. עשויים להיות מספר מקורות שמשנים
אותו סטטוס (הסטטוס החמור ביותר הופך לצבע האמיתי של ה
סטָטוּס). CAUSE היא מחרוזת טקסט בת שורה אחת המסבירה את הסיבה לעקוף את
צבע סטטוס רגיל - הוא יוצג בדף הסטטוס.

דוגמא

שלח הודעת מצב רגילה לשרת Xymon, באמצעות פרוטוקול Xymon הסטנדרטי ב-TCP
נמל 1984:
$ $XYMON $XYMSRV "סטטוס www,foo,com.http green `date` Web OK"

שלח את אותה הודעת סטטוס, אך באמצעות פרוטוקול HTTP דרך xymoncgimsg.cgi של שרת האינטרנט
תַסרִיט:
$$XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "סטטוס www,foo,com.http ירוק
`תאריך` אינטרנט בסדר"

השתמש בהודעת "שאילתה" כדי לקבוע את הצבע של מבחן "www", והפעל מחדש את Apache אם כן
אדום:

$ WWW=`$XYMON $XYMSRV "שאילתה www,foo,com.www" | awk '{print $1}'`
$ if [ "$WWW" = "אדום" ]; לאחר מכן /etc/init.d/apache הפעל מחדש; fi

השתמש בהודעת "config" כדי לעדכן קובץ mytest.cfg מקומי (אבל רק אם נקבל תשובה):

$ $XYMON $XYMSRV "config mytest.cfg" >/tmp/mytest.cfg.new
$ if [ -s /tmp/mytest.cfg.new ]; לאחר מכן
mv /tmp/mytest.cfg.new $XYMONHOME/etc/mytest.cfg
fi

שלח הודעת סטטוס גדולה מאוד שנבנתה בקובץ "statusmsg.txt". במקום זאת
של מתן אותו בשורת הפקודה, העבר אותו דרך stdin לפקודה xymon:

$ cat statusmsg.txt | $XYMON $XYMSRV "@"

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