journalctl - מקוון בענן

תָכְנִית:

שֵׁם

journalctl - שאילתה ביומן systemd

תַקצִיר

journalctl [אפשרויות...] [התאמות...]

תיאור

journalctl ניתן להשתמש כדי לשאול את התוכן של system(1) יומן כפי שנכתב על ידי
systemd-journald.service(8).

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

אם מועברים ארגומנט התאמה אחד או יותר, הפלט מסונן בהתאם. התאמה היא
בפורמט "FIELD=VALUE", למשל "_SYSTEMD_UNIT=httpd.service", בהתייחס ל-
רכיבים של ערך יומן מובנה. לִרְאוֹת systemd.journal-fields(7) לרשימה של
תחומים ידועים. אם צוינו התאמות מרובות התואמות לשדות שונים, היומן
ערכים מסוננים על ידי שניהם, כלומר הפלט המתקבל יציג רק ערכים תואמים
כל ההתאמות שצוינו מסוג זה. אם שתי התאמות חלות על אותו שדה, אז הן
מותאמים אוטומטית כחלופות, כלומר הפלט המתקבל יציג ערכים
התאמת כל אחת מההתאמות שצוינו עבור אותו שדה. לבסוף, התו "+" עשוי
מופיעים כמילה נפרדת בין מונחים אחרים בשורת הפקודה. זה גורם לכל ההתאמות
לפני ואחרי ישולבו בניתוק (כלומר OR לוגי).

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

ניתן להוסיף אילוצים נוספים באמצעות אפשרויות --מַגָף, --unit=וכו', להגביל עוד יותר
אילו ערכים יוצגו (ולוגי).

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

ניתן לשנות את ערכת קבצי היומן שישמשו באמצעות ה- --מִשׁתַמֵשׁ, --מערכת,
--מַדרִיך, ו --קוֹבֶץ אפשרויות, ראה להלן.

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

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

כאשר יוצאים ל-tty, קווים נצבעים לפי עדיפות: קווים של רמת ERROR
ומעלה נצבעים באדום; שורות של NOTICE ברמה ומעלה מסומנות; קווים אחרים
מוצגים כרגיל.

אפשרויות

האפשרויות הבאות מובנות:

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

האפשרויות הישנות -l/--מלא אינם שימושיים יותר, מלבד לביטול --לא-מלא.

-a, --את כל
הצג את כל השדות במלואם, גם אם הם כוללים תווים שאינם ניתנים להדפסה או ארוכים מאוד.

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

-e, --איפר-סוף
קפוץ מיד לסוף היומן בתוך כלי הביפר המרומז. זה מרמז
-n1000 כדי להבטיח שהביפר לא יאגר יומנים בגודל בלתי מוגבל. זה יכול להיות
נדחק עם מפורש -n עם ערך מספרי אחר, בעוד -נאל ישבית
הכובע הזה. שים לב שאפשרות זו נתמכת רק עבור פחות(1) ביפר.

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

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

-r, --לַהֲפוֹך
הפוך פלט כך שהערכים החדשים ביותר יוצגו תחילה.

-o, --פלט=
שולט בעיצוב של תנועות היומן המוצגות. לוקח אחד מה
האפשרויות הבאות:

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

קצר-iso
דומה מאוד, אבל מציג חותמות זמן של שעון קיר ISO 8601.

קצר-מדויק
דומה מאוד, אך מציג חותמות זמן בדיוק מלא של מיקרו-שניות.

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

מִלוּלִי
מציג את פריטי הערך המובנים המלאים עם כל השדות.

יצוא
מסדרת את היומן לזרם בינארי (אך בעיקר מבוסס טקסט) המתאים ל
גיבויים והעברת רשת (ראה כתב העת יצוא פוּרמָט[1] למידע נוסף).

ג'סון
פורמט ערכים כמבני נתונים של JSON, אחד בכל שורה (ראה כתב העת JSON פוּרמָט[2]
למידע נוסף).

json-יפה
מעצב ערכים כמבני נתונים של JSON, אבל מעצב אותם במספר שורות ב
כדי להפוך אותם לקריאה יותר על ידי בני אדם.

json-sse
מעצב ערכים כמבני נתונים של JSON, אך עוטף אותם בפורמט המתאים עבור
שרת נשלח אירועים[3].

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

--utc
זמן אקספרס בזמן אוניברסלי מתואם (UTC).

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

הערה: בעת החיבור journalctl פלט לדוחות באגים, בבקשה עשה לֹא להשתמש -x.

-q, --שֶׁקֶט
דוחק את כל הודעות המידע (כלומר "-- יומנים מתחילים ב...", "-- אתחול מחדש --"), כל
הודעות אזהרה לגבי יומני מערכת בלתי נגישים כאשר הם פועלים כמשתמש רגיל.

-m, --לְמַזֵג
הצג ערכים משולבים מכל היומנים הזמינים, כולל מרוחקים.

-b [ID][± היסט], --boot=[ID][± היסט]
הצג הודעות מאתחול ספציפי. זה יוסיף התאמה עבור "_BOOT_ID=".

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

אם מזהה האתחול מושמט, חיובי לקזז יחפש את המגפיים החל מה-
תחילת היומן, ושווה-או-פחות מאפס לקזז יחפש מגפיים
החל מסוף היומן. לכן, 1 פירושו האתחול הראשון שנמצא ב-
כתב עת לפי סדר כרונולוגי, 2 השני וכן הלאה; בזמן -0 הוא המגף האחרון, -1
המגף לפני האחרון, וכן הלאה. ריק לקזז שווה לציון -0,
אלא כאשר האתחול הנוכחי אינו האתחול האחרון (למשל בגלל --מַדרִיך היה
שצוין כדי להסתכל על יומנים ממכונה אחרת).

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

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

-k, --dmesg
הצג רק הודעות ליבה. זה מרמז -b ומוסיף את ההתאמה "_TRANSPORT=kernel".

-t, --מזהה=SYSLOG_IDENTIFIER
הצג הודעות עבור מזהה syslog שצוין SYSLOG_IDENTIFIER.

ניתן לציין פרמטר זה מספר פעמים.

-u, --unit=יחידה|תַבְנִית
הצג הודעות עבור יחידת המערכת שצוינה יחידה (כגון יחידת שירות), או לכל
מהיחידות המותאמות על ידי תַבְנִית. אם צוין דפוס, נמצאה רשימה של שמות יחידות
ביומן מושווה עם הדפוס שצוין ומשתמשים בכל ההתאמה. ל
לכל שם יחידה, התאמה מתווספת להודעות מהיחידה ("_SYSTEMD_UNIT=יחידה"),
יחד עם התאמות נוספות להודעות מ-systemd והודעות על coredumps
עבור היחידה שצוינה.

ניתן לציין פרמטר זה מספר פעמים.

--user-unit=
הצג הודעות עבור יחידת ההפעלה של המשתמש שצוינה. זה יוסיף התאמה להודעות
מהיחידה ("_SYSTEMD_USER_UNIT=" ו-"_UID=") והתאמות נוספות להודעות
מ-Session systemd והודעות על coredumps עבור היחידה שצוינה.

ניתן לציין פרמטר זה מספר פעמים.

-p, --עדיפות=
סנן פלט לפי עדיפויות הודעות או טווחי עדיפות. לוקח מספר אחד או אחד
או רמת יומן טקסטואלי (כלומר בין 0/"emerg" ו-7/"debug"), או טווח של
רמות יומן מספרי/טקסט בצורה FROM..TO. רמות היומן הן יומן ה-syslog הרגיל
רמות כפי שמתועדות ב syslog(3), כלומר "להגיח" (0), "התראה" (1), "קריט" (2),
"שגיאה" (3), "אזהרה" (4), "הודעה" (5), "מידע" (6), "ניפוי באגים" (7). אם רמת יומן בודדת
מצוין, כל ההודעות עם רמת יומן זו או יומן נמוך יותר (ולכן חשוב יותר).
הרמה מוצגות. אם צוין טווח, כל ההודעות בטווח יוצגו,
כולל גם את ערך ההתחלה וגם את ערך הסיום של הטווח. זה יוסיף "PRIORITY="
התאמות לסדר העדיפויות שצוין.

-c, --cursor=
התחל להציג ערכים מהמיקום ביומן שצוין על ידי הסמן שעבר.

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

--הצג-סמן
הסמן מוצג לאחר הערך האחרון לאחר שני מקפים:

-- סמן: s=0639...

הפורמט של הסמן הוא פרטי ונתון לשינויים.

-S, --מאז=, -U, --עד=
התחל להציג ערכים בתאריך או יותר מהתאריך שצוין, או בתאריך או ישן יותר מהתאריך
תאריך שצוין, בהתאמה. מפרטי התאריך צריכים להיות בפורמט "2012-10-30
18:17:16". אם מושמט חלק הזמן, ההנחה היא "00:00:00". אם רק השניות
הרכיב מושמט, ההנחה היא ":00". אם רכיב התאריך מושמט, הנוכחי
יום מוערך. לחילופין המחרוזות "אתמול", "היום", "מחר" הן
מובן, אשר מתייחסים לשעה 00:00:00 של היום שלפני היום הנוכחי, הנוכחי
יום, או היום שאחרי היום הנוכחי, בהתאמה. "עכשיו" מתייחס לזרם
זְמַן. לבסוף, ניתן לציין זמנים יחסיים, עם קידומת "-" או "+", בהתייחסו
פעמים לפני או אחרי השעה הנוכחית, בהתאמה. לשעה ותאריך מלאים
מפרט, ראה systemd.time(7).

-F, --field=
הדפס את כל ערכי הנתונים האפשריים שהשדה שצוין יכול לקחת בכל הערכים של
כתב עת.

-N, --שדות
הדפס את כל שמות השדות המשמשים כעת בכל הרשומות של היומן.

--מערכת, --מִשׁתַמֵשׁ
הצג הודעות משירותי מערכת ומהקרנל (עם --מערכת). הצג הודעות מ
שירות המשתמש הנוכחי (עם --מִשׁתַמֵשׁ). אם אף אחד מהם לא צוין, הצג את כל ההודעות ש
המשתמש יכול לראות.

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

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

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

--root=שורש
לוקח נתיב ספרייה כארגומנט. אם צוין, journalctl יפעל על
היררכיית קבצי קטלוג מתחת לספרייה שצוינה במקום לשורש
ספריה (למשל --עדכון-קטלוג ייצור שורש/var/lib/systemd/catalog/database).

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

--כּוֹתֶרֶת
במקום להציג את תוכן היומן, הצג מידע על הכותרת הפנימית של היומן
שדות שניגשים אליהם.

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

--גודל ואקום=, --זמן ואקום=, --ואקום-קבצים=
מסיר קובצי יומן בארכיון עד ששטח הדיסק שהם משתמשים בו יורד מתחת למצוין
גודל (מצוין עם הסיומות הרגילות "K", "M", "G" ו-"T"), או כל קבצי היומן
לא מכיל נתונים ישנים יותר מתוחלת הזמן שצוינה (מצוין עם ה-"s" הרגילים,
הסיומות "דקה", "ח", "ימים", "חודשים", "שבועות" ו"שנים", או לא יותר מהסיומת
נותר מספר מוגדר של קבצי יומן נפרדים. שימו לב שפועל --גודל ואקום=
יש רק השפעה עקיפה על הפלט שמוצג על ידי --שימוש בדיסק, כאחרון
כולל קבצי יומן פעילים, בעוד פעולת שאיבת האבק פועלת רק על ארכיון
קבצי יומן. באופן דומה, --ואקום-קבצים= אולי לא באמת יפחית את מספר
קבצי יומן מתחת למספר שצוין, מכיוון שהוא לא יסיר יומן פעיל
קבצים. --גודל ואקום=, --זמן ואקום= ו --ואקום-קבצים= ניתן לשלב ביחיד
דרישה לאכוף כל שילוב של הגבלה בגודל, זמן ומספר קבצים
את קבצי היומן הארכיון. ציון כל אחד משלושת הפרמטרים הללו כאפס הוא
שווה ערך לאי-אכיפה של המגבלה הספציפית, ולכן הוא מיותר.

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

אם בכלל מזהה 128 סיביותיצוינו, רק הערכים האלה מוצגים.

--קטלוג dump [מזהה 128 סיביות...]
הצג את התוכן של קטלוג ההודעות, עם ערכים מופרדים בשורה מורכבת
של שני מקפים והמזהה (הפורמט זהה לקובצי .catalog).

אם בכלל מזהה 128 סיביותיצוינו, רק הערכים האלה מוצגים.

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

--מפתחות התקנה
במקום להציג תוכן יומן, צור זוג מפתחות חדש עבור Forward Secure
איטום (FSS). פעולה זו תיצור מפתח איטום ומפתח אימות. האיטום
המפתח מאוחסן בספריית נתוני היומן ויישאר במארח. ה
מפתח אימות צריך להיות מאוחסן חיצונית. עיין ב חותם= אפשרות ב
journald.conf(5) למידע על Forward Secure Sealing ולקישור לא
מאמר אקדמי שופט המפרט את התיאוריה ההצפנה שעליה היא מבוססת.

--כּוֹחַ
מתי --מפתחות התקנה עבר וכבר עברה Forward Secure Sealing (FSS).
מוגדר, צור מחדש מפתחות FSS.

--interval=
מציין את מרווח השינויים עבור מפתח האיטום בעת יצירת צמד מפתחות FSS עם
--מפתחות התקנה. מרווחים קצרים יותר מגדילים את צריכת המעבד אך מקצרים את טווח הזמן של
שינויים ביומן בלתי ניתנים לזיהוי. ברירת המחדל היא 15 דקות.

--תאשר
בדוק את קובץ היומן עבור עקביות פנימית. אם הקובץ נוצר עם
FSS מופעל ומפתח האימות של FSS צוין עם --verify-key=,
האותנטיות של קובץ היומן מאומתת.

--verify-key=
מציין את מפתח אימות FSS לשימוש עבור --תאשר פעולה.

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

--סומק
מבקש מדמון היומן לשטוף את כל נתוני היומן המאוחסנים בו /run/log/journal אל תוך
/var/log/journal, אם אחסון מתמשך מופעל. השיחה הזו לא חוזרת עד
הפעולה הושלמה. שימו לב שהקריאה הזו היא אימפוטנטית: הנתונים נשטפים רק
החל מ- /run/log/journal לתוך /var/log/journal פעם אחת במהלך זמן הריצה של המערכת, וזה
הפקודה יוצאת בצורה נקייה מבלי לבצע שום פעולה אם זה כבר בוצע
קרה. פקודה זו מבטיחה למעשה שכל הנתונים יישטפו
/var/log/journal בזמן שהוא חוזר.

--להתחלף
מבקש מדמון היומן לסובב קבצי יומן. שיחה זו לא חוזרת עד ה-
פעולת הסיבוב הושלמה.

-h, - עזרה
הדפיסו טקסט עזרה קצר וצאו.

--גִרְסָה
הדפיסו מחרוזת גרסה קצרה וצאו.

--ללא איתור
אל תעביר פלט לביפר.

יְצִיאָה סטָטוּס

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

הסביבה

$SYSTEMD_PAGER
ביפר לשימוש מתי --ללא איתור לא ניתן; עוקף $PAGER. מגדיר את זה לריק
מחרוזת או הערך "חתול" שווה ערך למעבר --ללא איתור.

$SYSTEMD_LESS
לעקוף את אפשרויות ברירת המחדל שהועברו אליה פחות ("FRSXMK").

דוגמאות

ללא ארגומנטים, כל היומנים שנאספו מוצגים ללא סינון:

journalctl

כשצוין התאמה אחת, כל הערכים עם שדה התואם לביטוי מוצגים:

journalctl _SYSTEMD_UNIT=avahi-daemon.service

אם שני שדות שונים מותאמים, רק ערכים התואמים את שני הביטויים בו זמנית
הזמן מוצגים:

journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097

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

journalctl _SYSTEMD_UNIT=avahi-daemon.service _SYSTEMD_UNIT=dbus.service

אם נעשה שימוש במפריד "+", ניתן לשלב שני ביטויים ב-OR לוגי. ה
הבא יציג את כל ההודעות מתהליך השירות של Avahi עם PID 28097 plus
כל ההודעות משירות D-Bus (מכל אחד מהתהליכים שלו):

journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 + _SYSTEMD_UNIT=dbus.service

הצג את כל היומנים שנוצרו על ידי קובץ ההפעלה של D-Bus:

journalctl /usr/bin/dbus-daemon

הצג את כל יומני הליבה מהאתחול הקודם:

journalctl -k -b -1

הצג תצוגת יומן חי משירות מערכת apache.service:

journalctl -f -u apache

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