Table of Contents

zabbix_sender

zabbix_sender

סעיף: פקודות משתמש (1)
עודכן: 2021-06-01
מפתח עניינים חזרה לתוכן הראשי

NAME

zabbix_sender - כלי Zabbix sender (משלח)

תמצית

zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s host --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s host --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender -h
zabbix_sender -V

תיאור

zabbix_sender הוא כלי שורת פקודה לשליחת נתוני מעקב לשרת Zabbix או למתווך. בשרת Zabbix אמור להיווצר פריט מסוג Zabix trapper עם מפתח מתאים. נא לשים לב שערכים נכנסים יתקבלו רק ממארחים שצוינו בשדה מארחים מורשים עבור פריט זה.

אפשרויות

-c, --config config-file השתמש ב-config-file. שולח Zabbix קורא פרטי שרת מה- קובץ התצורה של agentd. כברירת מחדל שולח Zabbix אינו קורא כל קובץ תצורה. רק פרמטרים שם מארח, ServerActive, מקור IP, TLSConnekt, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity ו-TLSPSKFile נתמכים. את כל כתובות המוגדרות בפרמטר התצורה של הסוכן ServerActive משמשים לשליחת נתונים. אם שליחת נתוני אצווה נכשלת לאחד כתובת, הקבוצות הבאות אינן נשלחות לכתובת זו.

-z, --zabbix-server שרת שם מארח או כתובת IP של שרת Zabbix. אם מארח מנוטר על ידי א במקום זאת יש להשתמש ב-proxy, בשם מארח פרוקסי או בכתובת IP. בעת שימוש יחד עם --config, עוקף את הערכים של ServerActive פרמטר שצוין בקובץ התצורה של agent.

-p, --port יציאה ציין את מספר היציאה של Zabbix Server Trapper הפועל בשרת. ברירת המחדל היא 10051. בשימוש יחד עם --config, עוקף את ערכי יציאה של פרמטר ServerActive שצוין ב-agent קובץ תצורה.

-I, --כתובת מקור כתובת IP ציין כתובת IP מקור. בשימוש יחד עם --config, עוקף את פרמטר SourceIP שצוין בקובץ התצורה של agent.

-t, --פסק זמן שניות ציין פסק זמן. טווח חוקי: 1-300 שניות (ברירת מחדל: 60)

-s, --מארח מארח ציין את שם המארח שאליו שייך הפריט (כפי שרשום ב- Zabbix חזיתי). כתובת ה-IP של המארח ושם ה-DNS לא יפעלו. בעת שימוש יחד עם --config, עוקף את פרמטר שם מארח שצוין בקובץ התצורה של agent.

-k, --מפתח מפתח ציין מפתח פריט שאליו יש לשלוח ערך.

-o, --value ערך ציין ערך פריט.

-i, --input-file input-file טען ערכים מקובץ קלט. ציין - בתור <input-file> ל קרא ערכים מקלט סטנדרטי. כל שורת קובץ מכילה רווח לבן מופרד: <שם מארח> <מפתח> <ערך>. כל ערך יש לציין בשורה משלו. כל שורה חייבת להכיל 3 רווחים לבנים ערכים מופרדים: <שם מארח> <מפתח> <ערך>, איפה "שם מארח" הוא השם של המארח המנוטר כפי שרשום ב- Zabbix frontend, "key" הוא מפתח פריט יעד ו-"value" - הערך שיש לשלוח. ציין - בתור <שם מארח> כדי להשתמש בשם מארח מסוכן קובץ תצורה או מארגומנט --host.

דוגמה לשורה של קובץ קלט:

"Linux DB3" db.connections 43

סוג הערך חייב להיות מוגדר כהלכה בתצורת הפריט של Zabbix frontend. שולח Zabbix ישלח עד 250 ערכים בחיבור אחד. מגבלת גודל לשליחת ערכים מקובץ קלט תלוי בגודל המתואר בפרוטוקול התקשורת של Zabbix. התוכן של קובץ הקלט חייב להיות בקידוד UTF-8. כל הערכים מקובץ הקלט נשלחים בסדר רציף מלמעלה למטה. יש לעצב את הערכים לפי הכללים הבאים:

• ערכים מובאים וערכים שאינם מובאים נתמכים.

• מרכאה כפולה היא תו הציטוט.

• יש לצטט ערכים עם רווח לבן.

• מרכאות כפולות ותווים קו נטוי אחורי בתוך הערך המצוטט חייבים להיות נמלט עם קו נטוי לאחור.

• בריחה אינה נתמכת בערכים שאינם במירכאות.

• רצפי בריחה של Linefeed (\n) נתמכים במחרוזות במרכאות.

• רצפי בריחה של Linefeed נחתכים מסוף ערך.

-T, --עם חותמות זמן ניתן להשתמש באפשרות זו רק עם אפשרות --input-file.

כל שורה בקובץ הקלט חייבת להכיל 4 ערכים מופרדים ברווח לבן: <שם מארח> <מפתח> <חותמת זמן> <ערך>. יש לציין חותמת זמן בפורמט חותמת זמן של Unix. אם פריט יעד יש טריגרים המתייחסים אליו, כל חותמות הזמן חייבות להיות בעלייה סדר, אחרת חישוב האירוע לא יהיה נכון.

דוגמה לשורה של קובץ הקלט:

"Linux DB3" db.connections 1429533600 43

לפרטים נוספים, ראה אפשרות --input-file.

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

-N, --with-ns ניתן להשתמש באפשרות זו רק עם אפשרות --עם חותמות זמן.

כל שורה בקובץ הקלט חייבת להכיל 5 ערכים מופרדים ברווח לבן: <שם מארח> <key> <חותמת זמן> <ns> <value>.

דוגמה לשורה של קובץ הקלט:

"Linux DB3" db.connections 1429533600 7402561 43

לפרטים נוספים, ראה אפשרות --input-file.

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

--tls-connect ערך כיצד להתחבר לשרת או ל-proxy. ערכים:

לא מוצפן התחבר ללא הצפנה (ברירת מחדל)

psk להתחבר באמצעות TLS ומפתח משותף מראש

תעודה להתחבר באמצעות TLS ואישור

--tls-ca-file CA-file שם הנתיב המלא של קובץ המכיל את אישורי ה-CA ברמה העליונה עבור אימות תעודת עמיתים.

--tls-crl-file CRL-file שם נתיב מלא של קובץ המכיל אישורים שבוטלו.

--tls-server-cert-issuer cert-insuer מנפיק אישור שרת מותר.

--tls-server-cert-subject cert-subject נושא תעודת שרת מותר.

--tls-cert-file cert-file שם נתיב מלא של קובץ המכיל את האישור או שרשרת האישורים.

--tls-key-file key-file שם נתיב מלא של קובץ המכיל את המפתח הפרטי.

--tls-psk-identity PSK-identity מחרוזת זהות PSK.

--tls-psk-file קובץ PSK שם נתיב מלא של קובץ המכיל את המפתח המשותף מראש.

--tls-cipher13 מחרוזת צופן מחרוזת צופן עבור OpenSSL 1.1.1 או חדש יותר עבור TLS 1.3. תעקוף את קריטריונים לבחירת חבילת צופן כברירת מחדל. אפשרות זו אינה זמינה אם גרסת OpenSSL היא פחות מ-1.1.1.

--tls-cipher מחרוזת צופן מחרוזת עדיפות GnuTLS (עבור TLS 1.2 ומעלה) או מחרוזת צופן OpenSSL (רק עבור TLS 1.2). עוקף את קריטריוני ברירת המחדל של חבילת צופן.

-v, --רבות מילה מצב מילולי, -vv לפרטים נוספים.

-ח, --עזרה הצג את העזרה הזו וצא.

-V, --גרסה פלט מידע על גרסת ויציאה.

סטטוס יציאה

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

דוגמאות

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45

שלח 342.45 כערך עבור פריט mysql.queries של מנוטר מנחה. השתמש במארח מנוטר ובשרת Zabbix המוגדרים בסוכן קובץ תצורה.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "מארח מפוקח" -k mysql.queries -o 342.45

שלח 342.45 כערך עבור פריט mysql.queries של מנוטר מארח מארח באמצעות שרת Zabbix המוגדר בקובץ תצורת הסוכן.

zabbix_sender -z 192.168.1.113 -i data_values.txt

שלח ערכים מהקובץ data_values.txt לשרת Zabbix עם IP 192.168.1.113. שמות מארחים ומפתחות מוגדרים בקובץ.

echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -T -i -

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

echo '"שרת Zabbix" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

שלח ערך ריק של פריט לשרת Zabbix עם כתובת IP 192.168.1.113 ביציאה 10000 משורת הפקודה. ערכים ריקים יש לציין במרכאות כפולות ריקות.

zabbix_sender -z 192.168.1.113 -s "מארח מנוטר" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-cert-file /home/zabbix/zabbix_agentd.crt --tls-key-file /home/zabbix/zabbix_agentd.key

שלח 342.45 כערך עבור פריט mysql.queries ב-מנוטר מארח מארח לשרת עם IP 192.168.1.113 באמצעות TLS עם תְעוּדָה.

zabbix_sender -z 192.168.1.113 -s "מארח מנוטר" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix_agentd.psk

שלח 342.45 כערך עבור פריט mysql.queries ב-מנוטר מארח מארח לשרת עם IP 192.168.1.113 באמצעות TLS עם מפתח משותף מראש (PSK).