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

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

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

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

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

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

התראות ב-AppNeta

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

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

למידע נוסף על התראות, קראו את המאמרים Alarms Overview ו-Alarms – Best Practices במסמכי התיעוד של AppNeta.

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

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

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

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

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

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

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

למידע נוסף על יצירת כללי התראות, קראו את המאמר Alarm Rules במסמכי התיעוד של AppNeta.

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

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

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

    כניסה לדף Logs Explorer

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

ביומנים של Cloud Network Insights נעשה שימוש באחד ממזהי היומנים הבאים:

  • יומני התראות: 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/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
      • networkmanagement.googleapis.com/WebPath
    • ‫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_reason מחרוזת הסיבה לכך שההתראה בוטלה. נוצר רק כאשר state = "CLEARED" (אחרת מושמט או null). ערכי מחרוזת נפוצים כוללים את alarm-rule-no-longer-violated,‏ stale,‏ rule-deleted ו-duplicate.
cleared_time חותמת זמן השעה שבה ההתראה הוסרה. השדה הזה יהיה ריק אם יומן ההתראות נמצא במצב RAISED או UPDATED.
description מחרוזת תיאור קריא לאנשים של ההתראה.
first_violation_time חותמת זמן השעה שבה תנאי ההתראה הופר בפעם הראשונה.
item אובייקט הישות שמשויכת להתראה. פרטים נוספים זמינים במאמר מבנים נפוצים של פריטים.
noise_conditions מערך של מחרוזות מזהה אילו תנאי סינון רעשים סימנו את ההתראה הזו עבור הכלל והפריט הנתונים. ההתראות נבדקות גם לפי סף תדירות של 24 שעות וגם לפי חלון זמן קצר של התפרצות.

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

  • ‫frequent-detection: מופעל כשמספר ההתראות על אותו פריט מגיע לסף של 24 שעות (ברירת המחדל: 5 התראות).
  • ‫burst-detection: מופעלת כשמתרחשות כמה התראות בחלון הזמן שהוגדר (ברירת המחדל: יותר מהתראה אחת בכל 60 דקות).

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

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 או forwarding_loss_clear_event. אם אין פרטים נוספים על האירוע, יוחזר אובייקט ריק. פרטים נוספים זמינים בקטע שדות של פרטי אירועים.
event_id מחרוזת המזהה הייחודי של האירוע הזה.
event_type טיפוסים בני מנייה (enum) סוג האירוע. הערכים האפשריים: MONITORING_POINT_OFFLINE, MONITORING_POINT_ONLINE, ROUTE_CHANGE, MTU_CHANGE, QOS_CHANGE או FORWARDING_LOSS_CLEAR.
item אובייקט הישות שמשויכת לאירוע. פרטים נוספים זמינים במאמר מבנים נפוצים של פריטים.
receiveTimestamp מחרוזת השעה שבה האירוע נוצר ב- Google Cloud.
timestamp מחרוזת השעה שבה האירוע נוצר ב-AppNeta.

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

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

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

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

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

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

אירוע של שינוי ב-QoS‏ (qos_change_event)

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

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

אירוע של ניקוי אובדן העברה (forwarding_loss_clear_event)

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

שדה סוג תיאור
protocol מחרוזת פרוטוקול המעקב (למשל TCP,‏ UDP ו-ICMP).
first_hop אובייקט הצעד התחנה הראשונה שבה התחיל אובדן הנתונים בהעברה. פרטים נוספים זמינים במאמר Hop.
initial_loss_suspected_time חותמת זמן השעה שבה עלה החשד הראשוני לאובדן העברה.

אירוע של שינוי נתיב (route_change_event)

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

שדה סוג תיאור
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 (אובייקט דילוג): הדילוג הראשון בלולאת הניתוב שזוהתה.
    • ‫last_hop (אובייקט דילוג): הדילוג האחרון בלולאת הנתיב שזוהתה.
    • ‫loop_span (int32): מספר הדילוגים שמעורבים בלולאה.
  • target_ip_change
    • ‫previous_target_ip (מחרוזת): כתובת ה-IP של היעד שנצפתה ב-traceroute הקודם.
    • ‫new_target_ip (מחרוזת): כתובת ה-IP הנוכחית של היעד.
  • sequence_change
    • ‫last_common_hop (אובייקט דילוג): הדילוג המשותף האחרון בין ה-traceroutes הקודם והנוכחי.
    • ‫previous_next_hop (אובייקט הצעד): המכשיר הקודם ברצף הצעדים הבאים.
    • ‫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 של יומני ההתראות ויומני האירועים מכיל פרטים על הישות המשויכת. המבנה תלוי בסוג הפריט.

NetworkPathItem

שדה סוג תיאור
destination מחרוזת כתובת ה-IP או שם המארח של היעד.
destination_monitoring_point MonitoringPointItem פרטים של MonitoringPointItem היעד (לנתיבים מסוג MonitoringPoint-to-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 אובייקט פרטי נקודת המעקב (MonitoringPoint) של המקור.

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 מחרוזת האזור בענן של נקודת הקצה, לדוגמה us-central1-a.
labels מפה תוויות שהוגדרו על ידי המשתמש במכונה הווירטואלית.
os מחרוזת מערכת ההפעלה של המארח של נקודת המעקב.