הגדרה של רישום ביומן

בדף הזה מוסבר איך Cloud Network Insights משתלב עם AppNeta כדי ליצור התראות, ואיך ההתראות האלה נשלחות אל Google Cloud לניתוח, לצפייה וליצירת מדיניות התראות.

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

יוצרים שעונים מעוררים וכללים לשעונים מעוררים ב-AppNeta כדי ליצור יומני שעונים מעוררים. יומני האזעקות ויומני האירועים מיוצאים ל-Cloud Logging. אחר כך תוכלו להשתמש במדיניות התראות כדי לשלוח התראות והודעות כשמתרחש אירוע ברשת.

לפני שמתחילים

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

שעונים מעוררים ב-AppNeta

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

לדוגמה, אם זמן האחזור עולה על 160 אלפיות השנייה פעמיים תוך 3 דקות, אפשר להגדיר את ההתראה כך שתפעיל אזהרה. ההתראה הזו נשלחת אל Google Cloud כיומן. אחרי שהיומן מגיע ל-Cloud Logging, אפשר לשלוח התראה לגביו ולעדכן את הצוות.

מידע נוסף על התראות זמין במאמרים Alarms Overview (סקירה כללית על התראות) או Alarms – Best Practices (התראות – שיטות מומלצות) במסמכי התיעוד של AppNeta.

יצירת כללי התראה ב-AppNeta

יוצרים כללי התראה שמגדירים ספי ביצועים.

1. פותחים את מסוף Google Cloud ועוברים אל Network Intelligence > Cloud Network Insights > Alert Policies.

   מעבר למדיניות ההתראות

2. לוחצים על Create Alarm Rules (יצירת כללי התראה) כדי לפתוח את הדף Alarm Rule Edit (עריכת כללי התראה) ב-AppNeta.

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

אחרי שההתראה מופעלת, יומן ההתראות נשלח אל Cloud Logging. אחרי שהיומן נשלח אל Google Cloud, אפשר לעבור אל Cloud Network Insights ולהגדיר את כללי ההתראה.

מידע נוסף על יצירת כללי התראה זמין במאמר בנושא כללי התראה בתיעוד של AppNeta.

צפייה ביומנים ב- Google Cloud

Cloud Network Insights מייצאות יומנים מפורטים ב-Cloud Logging כדי לעזור לכם לנתח את ביצועי הרשת ואירועים משמעותיים ולפתור בעיות. אפשר לגשת ליומנים האלה באמצעות Log Explorer.

1. נכנסים לדף Logs Explorer במסוף Google Cloud .

   כניסה לדף Logs Explorer

2. יצירת שאילתות כדי לקבל התראות על מידע רלוונטי.

יומנים של Cloud Network Insights משתמשים באחד מהערכים הבאים בשדה logName:

• יומני התראות – networkmanagement.googleapis.com/insights_alarm
• יומני אירועים - networkmanagement.googleapis.com/insights_event

מידע נוסף זמין במאמר בנושא יצירה ושמירה של שאילתות באמצעות שפת השאילתות של Logging.

תמחור

כל היומנים של Cloud Network Insights נכתבים ב-Cloud Logging. אין חיוב נפרד על השירות הזה מ-Cloud Network Insights. עם זאת, ייתכן שהיומנים האלה יובילו לעלויות אחסון נוספות, בהתאם לגודל היומנים שנכתבים ונשמרים.

למידע על התמחור של Cloud Logging, ראו תמחור של Google Cloud Observability: ‏Cloud Logging.

הפרטים ביומן

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

יומני התראות

• שם היומן: networkmanagement.googleapis.com/insights_alarm
• מופעל: נוצר כשמתקיימים התנאים של כלל התראה.
• תוויות משאבים: תיאור של המשאב במעקב שמשויך ליומן. הם כוללים את הפעולות הבאות:
  • ‫type – סוג המשאב, יכול להיות אחת מהאפשרויות הבאות:
    • networkmanagement.googleapis.com/NetworkMonitoringProvider
    • networkmanagement.googleapis.com/MonitoringPoint
    • networkmanagement.googleapis.com/NetworkPath
  • ‫labels – זוגות של מפתח וערך שמזהים את מופע המשאב הספציפי, כמו resource_container (מזהה הפרויקט), location,‏ network_monitoring_provider_id ו-path_id או monitoring_point_id.
• שדות JSON מרכזיים: יומני האזעקות מספקים מידע על אזעקות שהופעלו.
• מיפוי רמת החומרה: רמת החומרה נרשמת באופן שונה ב-AppNeta וב- Google Cloud.

  חומרת הבעיה ב-AppNeta	רמת החומרה של יומן Google Cloud
  קריטית	CRITICAL
  מקצוע ראשי	שגיאה
  משנית	אזהרה
  אזהרה	הודעה

שדות ביומן ההתראות

היומן jsonPayload של אזעקה מכיל את השדות הבאים.

שדה	סוג	תיאור
alarm_id	מחרוזת	המזהה הייחודי של ההתראה ב-AppNeta.
alarm_severity	enum	רמת החומרה של ההתראה. יכול להיות CRITICAL, MAJOR, MINOR או WARNING.
alarm_type	enum	סוג ההתראה. יש תמיכה בסוג QUALITY_OF_SERVICE.
cleared_time	חותמת זמן	השעה שבה ההתראה הוסרה. השדה הזה יהיה ריק אם ביומן ההתראות מופיע המצב RAISED או UPDATED.
description	מחרוזת	תיאור של ההתראה שכתוב בצורה שקריאה לאנשים.
first_violation_time	חותמת זמן	השעה שבה הופר תנאי ההתראה בפעם הראשונה.
item	אובייקט	הישות שמשויכת לאזעקה. פרטים נוספים זמינים במאמר בנושא מבני פריטים נפוצים.
provider_link	מחרוזת	היפר-קישור לאזעקה בממשק המשתמש של AppNeta.
raised_time	חותמת זמן	השעה שבה ההתראה הופעלה.
receiveTimestamp	מחרוזת	השעה שבה נוצר השעון המעורר Google Cloud.
rule	מחרוזת	השם של כלל ההתראה שהפעיל את ההתראה.
state	enum	המצב של השעון המעורר. יכול להיות RAISED,‏ UPDATED (פרטי ההתראה עודכנו ב-AppNeta אבל עדיין לא נמחקו) או CLEARED.
timestamp	מחרוזת	השעה שבה נוצרה ההתראה ב-AppNeta.

יומני אירועים

• שם היומן: networkmanagement.googleapis.com/insights_event
• טריגר: נוצר כשמתרחש שינוי מבני (לדוגמה, Route Change, MTU Change או Monitoring Point Offline).
• רמת החומרה: תמיד INFO.
• שדות JSON מרכזיים: יומני האירועים מספקים מידע על אירועים שהופעלו.

שדות ביומן האירועים

החלק jsonPayload של יומן אירועים מכיל את השדות הבאים.

שדה	סוג	תיאור
event_detail	אובייקט	פרטים ספציפיים לסוג האירוע. הערך יכול להיות route_change_event, mtu_change_event או qos_change_event. עבור אירועים שאין לגביהם פרטים נוספים, יוחזר אובייקט ריק. פרטים נוספים מופיעים במאמר בנושא שדות פרטי האירוע.
event_id	מחרוזת	המזהה הייחודי של האירוע.
event_type	enum	סוג האירוע. הערך יכול להיות MONITORING_POINT_OFFLINE, MONITORING_POINT_ONLINE, ROUTE_CHANGE, MTU_CHANGE או QOS_CHANGE.
item	אובייקט	הישות שמשויכת לאירוע. פרטים נוספים זמינים במאמר בנושא מבנים נפוצים של פריטים.
receiveTimestamp	מחרוזת	השעה שבה האירוע נוצר ב Google Cloud.
timestamp	מחרוזת	השעה שבה האירוע נוצר ב-AppNeta.

שדות של פרטי האירוע

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

• mtu_change_event
• qos_change_event
• route_change_event

אם אין פרטים נוספים על האירוע, מוחזר אובייקט ריק.

אירוע שינוי MTU (mtu_change_event)

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

שדה	סוג	תיאור
new_mtu	int32	ערך ה-MTU שנמדד לאחרונה.
previous_mtu	int32	ערך ה-MTU הקודם, אם היה כזה (לא מופיע בהפעלה).

אירוע שינוי QoS (qos_change_event)

האובייקט הזה מדווח על מיפוי מחדש של QoS בכל הנתיבים שזוהו.

שדה	סוג	תיאור
configured_qos	int32	ה-QoS שהוגדר בהגדרות המשימה.
remapped_qos	int32	זוהה שינוי באיכות השירות (QoS) בנתיב.
ip_address	מחרוזת	כתובת ה-IP של הצעד שבו זוהה שינוי ב-QoS, אם ידועה.

אירוע של שינוי מסלול (route_change_event)

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

שדה	סוג	תיאור
previous_route_change_time	חותמת זמן	חותמת הזמן של ה-traceroute שזיהה לראשונה את המסלול הקודם.
protocol	מחרוזת	הפרוטוקול שבו נעשה שימוש ב-traceroute (למשל TCP, UDP ו-ICMP).
hop_count	int32	מספר הקפיצות הכולל בנתיב.
target_ip	מחרוזת	כתובת ה-IP של היעד של ה-traceroute.
route_changes	מערך של אובייקטים	מערך של כל השינויים שזוהו. כל אובייקט מכיל מחרוזת route_change_type ואובייקט details. פרטים על שינוי נתיב

פרטי שינוי המסלול

האובייקט details בתוך המערך route_changes תלוי בroute_change_type:

• ‫incomplete_route או complete_route
  • ‫terminal_hop (אובייקט הצעד): הצעד האחרון שהושג בהצלחה (או הצעד הסופי אם התהליך הושלם).
  • ‫terminal_network (אובייקט רשת): פרטי הרשת של הצעד האחרון במסלול של הטרמינל.
• route_loop
  • ‫first_hop (hop object): הקפיצה הראשונה בלולאת המסלול שזוהתה.
  • ‫last_hop (hop object): הקפיצה האחרונה בלולאת המסלול שזוהתה.
  • ‫loop_span (int32): מספר הקפיצות שנדרשו כדי להגיע ללולאה.
• target_ip_change
  • ‫previous_target_ip (מחרוזת): כתובת ה-IP של היעד שנצפתה ב-traceroute הקודם.
  • ‫new_target_ip (string): כתובת ה-IP הנוכחית של היעד.
• sequence_change
  • ‫last_common_hop (אובייקט hop): ה-hop המשותף האחרון בין ה-traceroute הקודם לבין ה-traceroute הנוכחי.
  • ‫previous_next_hop (hop object): המכשיר הקודם ברצף.
  • ‫new_next_hop (אובייקט של הצעד הבא): המכשיר החדש של הצעד הבא ברצף.
  • ‫previous_hop_count (int32): המספר הכולל של קפיצות ב-traceroute הקודם.
  • ‫hop_count (int32): המספר הכולל של קפיצות ב-traceroute הנוכחי.
• network_change
  • ‫previous_asns (מערך של int32): רצף של רשת ASN עבור הנתיב.
  • ‫new_asns (מערך של int32): הרצף החדש של רשת ASN עבור הנתיב.
• isp_change
  • ‫previous_isp (אובייקט רשת): ספק האינטרנט שנצפה ב-traceroute הקודם.
  • ‫new_isp (אובייקט רשת): ספק האינטרנט הנוכחי שנצפה.

אובייקטים משניים נפוצים

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

Hop

אובייקטים של צעד מתארים צעד ספציפי ברשת.

שדה	סוג	תיאור
hop_number	int32	מספר הקפיצות ב-traceroute.
ip_address	מחרוזת	כתובת ה-IP של הצעד.
hostname	מחרוזת	שם המארח שפוענח עבור כתובת ה-IP של הקפיצה.

רשת

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

שדה	סוג	תיאור
asn	int32	מספר המערכת האוטונומית (ASN) של הרשת.
display_name	מחרוזת	שם הרשת (למשל, שם ספק האינטרנט או שם הארגון).

מבנים נפוצים של פריטים

השדה item ביומני jsonPayload Alarm ו-Event מכיל פרטים על הישות המשויכת. המבנה תלוי בסוג הפריט.

NetworkPathItem

שדה	סוג	תיאור
destination	מחרוזת	כתובת ה-IP או שם המארח של היעד.
destination_monitoring_point	MonitoringPointItem	פרטים של יעד MonitoringPointItem (רק עבור נתיבים מ-MonitoringPoint ל-MonitoringPoint).
display_name	מחרוזת	השם לתצוגה שהמשתמש הגדיר לנתיב ברשת.
monitoring_policy_display_name	מחרוזת	השם המוצג של מדיניות המעקב.
monitoring_policy_id	מחרוזת	המזהה של מדיניות המעקב.
network_protocol	מחרוזת	פרוטוקול הרשת שבו נעשה שימוש, כמו TCP, ‏UDP או ICMP.
provider_tags	מערך של אובייקטים	תגים שהוגדרו ב-AppNeta עבור הנתיב.
source_monitoring_point	MonitoringPointItem	פרטים של MonitoringPointItem המקור.

WebPathItem

שדה	סוג	תיאור
destination	מחרוזת	כתובת היעד.
display_name	מחרוזת	השם לתצוגה שהמשתמש נתן לנתיב באתר.
monitoring_policy_display_name	מחרוזת	השם המוצג של מדיניות המעקב.
monitoring_policy_id	מחרוזת	המזהה של מדיניות המעקב.
provider_tags	מערך	תגים שמוגדרים בספק עבור הנתיב.
source_monitoring_point	אובייקט	פרטים של נקודת המעקב של המקור.

MonitoringPointItem

שדה	סוג	תיאור
display_name	מחרוזת	השם המוצג שהמשתמש הגדיר לנקודת הבקרה.
host	אובייקט	פרטים על המארח של נקודת המעקב.
id	מחרוזת	המזהה הייחודי של נקודת הבקרה.
provider_tags	מערך	תגים שמוגדרים בספק לנקודת המעקב.

MonitoringPointHost

שדה	סוג	תיאור
cloud_instance_id	מחרוזת	מזהה המופע מספק שירותי הענן.
cloud_project_id	מחרוזת	מזהה הפרויקט Google Cloud .
cloud_provider	מחרוזת	ספק שירותי ענן כמו GCP,‏ AWS או AZURE.
cloud_region	מחרוזת	האזור ב-Cloud של נקודת הקצה, לדוגמה, us-central1.
cloud_virtual_network_ids	מערך של מחרוזות	מזהים של רשתות וירטואליות בענן שגלויים למשתמשים.
cloud_zone	מחרוזת	האזור ב-Cloud של נקודת הקצה, לדוגמה, us-central1-a.
labels	מפה	תוויות שהוגדרו על ידי המשתמש ומוגדרות במופע של מכונה וירטואלית.
os	מחרוזת	מערכת ההפעלה של המארח של נקודת הניטור.