📘 תיעוד 56

ניטור

עודכן לאחרונה ב-23 ביוני 2026 | העתק כ-Markdown | הצג כ-Markdown | הגדרת סוכן

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

#תקינות המנהרה

באפשרותך לבדוק את סטטוס חיבור המנהרה ב-לוח הבקרה של Cloudflare ↗ על ידי מעבר אל Networking > Tunnels, או על ידי הרצת cloudflared tunnel list.

מעבר אל Tunnels ↗

היקף סטטוס המנהרה

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

#התראות

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

כדי להגדיר התראות מנהרה, עיין ב-יצירת התראה.

אירוע יצירה או מחיקה של מנהרה

עבור מי זה מיועד?

לקוחות המעוניינים לקבל התראה כאשר מנהרות Cloudflare Tunnel נוצרות או נמחקות בחשבונם.

אפשרויות / מסננים נוספים

אין.

כלול ב

כל תוכניות Cloudflare Zero Trust.

מה עליך לעשות אם קיבלת התראה כזו?

לא נדרשת פעולה.

התראת תקינות מנהרה

עבור מי זה מיועד?

לקוחות המעוניינים לקבל אזהרה על שינויים בסטטוס התקינות של מנהרות Cloudflare Tunnel שלהם.

אפשרויות / מסננים נוספים

אין.

כלול ב

כל תוכניות Cloudflare Zero Trust.

מה עליך לעשות אם קיבלת התראה כזו?

עקוב אחר תקינות המנהרה לאורך זמן ושקול לפרוס עותקים משוכפלים (replicas) או מאזני עומסים של cloudflared.

מידע נוסף

עיין ב-סטטוס מנהרה כדי לסקור את רשימת סטטוסי המנהרה האפשריים (Healthy, Inactive, Down ו-Degraded).

#יומנים

יומני מנהרה מתעדים את כל הפעילות בין cloudflared לבין הרשת הגלובלית של Cloudflare, ואת כל הפעילות בין cloudflared לבין שרת המקור שלך.

#יומנים בצד השרת

אם יש לך גישה לשרת המקור, תוכל להשתמש ב-דגל --loglevel כדי לאפשר רישום יומנים בעת הפעלת המנהרה. כברירת מחדל, cloudflared כותב יומנים לפלט השגיאות הסטנדרטי (stderr) ואינו שומר יומנים בשרת.

הערה

דורש את cloudflared בגרסה 2025.6.1 ומעלה.

כדי לעצב כל שורת יומן כאובייקט JSON, הוסף את --output json לפני run:

cloudflared tunnel --output json run <UUID>

פורמט זה שימושי עבור פריסות Kubernetes ומערכות איסוף יומנים הצורכות JSON.

עבור רישום יומנים קבוע ושגרתי, הפעל את המנהרה עם --log-directory <PATH>. דגל זה כותב יומנים לקובץ cloudflared.log בספרייה שצוינה, מבצע סבב לקובץ כאשר הוא מגיע לגודל של 1 MB, ושומר עד חמישה גיבויים. הוא אינו מסיר יומנים לפי גיל.

cloudflared tunnel --loglevel info --log-directory <PATH> run <UUID>

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

#הזרמת יומנים מרחוק

באפשרותך להזרים יומנים בזמן אמת ממנהרה פועלת ללא גישת SSH לשרת.

תהליך הרקע של cloudflared יכול להזרים יומנים מכל מנהרה בחשבונך לשורת הפקודה המקומית. על cloudflared להיות מותקן גם במכונה המקומית וגם בשרת המקור.

1. במכונה המקומית שלך, בצע אימות של cloudflared מול חשבון Cloudflare שלך:

cloudflared tunnel login

2. הרץ את cloudflared tail עבור מנהרה ספציפית:

cloudflared tail <UUID>

לתצוגה מובנית יותר של הודעת ה-JSON, תוכל להעביר את הפלט בצינור לכלים כמו jq ↗:

cloudflared tail --output=json <UUID> | jq .

3. אם אתה מפעיל מספר עותקים משוכפלים (replicas), תוכל לציין מאיזה עותק משוכפל להזרים יומנים:

cloudflared tail --connector-id <REPLICA ID> <UUID>

כדי למצוא את מזהה העותק המשוכפל, עבור אל Networking > Tunnels ובחר את המנהרה שלך. כל העותקים המשוכפלים הפעילים מופיעים ברשימת ה-Connectors בדף הסקירה הכללית של המנהרה. מזהה העותק המשוכפל הוא ה-Connector ID.

אפשרויות סינון יומנים

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

cloudflared tail --level debug <UUID>

כדי להזרים יומני מנהרה מלוח הבקרה:

1. בלוח הבקרה של Cloudflare, עבור אל Networking > Tunnels ובחר את המנהרה שלך. מעבר אל Tunnels ↗
2. עבור ללשונית Live logs.
3. בחר Live כדי להתחיל בהזרמה.

#הצגת יומנים עבור עותק משוכפל (replica)

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

כדי לסנן את הזרם לעותקים משוכפלים ספציפיים, בחר בסמל Filter והרחב את המקטע Replicas. באפשרותך גם לסנן לפי Log Level ו-Event Type.

#מדדים

מדדי מנהרה מציגים את תפוקת הנתונים (throughput) והשימוש במשאבים של Cloudflare Tunnel לאורך זמן. בעת הפעלת מנהרה, cloudflared יפעיל נקודת קצה למדדי Prometheus, שרת HTTP החושף מדדים בפורמט Prometheus ↗. באפשרותך להשתמש בערכת הכלים של Prometheus במכונה מרוחקת כדי לאסוף (scrape) נתוני מדדים משרת ה-cloudflared.

#כתובת ברירת המחדל של שרת המדדים

בסביבות שאינן מבוססות קונטיינרים, cloudflared מפעיל את שרת המדדים בכתובת 127.0.0.1:<PORT>/metrics, כאשר <PORT> הוא היציאה הראשונה הזמינה בטווח בין 20241 ל-20245. אם כל היציאות אינן זמינות, cloudflared נקשר ליציאה אקראית. בסביבות מבוססות קונטיינרים (Docker, Kubernetes), כתובת ברירת המחדל היא 0.0.0.0:<PORT>/metrics.

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

2024-12-19T21:17:58Z INF Starting metrics server on 127.0.0.1:20241/metrics

#הגדרת כתובת מותאמת אישית

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

1. הפעל את המנהרה באמצעות הדגל --metrics. לדוגמה:

cloudflared tunnel --metrics 127.0.0.1:60123 run my-tunnel

הערה: אם בכוונתך לאסוף מדדים ממכונה אחרת ברשת המקומית, החלף את 127.0.0.1 בכתובת ה-IP הפנימית של שרת ה-cloudflared (לדוגמה, 198.168.x.x). כדי להגיש מדדים בכל ממשקי הרשת הזמינים, השתמש ב-0.0.0.0. 2. ודא ששרת המדדים פועל על ידי מעבר אל http://localhost:60123/metrics. פעולה זו תפעל רק אם הגדרת כתובת IP של localhost (127.0.0.1 או 0.0.0.0).

כעת תוכל לייצא את המדדים ל-Prometheus ול-Grafana כדי להציג חזותית ולתשאל את הנתונים. עיין ב-מדריך Grafana להוראות תחילת עבודה עם כלים אלה.

מדדי cloudflared

מדדי Prometheus

מדדי סביבת זמן הריצה של Go