הגדרה של VPC Flow Logs
בדף הזה מוסבר איך להגדיר את VPC Flow Logs. ההנחה היא שאתם מכירים את המושגים שמתוארים במאמרים VPC Flow Logs ו-About VPC Flow Logs records.
לפני שמתחילים
מגדירים לפחות אחד מהערכים הבאים:
מומלץ: Network Management API מאפשר להגדיר יומנים לתיעוד מידע על תעבורת ה-IP של ענן וירטואלי פרטי (VPC) לארגונים, רשתות ענן וירטואלי פרטי (VPC), רשתות משנה, קבצים מצורפים של VLAN ל-Cloud Interconnect ומנהרות Cloud VPN. כדי להשתמש ב-Network Management API:
מפעילים את Network Management API בפרויקט. Google Cloud
חשוב לוודא שהוקצה לכם תפקיד האדמין לניהול רשת (
roles/networkmanagement.admin), באופן הבא:- ברמת הארגון (נדרש אם רוצים להגדיר יומני VPC Flow Logs לארגון)
- ברמת הפרויקט (נדרש אם רוצים להגדיר יומני זרימה של VPC לרשת VPC, לרשת משנה, לצירוף ל-VLAN או למנהרת Cloud VPN)
בנוסף, אם רוצים להגדיר VPC Flow Logs לארגון, צריך לוודא שיש לכם את ההרשאה
resourcemanager.organizations.get.
באמצעות Compute Engine API אפשר להגדיר יומני זרימה של VPC רק לרשתות משנה. אי אפשר לנהל באמצעות Network Management API הגדרות שנוצרו באמצעות Compute Engine API. כדי להשתמש ב-Compute Engine API, צריך לבצע את הפעולות הבאות:
מפעילים את Compute Engine API ב Google Cloud פרויקט.
צריך לוודא שיש לכם את אחד מהתפקידים הבאים בפרויקט:
- תפקיד אדמין ב-Compute (
roles/compute.admin) - התפקיד Compute Network Admin (
roles/compute.networkAdmin)
- תפקיד אדמין ב-Compute (
מידע נוסף על ממשקי ה-API שבהם אפשר להשתמש כדי להפעיל את VPC Flow Logs עבור רשתות משנה זמין במאמר בחירת שיטה להפעלת VPC Flow Logs עבור רשת משנה.
הגדרת Google Cloud CLI
אם אתם לא מתכננים להשתמש ב-CLI של gcloud כדי להגדיר את יומני הזרימה של VPC, אתם יכולים לדלג על השלב הזה.
מפעילים את Cloud Shell במסוף Google Cloud .
בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
הפעלת יומני זרימה של VPC
כדי להפעיל את VPC Flow Logs למשאב, צריך ליצור הגדרה של VPC Flow Logs. VPC Flow Logs מאפשר ליצור הגדרות ברמת הארגון והפרויקט:
- הגדרה ברמת הארגון מפעילה את יומני הזרימה בכל רשתות המשנה, צירופים ל-VLAN ומנהרות Cloud VPN בכל רשתות ה-VPC בארגון.
- הגדרה ברמת הפרויקט מאפשרת להפעיל יומני תנועה למשאבים הבאים:
- רשת VPC ספציפית, שכוללת את כל רשתות המשנה, חיבורי ה-VLAN ומנהרות Cloud VPN ברשת
- רשת משנה ספציפית, צירוף ל-VLAN או מנהרת Cloud VPN
אפשר להוסיף יותר מהגדרה אחת של יומני זרימה של VPC לכל משאב. כל הגדרה יוצרת קבוצה נפרדת של יומני זרימה. אם משייכים משאב לכמה הגדרות של יומני תעבורה ב-VPC וההיקף שלהן חופף, יכול להיות שפרטי הרישום ביומן יכללו יומנים כפולים.
אפשר גם לשנות את כמות המידע שנכתב ביומן הרישום. למידע נוסף על הפרמטרים שאפשר לשלוט בהם, קראו את המאמר דגימה ועיבוד של יומנים.
הפעלת VPC Flow Logs עבור רשת משנה
כשמפעילים את VPC Flow Logs לתת-רשת, מפעילים את הרישום ביומן לכל המכונות הווירטואליות בתת-הרשת.
איך מפעילים את VPC Flow Logs עבור רשת משנה
אתם יכולים להשתמש ב-Network Management API או ב-Compute Engine API כדי להפעיל את יומני התנועה של VPC עבור רשתות משנה. מכיוון שממשק Network Management API מציע יותר אפשרויות להפעלת יומני תעבורה של VPC, מומלץ להשתמש בו.
Network Management API מספק תכונות דומות ל-Compute Engine API – כל האפשרויות להגדרת יומני זרימת תנועה ב-VPC עבור רשתות משנה שזמינות ב-Compute Engine API נתמכות ב-Network Management API. בנוסף, Network Management API תומך ברישום ביומן של חיבורי TCP, שלא נתמך ב-Compute Engine API.
אם יש לכם הגדרות קיימות של יומני זרימה של VPC שמנוהלות על ידי Compute Engine API, כדאי להביא בחשבון את הדברים הבאים:
- כדי להעביר את ההגדרות ל-Network Management API, אתם יכולים להשתמש באחת מהשיטות הבאות:
- אתם יכולים ליצור עותק של ההגדרות של יומני התנועה ב-VPC באמצעות Network Management API, ואז למחוק את ההגדרות המקוריות. מידע נוסף זמין במאמרים הפעלה של יומני VPC Flow Logs לרשת משנה (Network Management API) והשבתה של יומני VPC Flow Logs לרשת משנה.
- כדי לפשט את ניהול ההגדרות של יומני התנועה של VPC, אפשר לאחד את ההגדרות הקיימות שמנוהלות על ידי Compute Engine API. לדוגמה, במקום ליצור הגדרה נפרדת לכל תת-רשת, אפשר ליצור הגדרה לרשת ה-VPC או לארגון שמכילים את תת-הרשתות, ואז למחוק את ההגדרות המקוריות. מידע נוסף זמין במאמר הגדרות נתמכות.
- בניגוד ל-Compute Engine API, Network Management API לא מגדיר את השדות
enableFlowLogsאוlogConfig.enableעבור רשתות משנה. אם אתם משתמשים בכלים של צד שלישי שתלויים בשדות האלה, אתם יכולים לבצע אחת מהפעולות הבאות:- כדי לראות את כל ההגדרות של רשת משנה ספציפית, משתמשים בשיטה
showEffectiveFlowLogsConfigsשל Network Management API. מידע נוסף זמין בקטע הצגת כל ההגדרות של משאב בכרטיסייה API. - ממשיכים להשתמש ב-Compute Engine API כדי להגדיר את יומני הזרימה של VPC לרשתות משנה, כמו שמתואר במאמר הפעלת יומני זרימה של VPC לרשת משנה (Compute Engine API).
- כדי לראות את כל ההגדרות של רשת משנה ספציפית, משתמשים בשיטה
הפעלת VPC Flow Logs עבור רשת משנה (Network Management API)
בקטע הזה מוסבר איך להפעיל את יומני התנועה של VPC עבור רשת משנה באמצעות Network Management API (מומלץ).
המסוף
נכנסים לדף VPC networks במסוף Google Cloud .
בכרטיסייה Subnets in current project, בוחרים רשת משנה אחת או יותר ולוחצים על Manage flow logs.
בManage flow logs (ניהול יומני תעבורה), לוחצים על Add new configuration (הוספת הגדרה חדשה).
מבצעים אחת מהפעולות הבאות:
- אם בחרתם תת-רשת אחת, בקטע Configurations — Subnets (הגדרות – תת-רשתות), לוחצים על Add a configuration (הוספת הגדרה).
- אם בחרתם כמה רשתות משנה, בקטע Configure VPC Flow Logs בוחרים באפשרות Network Management API.
בשדה Name (שם), מזינים שם להגדרת VPC Flow Logs החדשה.
אופציונלי: משנים את מרווח הצבירה ואת ההגדרות בקטע הגדרות מתקדמות:
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות הסופיות ביומן. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- האם להפעיל רישום ביומן של חיבורי TCP. כברירת מחדל, האפשרות רישום ביומן של חיבורים לא מסומנת. אם בוחרים באפשרות הזו, יומני הזרימה של VPC מתעדים אירועי חיבור של תעבורת נתונים ב-TCP ממכונות וירטואליות ומנקודות קצה ללא שרת (serverless) ואליהן. מידע נוסף זמין במאמר רישום ביומן של חיבורי TCP.
- תדירות הדגימה המשנית.
100%– כל הרשומות שנוצרו על ידי תהליך הדגימה הראשי של יומן תעבורת הנתונים נשמרות. אי אפשר להגדיר את תדירות הדגימה של יומן הזרימה הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
לוחצים על Save.
gcloud
כדי להפעיל את התכונה VPC Flow Logs עבור רשת משנה, משתמשים בפקודה gcloud network-management vpc-flow-logs-configs create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרה עם כל הפרמטרים שלה שמוגדרים לערכי ברירת המחדל, או להתאים אישית את ערכי ברירת המחדל.
ב-CLI של gcloud, מגדירים את הפרויקט למזהה הפרויקט של רשת המשנה ( Google Cloud ) ומריצים אחת מהפקודות הבאות:
כדי ליצור הגדרת ברירת מחדל של יומני זרימה של VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --subnet=SUBNETכדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את פרמטרים של מרווח הצבירה, הסינון, קצב הדגימה המשני, המטא-נתונים והרישום ביומן של החיבור כשיוצרים הגדרה של יומני תנועה ב-VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --subnet=SUBNET \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA \ --connection-logging=CONNECTION_LOGGINGמחליפים את מה שכתוב בשדות הבאים:
CONFIG_NAME: שם להגדרה.-
SUBNET: רשת המשנה שרוצים לתעד ביומן. צריך לציין את הערך בפורמט הבא:"projects/PROJECT_ID/regions/REGION/subnetworks/NAME", כאשר:-
PROJECT_IDהוא המזהה של Google Cloud הפרויקט שמכיל את רשת המשנה. צריך ליצור את ההגדרה בפרויקט הזה. -
REGIONהוא האזור של תת-הרשת. -
NAMEהוא שם רשת המשנה.
-
כדי להגדיר את הפרמטרים האופציונליים בהגדרה מותאמת אישית, מחליפים את הערכים הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכים הבאים:interval-5-sec(ברירת מחדל),interval-30-sec,interval-1-min,interval-5-min,interval-10-minאוinterval-15-min. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמרים סינון יומנים ודוגמאות למסנני יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- משתמשים ב-
include-all-metadataכדי לכלול את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
exclude-all-metadataכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
custom-metadataכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בדגל--metadata-fields:-
--metadata-fields=METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה:src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאcustom-metadata.
-
- משתמשים ב-
-
CONNECTION_LOGGING: רישום ביומן של חיבורי TCP. אפשר להגדיר את הערךenabledאוdisabled(ברירת מחדל). מידע נוסף זמין במאמר רישום ביומן של חיבורי TCP.
API
כדי להפעיל יומני VPC Flow Logs ברשת משנה, משתמשים בשיטה projects.locations.vpcFlowLogsConfigs.create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרה עם כל הפרמטרים שלה שמוגדרים לערכי ברירת המחדל, או להתאים אישית את ערכי ברירת המחדל.
כדי ליצור הגדרת ברירת מחדל של יומני זרימה של VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"subnet": "SUBNET"
}
כדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, קצב הדגימה המשני, המטא-נתונים ופרמטרים של רישום ביומן החיבורים כשיוצרים הגדרה של יומני תנועה ב-VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"subnet": "SUBNET",
"aggregationInterval": "AGGREGATION_INTERVAL",
"filterExpr": "FILTER_EXPRESSION",
"flowSampling": SAMPLING_RATE,
"metadata": "LOGGING_METADATA",
"connectionLogging": "CONNECTION_LOGGING"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud של רשת המשנה. -
CONFIG_NAME: שם להגדרות האישיות. -
SUBNET: תת-הרשת שרוצים לרשום ביומן. צריך לציין את הערך בפורמט הבא:projects/PROJECT_ID/regions/REGION/subnetworks/NAME, כאשר:-
PROJECT_IDהוא מזהה הפרויקט של רשת המשנה. -
REGIONהוא האזור של תת-הרשת. -
NAMEהוא שם רשת המשנה.
-
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכיםINTERVAL_5_SEC(ברירת מחדל),INTERVAL_30_SEC,INTERVAL_1_MIN,INTERVAL_5_MIN,INTERVAL_10_MINאוINTERVAL_15_MIN. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמר בנושא סינון יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
INCLUDE_ALL_METADATA. - משתמשים ב-
EXCLUDE_ALL_METADATAכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
CUSTOM_METADATAכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בפרמטרmetadataFields:-
metadataFields: METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאCUSTOM_METADATA.
-
- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
-
CONNECTION_LOGGING: רישום ביומן של חיבור TCP. אפשר להגדיר את הערךENABLEDאוDISABLED(ברירת מחדל). מידע נוסף זמין במאמר בנושא רישום ביומן של חיבורי TCP.
הפעלה של יומני זרימה של VPC עבור רשת משנה (Compute Engine API)
בקטע הזה מוסבר איך להפעיל את יומני הזרימה של VPC ברשת משנה באמצעות Compute Engine API. מומלץ להפעיל את יומני הזרימה של VPC עבור רשת משנה באמצעות Network Management API.
אפשר להפעיל את היומנים של תנועת הנתונים ב-VPC כשיוצרים תת-רשת או עבור תת-רשת קיימת.
הפעלת VPC Flow Logs כשיוצרים רשת משנה
המסוף
נכנסים לדף VPC networks במסוף Google Cloud .
לוחצים על הרשת שרוצים להוסיף לה רשת משנה.
לוחצים על הוספת רשת משנה.
בקטע יומני תנועה, בוחרים באפשרות מופעל.
אופציונלי: משנים את מרווח הצבירה ואת ההגדרות הבאות בקטע הגדרות מתקדמות:
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות היומן הסופיות. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- תדירות הדגימה המשנית.
50%פירושו שחצי מהרשומות שנוצרו על ידי תהליך הדגימה של יומן התנועה הראשי נשמרות. אי אפשר להגדיר את תדירות הדגימה של יומן הזרימה הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
אם צריך, ממלאים את שאר השדות.
לוחצים על הוספה.
gcloud
מריצים את הפקודה הבאה:
gcloud compute networks subnets create SUBNET_NAME \
--enable-flow-logs \
[--logging-aggregation-interval=AGGREGATION_INTERVAL] \
[--logging-flow-sampling=SAMPLING_RATE] \
[--logging-filter-expr=FILTER_EXPRESSION] \
[--logging-metadata=LOGGING_METADATA] \
[--logging-metadata-fields=METADATA_FIELDS] \
[other flags as needed]
מחליפים את מה שכתוב בשדות הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה ברשת המשנה הזו. אפשר להגדיר את המרווח לאחת מהאפשרויות הבאות: 5 שניות (ברירת המחדל), 30 שניות, דקה, 5 דקות, 10 דקות או 15 דקות. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר דגימת תעבורת נתונים משנית מ-0.0(ללא דגימה) עד1.0(כל היומנים). ברירת המחדל היא0.5. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמרים בנושא סינון יומנים ודוגמאות למסנני יומנים.
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים, משתמשים ב-
include-all. - משתמשים בערך
exclude-allכדי להחריג את כל ההערות של המטא-נתונים (ברירת המחדל). - משתמשים ב-
customכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים שציינתם ב-METADATA_FIELDS.
- כדי לכלול את כל הערות המטא-נתונים, משתמשים ב-
METADATA_FIELDS: רשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלLOGGING_METADATAהיאcustom.
API
מפעילים את VPC Flow Logs כשיוצרים רשת משנה חדשה.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
{
"logConfig": {
"aggregationInterval": "AGGREGATION_INTERVAL",
"flowSampling": SAMPLING_RATE,
"filterExpr": EXPRESSION,
"metadata": METADATA_SETTING,
"metadataFields": METADATA_FIELDS,
"enable": true
},
"ipCidrRange": "IP_RANGE",
"network": "NETWORK_URL",
"name": "SUBNET_NAME"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט שבו תיצור רשת המשנה. -
REGION: האזור שבו תיווצר רשת המשנה. -
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה ברשת המשנה. אפשר להגדיר את האינטרוול לאחת מהאפשרויות הבאות:INTERVAL_5_SEC,INTERVAL_30_SEC,INTERVAL_1_MIN,INTERVAL_5_MIN,INTERVAL_10_MINאוINTERVAL_15_MIN. -
SAMPLING_RATE: תדירות הדגימה של הזרימה. אפשר להגדיר את דגימת התנועה מ-0.0(ללא דגימה) עד1.0(כל היומנים). ברירת המחדל היא.0.5. -
EXPRESSION: ביטוי הסינון שמשמש לסינון היומנים שנכתבים בפועל. האורך של הביטוי מוגבל ל-2,048 תווים. פרטים נוספים מופיעים במאמר בנושא סינון יומנים.
METADATA_SETTING: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל ההערות של המטא-נתונים, משתמשים ב-
INCLUDE_ALL_METADATA. - משתמשים בערך
EXCLUDE_ALL_METADATAכדי להחריג את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
CUSTOM_METADATAכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים שצוינו ב-METADATA_FIELDS.
- כדי לכלול את כל ההערות של המטא-נתונים, משתמשים ב-
METADATA_FIELDS: שדות המטא-נתונים שרוצים לתעד כשהגדרתם אתmetadata: CUSTOM_METADATA. זו רשימה מופרדת בפסיקים של שדות מטא-נתונים, כמוsrc_instance, src_vpc.project_id.
IP_RANGE: טווח כתובות ה-IP הפנימיות הראשי של רשת המשנה.
NETWORK_URL: כתובת ה-URL של רשת הענן הווירטואלי הפרטי (VPC) שבה תיווצר התת-רשת.
SUBNET_NAME: שם לתת-הרשת.
למידע נוסף, עיינו בשיטה subnetworks.insert.
Terraform
אתם יכולים להשתמש במודול Terraform כדי ליצור רשת VPC במצב מותאם אישית ורשתות משנה.
בדוגמה הבאה נוצרות שלוש רשתות משנה:
subnet-01השבית את יומני הזרימה של VPC. כשיוצרים תת-רשת, האפשרות 'VPC Flow Logs' מושבתת אלא אם מפעילים אותה באופן מפורש.-
subnet-02מופעל עם VPC Flow Logs עם הגדרות ברירת המחדל של יומן הזרימה. subnet-03מופעל עם VPC Flow Logs עם כמה הגדרות מותאמות אישית.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
הפעלת יומני VPC Flow Logs ברשת משנה קיימת
המסוף
נכנסים לדף VPC networks במסוף Google Cloud .
בכרטיסייה Subnets in current project, בוחרים רשת משנה אחת או יותר ולוחצים על Manage flow logs.
בManage flow logs (ניהול יומני תעבורה), לוחצים על Add new configuration (הוספת הגדרה חדשה).
מבצעים אחת מהפעולות הבאות:
- אם בחרתם רשת משנה אחת, בקטע Configurations - Subnets (Compute Engine API) (הגדרות – רשתות משנה (Compute Engine API)), לוחצים על Add a configuration (הוספת הגדרה).
- אם בחרתם כמה רשתות משנה, בקטע Configure VPC Flow Logs (הגדרת יומני תנועה של VPC), בוחרים באפשרות Compute Engine API (Compute Engine API).
אופציונלי: משנים את מרווח הצבירה ואת ההגדרות הבאות בקטע הגדרות מתקדמות:
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות היומן הסופיות. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- תדירות הדגימה המשנית.
50%פירושו שחצי מהרשומות שנוצרו בתהליך הדגימה הראשי של יומני תנועת הנתונים נשמרות. אי אפשר להגדיר את קצב הדגימה של יומן זרימת הנתונים הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
לוחצים על Save.
gcloud
מריצים את הפקודה הבאה:
gcloud compute networks subnets update SUBNET_NAME \
--enable-flow-logs \
[--logging-aggregation-interval=AGGREGATION_INTERVAL] \
[--logging-flow-sampling=SAMPLING_RATE] \
[--logging-filter-expr=FILTER_EXPRESSION] \
[--logging-metadata=LOGGING_METADATA] \
[--logging-metadata-fields=METADATA_FIELDS] \
[other flags as needed]
מחליפים את מה שכתוב בשדות הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה ברשת המשנה הזו. אפשר להגדיר את המרווח לאחת מהאפשרויות הבאות: 5 שניות (ברירת המחדל), 30 שניות, דקה, 5 דקות, 10 דקות או 15 דקות. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הדגימה של זרימת הנתונים המשנית מ-0.0(ללא דגימה) עד1.0(כל היומנים). ברירת המחדל היא0.5. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמרים סינון יומנים ודוגמאות למסנני יומנים.
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים, משתמשים ב-
include-all. - משתמשים בערך
exclude-allכדי להחריג את כל ההערות של המטא-נתונים (ברירת המחדל). - משתמשים ב-
customכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים שציינתם ב-METADATA_FIELDS.
- כדי לכלול את כל הערות המטא-נתונים, משתמשים ב-
METADATA_FIELDS: רשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלLOGGING_METADATAהיאcustom.
API
הפעלת VPC Flow Logs עבור רשת משנה קיימת.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
{
"logConfig": {
"enable": true
...other logging fields.
},
"fingerprint": "SUBNET_FINGERPRINT"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט שבו נמצאת רשת המשנה. -
REGION: האזור שבו נמצאת רשת המשנה. -
SUBNET_NAME: השם של תת-הרשת הקיימת. -
SUBNET_FINGERPRINT: מזהה טביעת האצבע של תת-הרשת הקיימת, שמופיע כשמבצעים תיאור של תת-רשת. - למידע על שדות אחרים של רישום ביומן, אפשר לעיין במאמר הפעלת רישום ביומן של תעבורת VPC כשיוצרים רשת משנה.
למידע נוסף, עיינו בשיטה subnetworks.patch.
הפעלת יומני זרימה של VPC לצירוף ל-VLAN
המסוף
נכנסים לדף Interconnect במסוף Google Cloud .
בכרטיסייה VLAN attachments, בוחרים חיבור VLAN אחד או יותר ואז לוחצים על Manage flow logs בסרגל הבחירה בחלק העליון של הרשימה.
בקטע Manage flow logs, לוחצים על Add new configuration.
בשדה Name (שם), מזינים שם להגדרת VPC Flow Logs החדשה.
אופציונלי: משנים את מרווח הצבירה ואת ההגדרות בקטע הגדרות מתקדמות:
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות היומן הסופיות. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- תדירות הדגימה המשנית.
100%– כל הרשומות שנוצרו על ידי תהליך הדגימה הראשי של יומן תעבורת הנתונים נשמרות. אי אפשר להגדיר את קצב הדגימה של יומן זרימת הנתונים הראשי. מידע נוסף זמין במאמר דגימה ועיבוד של יומנים.
לוחצים על Save.
gcloud
כדי להפעיל יומני זרימה של VPC לצירוף ל-VLAN, משתמשים בפקודה gcloud network-management vpc-flow-logs-configs create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרות עם כל הפרמטרים שמוגדרים לערכי ברירת המחדל שלהם, או להתאים אישית את ערכי ברירת המחדל.
ב-CLI של gcloud, מגדירים את הפרויקט לGoogle Cloud מזהה הפרויקט של חיבור ה-VLAN ומריצים אחת מהפקודות הבאות:
כדי ליצור הגדרת ברירת מחדל ליומני זרימה של VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --interconnect-attachment=VLAN_ATTACHMENTכדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, קצב הדגימה המשני ופרמטרי המטא-נתונים כשיוצרים הגדרה של VPC Flow Logs, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --interconnect-attachment=VLAN_ATTACHMENT \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATAמחליפים את מה שכתוב בשדות הבאים:
CONFIG_NAME: שם להגדרה.-
VLAN_ATTACHMENT: הצירוף ל-VLAN שרוצים לתעד ביומן. צריך לציין את הערך בפורמט הבא:"projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME", כאשר:-
PROJECT_IDהוא המזהה של Google Cloud הפרויקט שמכיל את הצירוף ל-VLAN. צריך ליצור את ההגדרה בפרויקט הזה. -
REGIONהוא האזור של הצירוף ל-VLAN. -
NAMEהוא השם של הצירוף ל-VLAN.
-
כדי להגדיר את הפרמטרים האופציונליים בהגדרה מותאמת אישית, מחליפים את הערכים הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכים הבאים:interval-5-sec(ברירת מחדל),interval-30-sec,interval-1-min,interval-5-min,interval-10-minאוinterval-15-min. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף מופיע במאמרים בנושא סינון יומנים ודוגמאות למסנני יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). למידע נוסף, קראו את המאמר דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- משתמשים ב-
include-all-metadataכדי לכלול את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
exclude-all-metadataכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
custom-metadataכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בדגל--metadata-fields:-
--metadata-fields=METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה:src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאcustom-metadata.
-
- משתמשים ב-
Terraform
אתם יכולים להשתמש במודול של Terraform כדי ליצור הגדרה של יומני זרימה של VPC לצירוף ל-VLAN.
בלוק הקוד הבא יוצר הגדרת ברירת מחדל של יומני זרימה של VPC.
בדוגמה הקודמת, שם המשאב google_compute_interconnect_attachment הוא attachment. דוגמה מלאה להגדרה הזו מופיעה במאגר terraform-docs-samples.
בלוק הקוד הבא יוצר הגדרה של יומני זרימה של VPC, כאשר:
- מרווח הצבירה מוגדר ל-
INTERVAL_10_MIN. - תדירות הדגימה של הזרימה המשנית מוגדרת ל-
0.7. - המטא-נתונים שייכללו ביומנים מוגדרים לערך
INCLUDE_ALL_METADATA. - מצב ההגדרה הוא
ENABLED.
בדוגמה הקודמת, שם המשאב google_compute_interconnect_attachment הוא attachment. דוגמה מלאה להגדרה הזו מופיעה במאגר terraform-docs-samples.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
API
כדי להפעיל את VPC Flow Logs לצירוף ל-VLAN, משתמשים ב-method projects.locations.vpcFlowLogsConfigs.create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרות עם כל הפרמטרים שמוגדרים לערכי ברירת המחדל שלהם, או להתאים אישית את ערכי ברירת המחדל.
כדי ליצור הגדרת ברירת מחדל של יומני זרימה של VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"interconnectAttachment": "VLAN_ATTACHMENT"
}
כדי ליצור הגדרה מותאמת אישית של יומני VPC Flow, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, קצב הדגימה המשני ופרמטרים של מטא-נתונים כשיוצרים הגדרה של יומני תעבורה ב-VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"interconnectAttachment": "VLAN_ATTACHMENT",
"aggregationInterval": "AGGREGATION_INTERVAL",
"filterExpr": "FILTER_EXPRESSION",
"flowSampling": SAMPLING_RATE,
"metadata": "LOGGING_METADATA"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: Google Cloud מזהה הפרויקט של הצירוף ל-VLAN. CONFIG_NAME: שם להגדרה.-
VLAN_ATTACHMENT: הצירוף ל-VLAN שרוצים לרשום ביומן. צריך לציין את הערך בפורמט הבא:projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME, כאשר:-
PROJECT_IDהוא מזהה הפרויקט של הצירוף ל-VLAN. -
REGIONהוא האזור של הצירוף ל-VLAN. -
NAMEהוא שם הצירוף ל-VLAN.
-
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכיםINTERVAL_5_SEC(ברירת מחדל),INTERVAL_30_SEC,INTERVAL_1_MIN,INTERVAL_5_MIN,INTERVAL_10_MINאוINTERVAL_15_MIN. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמר בנושא סינון יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). למידע נוסף, קראו את המאמר דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
INCLUDE_ALL_METADATA. - משתמשים ב-
EXCLUDE_ALL_METADATAכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
CUSTOM_METADATAכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בפרמטרmetadataFields:-
metadataFields: METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את המדיניות הזו רק אם המדיניותmetadataמוגדרת לערךCUSTOM_METADATA.
-
- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
הפעלת יומני זרימה של VPC למנהרת VPN ב-Cloud
המסוף
נכנסים לדף VPN במסוף Google Cloud .
בכרטיסייה Cloud VPN tunnels, בוחרים מנהרת Cloud VPN אחת או יותר ואז לוחצים על Manage flow logs בסרגל הבחירה בחלק העליון של הרשימה.
בManage flow logs (ניהול יומני תעבורה), לוחצים על Add new configuration (הוספת הגדרה חדשה).
בשדה Name (שם), מזינים שם להגדרת VPC Flow Logs החדשה.
אופציונלי: משנים את מרווח הצבירה ואת ההגדרות בקטע הגדרות מתקדמות:
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות היומן הסופיות. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- תדירות הדגימה המשנית.
100%– כל הרשומות שנוצרו על ידי תהליך הדגימה הראשי של יומן תעבורת הנתונים נשמרות. אי אפשר להגדיר את קצב הדגימה של יומן זרימת הנתונים הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
לוחצים על Save.
gcloud
כדי להפעיל יומני זרימה של VPC למנהרת Cloud VPN, משתמשים בפקודה gcloud network-management vpc-flow-logs-configs create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרה עם כל הפרמטרים שלה שמוגדרים לערכי ברירת המחדל, או להתאים אישית את ערכי ברירת המחדל.
ב-CLI של gcloud, מגדירים את הפרויקט ל-Google Cloud מזהה הפרויקט של מנהרת Cloud VPN ומריצים אחת מהפקודות הבאות:
כדי ליצור הגדרת ברירת מחדל ליומני זרימה של VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --vpn-tunnel=VPN_TUNNELכדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, קצב הדגימה המשני ופרמטרי המטא-נתונים כשיוצרים הגדרה של VPC Flow Logs, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --vpn-tunnel=VPN_TUNNEL \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATAמחליפים את מה שכתוב בשדות הבאים:
-
CONFIG_NAME: שם להגדרות האישיות. -
VPN_TUNNEL: מנהרת Cloud VPN שרוצים לרשום את היומנים שלה. צריך לציין את הערך בפורמט הבא:"projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME", כאשר:-
PROJECT_IDהוא המזהה של Google Cloud הפרויקט שמכיל את מנהרת Cloud VPN. צריך ליצור את ההגדרה בפרויקט הזה. -
REGIONהוא האזור של מנהרת Cloud VPN. -
NAMEהוא השם של מנהרת Cloud VPN.
-
כדי להגדיר את הפרמטרים האופציונליים בהגדרה מותאמת אישית, מחליפים את הערכים הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכים הבאים:interval-5-sec(ברירת מחדל),interval-30-sec,interval-1-min,interval-5-min,interval-10-minאוinterval-15-min. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמרים סינון יומנים ודוגמאות למסנני יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). למידע נוסף, קראו את המאמר דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- משתמשים ב-
include-all-metadataכדי לכלול את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
exclude-all-metadataכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
custom-metadataכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בדגל--metadata-fields:-
--metadata-fields=METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה:src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאcustom-metadata.
-
- משתמשים ב-
-
Terraform
אתם יכולים להשתמש במודול Terraform כדי ליצור הגדרת יומני זרימה של VPC למנהרת Cloud VPN.
בלוק הקוד הבא יוצר הגדרת ברירת מחדל של יומני זרימה של VPC.
בדוגמה שלמעלה, השם של המשאב google_compute_vpn_tunnel הוא tunnel. דוגמה מלאה להגדרה הזו מופיעה במאגר terraform-docs-samples.
בלוק הקוד הבא יוצר הגדרה של יומני זרימה של VPC, כאשר:
- מרווח הצבירה מוגדר ל-
INTERVAL_10_MIN. - תדירות הדגימה של הזרימה המשנית מוגדרת ל-
0.7. - המטא-נתונים שייכללו ביומנים מוגדרים לערך
INCLUDE_ALL_METADATA. - מצב ההגדרה הוא
ENABLED.
בדוגמה שלמעלה, השם של המשאב google_compute_vpn_tunnel הוא tunnel. דוגמה מלאה להגדרה הזו מופיעה במאגר terraform-docs-samples.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
API
כדי להפעיל את VPC Flow Logs למנהרת Cloud VPN, משתמשים בשיטה projects.locations.vpcFlowLogsConfigs.create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרות עם כל הפרמטרים שמוגדרים לערכי ברירת המחדל שלהם, או להתאים אישית את ערכי ברירת המחדל.
כדי ליצור הגדרת ברירת מחדל של יומני זרימה של VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"vpnTunnel": "VPN_TUNNEL"
}
כדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, קצב הדגימה המשני ופרמטרים של מטא-נתונים כשיוצרים הגדרה של יומני תנועה ב-VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"vpnTunnel": "VPN_TUNNEL",
"aggregationInterval": "AGGREGATION_INTERVAL",
"filterExpr": "FILTER_EXPRESSION",
"flowSampling": SAMPLING_RATE,
"metadata": "LOGGING_METADATA"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה Google Cloud הפרויקט של מנהרת Cloud VPN. -
CONFIG_NAME: שם להגדרות האישיות. -
VPN_TUNNEL: מנהרת Cloud VPN שרוצים לרשום ביומן. צריך לציין את הערך בפורמט הבא:projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME, כאשר:-
PROJECT_IDהוא מזהה הפרויקט של מנהרת Cloud VPN. -
REGIONהוא האזור של מנהרת Cloud VPN. -
NAMEהוא השם של מנהרת Cloud VPN.
-
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכיםINTERVAL_5_SEC(ברירת מחדל),INTERVAL_30_SEC,INTERVAL_1_MIN,INTERVAL_5_MIN,INTERVAL_10_MINאוINTERVAL_15_MIN. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמר בנושא סינון יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
INCLUDE_ALL_METADATA. - משתמשים ב-
EXCLUDE_ALL_METADATAכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
CUSTOM_METADATAכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בפרמטרmetadataFields:-
metadataFields: METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את המדיניות הזו רק אם המדיניותmetadataמוגדרת לערךCUSTOM_METADATA.
-
- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
הפעלת VPC Flow Logs ברשת VPC
כדי להפעיל יומני זרימה של VPC לכל רשתות המשנה, חיבורי ה-VLAN ומנהרות Cloud VPN ברשת VPC, צריך לבצע את הפעולות הבאות.
המסוף
נכנסים לדף VPC networks במסוף Google Cloud .
בכרטיסייה Networks in current project, בוחרים רשת אחת או יותר ולוחצים על Manage flow logs בחלק העליון של הרשימה.
בManage flow logs (ניהול יומני תעבורה), לוחצים על Add new configuration (הוספת הגדרה חדשה).
בשדה Name (שם), מזינים שם להגדרת VPC Flow Logs החדשה.
אופציונלי: משנים את מרווח הצבירה ואת ההגדרות בקטע הגדרות מתקדמות:
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות הסופיות ביומן. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- האם להפעיל רישום ביומן של חיבורי TCP. כברירת מחדל, האפשרות רישום ביומן של חיבורים לא מסומנת. אם האפשרות הזו נבחרה, VPC Flow Logs מתעד אירועי חיבור לתעבורת TCP ממכונות וירטואליות ומנקודות קצה ללא שרתים, ואליהן. מידע נוסף זמין במאמר בנושא רישום ביומן של חיבורי TCP.
- תדירות הדגימה המשנית.
100%פירושו שכל הרשומות שנוצרו בתהליך הדגימה הראשי של יומני התנועה נשמרות. אי אפשר להגדיר את קצב הדגימה של יומן זרימת הנתונים הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
לוחצים על Save.
gcloud
כדי להפעיל את VPC Flow Logs ברשת VPC, משתמשים בפקודה gcloud network-management vpc-flow-logs-configs create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרה עם כל הפרמטרים שלה שמוגדרים לערכי ברירת המחדל, או להתאים אישית את ערכי ברירת המחדל.
ב-CLI של gcloud, מגדירים את הפרויקט ל-Google Cloud מזהה הפרויקט של רשת ה-VPC ומריצים אחת מהפקודות הבאות:
כדי ליצור הגדרת ברירת מחדל ליומני זרימה של VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --network=NETWORKכדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את פרמטרים של מרווח הצבירה, הסינון, קצב הדגימה המשני, המטא-נתונים והרישום ביומן של החיבור כשיוצרים הגדרה של יומני תנועה ב-VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --network=NETWORK \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA \ --connection-logging=CONNECTION_LOGGINGמחליפים את מה שכתוב בשדות הבאים:
CONFIG_NAME: שם להגדרה.-
NETWORK: רשת ה-VPC שרוצים לרשום ביומן. צריך לציין את הערך בפורמט הבא:"projects/PROJECT_ID/global/networks/NAME", כאשר:-
PROJECT_IDהוא המזהה של Google Cloud הפרויקט שמכיל את רשת ה-VPC. צריך ליצור את ההגדרה בפרויקט הזה. -
NAMEהוא השם של רשת ה-VPC.
-
כדי להגדיר את הפרמטרים האופציונליים בהגדרה מותאמת אישית, מחליפים את הערכים הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכים הבאים:interval-5-sec(ברירת מחדל),interval-30-sec,interval-1-min,interval-5-min,interval-10-minאוinterval-15-min. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. הביטוי מוגבל ל-2,048 תווים. מידע נוסף מופיע במאמרים בנושא סינון יומנים ודוגמאות למסנני יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- משתמשים ב-
include-all-metadataכדי לכלול את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
exclude-all-metadataכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
custom-metadataכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בדגל--metadata-fields:-
--metadata-fields=METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה:src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאcustom-metadata.
-
- משתמשים ב-
-
CONNECTION_LOGGING: רישום ביומן של חיבורי TCP. אפשר להגדיר את הערךenabledאוdisabled(ברירת מחדל). אם האפשרות הזו מופעלת, VPC Flow Logs מתעד אירועי חיבור לתעבורת TCP ממכונות וירטואליות ומנקודות קצה בלי שרת (serverless), ואליהן. מידע נוסף זמין במאמר רישום ביומן של חיבורי TCP.
API
כדי להפעיל את יומני הזרימה של VPC ברשת VPC, משתמשים בשיטה projects.locations.vpcFlowLogsConfigs.create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרה עם כל הפרמטרים שלה שמוגדרים לערכי ברירת המחדל, או להתאים אישית את ערכי ברירת המחדל.
כדי ליצור הגדרת ברירת מחדל של יומני זרימה של VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"network": "NETWORK"
}
כדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, קצב הדגימה המשני, המטא-נתונים ופרמטרים של רישום ביומן החיבורים כשיוצרים הגדרה של יומני תנועה ב-VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"network": "NETWORK",
"aggregationInterval": "AGGREGATION_INTERVAL",
"filterExpr": "FILTER_EXPRESSION",
"flowSampling": SAMPLING_RATE,
"metadata": "LOGGING_METADATA",
"connectionLogging": "CONNECTION_LOGGING"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud של רשת ה-VPC. CONFIG_NAME: שם להגדרה.-
NETWORK: רשת ה-VPC שרוצים לרשום ביומן. צריך לציין את הערך בפורמט הבא:projects/PROJECT_ID/global/networks/NAME, כאשר:-
PROJECT_IDהוא מזהה הפרויקט של רשת ה-VPC. -
NAMEהוא השם של רשת ה-VPC.
-
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכיםINTERVAL_5_SEC(ברירת מחדל),INTERVAL_30_SEC,INTERVAL_1_MIN,INTERVAL_5_MIN,INTERVAL_10_MINאוINTERVAL_15_MIN. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמר בנושא סינון יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת המחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
INCLUDE_ALL_METADATA. - משתמשים ב-
EXCLUDE_ALL_METADATAכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
CUSTOM_METADATAכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בפרמטרmetadataFields:-
metadataFields: METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאCUSTOM_METADATA.
-
- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
-
CONNECTION_LOGGING: רישום ביומן של חיבורי TCP. אפשר להגדיר את הערך כ-ENABLEDאו כ-DISABLED(ברירת המחדל). אם מפעילים את VPC Flow Logs, המערכת מתעדת אירועי חיבור של תנועת נתונים ב-TCP מנקודות קצה של מכונות וירטואליות ושל שרתים ללא שרת (serverless) ואליהן. מידע נוסף זמין במאמר בנושא רישום ביומן של חיבורי TCP.
הפעלת יומני זרימה של VPC בארגון
כדי להפעיל את יומני הזרימה של VPC לכל רשתות המשנה, לכל חיבורי ה-VLAN ולכל מנהרות Cloud VPN בכל רשתות ה-VPC בארגון, צריך לבצע את הפעולות הבאות.
המסוף
נכנסים לדף VPC Flow Logs במסוף Google Cloud .
לוחצים על Add VPC Flow Logs configuration ואז על Add a configuration for the organization.
בשדה Name (שם), מזינים שם להגדרת VPC Flow Logs החדשה.
אופציונלי: משנים את מרווח הצבירה ואת ההגדרות בקטע הגדרות מתקדמות:
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול הערות חוצות פרויקטים. כברירת מחדל, האפשרות הערות מטא-נתונים בין פרויקטים מסומנת. מידע נוסף זמין במאמר הערות בפרויקטים שונים.
- האם לכלול מטא-נתונים ברשומות הסופיות ביומן. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- האם להפעיל רישום ביומן של חיבורי TCP. כברירת מחדל, האפשרות רישום חיבורים ביומן לא מסומנת. אם בוחרים באפשרות הזו, יומני הזרימה של VPC מתעדים אירועי חיבור של תעבורת נתונים ב-TCP ממכונות וירטואליות ומנקודות קצה ללא שרת (serverless) ואליהן. מידע נוסף זמין במאמר בנושא רישום ביומן של חיבורי TCP.
- תדירות הדגימה המשנית.
100%– כל הרשומות שנוצרו על ידי תהליך הדגימה הראשי של יומן תעבורת הנתונים נשמרות. אי אפשר להגדיר את קצב הדגימה של יומן זרימת הנתונים הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
לוחצים על Save.
gcloud
כדי להפעיל יומני זרימה של VPC בארגון, משתמשים בפקודה gcloud network-management vpc-flow-logs-configs create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרה עם כל הפרמטרים שלה שמוגדרים לערכי ברירת המחדל, או להתאים אישית את ערכי ברירת המחדל.
כדי ליצור הגדרת ברירת מחדל ליומני זרימה של VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --organization=ORGANIZATIONכדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, תדירות הדגימה המשנית, המטא-נתונים ופרמטרים של רישום ביומן של חיבורים כשיוצרים הגדרה של יומני VPC Flow, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \ --location=global \ --organization=ORGANIZATION \ --aggregation-interval=AGGREGATION_INTERVAL \ --filter-expr=FILTER_EXPRESSION \ --flow-sampling=SAMPLING_RATE \ --metadata=LOGGING_METADATA \ --cross-project-metadata=CROSS_PROJECT_METADATA \ --connection-logging=CONNECTION_LOGGINGמחליפים את מה שכתוב בשדות הבאים:
-
CONFIG_NAME: שם להגדרה -
ORGANIZATION: מזהה הארגון
כדי להגדיר את הפרמטרים האופציונליים בהגדרה מותאמת אישית, מחליפים את הערכים הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכים הבאים:interval-5-sec(ברירת מחדל),interval-30-sec,interval-1-min,interval-5-min,interval-10-minאוinterval-15-min. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. הביטוי מוגבל ל-2,048 תווים. מידע נוסף מופיע במאמרים בנושא סינון יומנים ודוגמאות למסנני יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- משתמשים ב-
include-all-metadataכדי לכלול את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
exclude-all-metadataכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
custom-metadataכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בדגל--metadata-fields:-
--metadata-fields=METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה:src_instance,dst_instance. אפשר להגדיר את המדיניות הזו רק אם המדיניותmetadataמוגדרת כ-custom-metadata.
-
- משתמשים ב-
-
CROSS_PROJECT_METADATA: הערות חוצות פרויקטים. אפשר להגדיר את הערךcross-project-metadata-enabled(ברירת מחדל) אוcross-project-metadata-disabled. מידע נוסף זמין במאמר הערות בפרויקטים שונים. -
CONNECTION_LOGGING: רישום ביומן של חיבור TCP. אפשר להגדיר את הערךenabledאוdisabled(ברירת מחדל). אם האפשרות הזו מופעלת, VPC Flow Logs מתעד אירועי חיבור לתעבורת TCP ממכונות וירטואליות ומנקודות קצה בלי שרת (serverless), ואליהן. מידע נוסף זמין במאמר רישום ביומן של חיבורי TCP.
-
API
כדי להפעיל את יומני הזרימה של VPC לארגון, משתמשים ב-method organizations.locations.vpcFlowLogsConfigs.create.
כדי להפעיל את VPC Flow Logs, צריך ליצור הגדרה של VPC Flow Logs. אפשר ליצור את ההגדרה עם כל הפרמטרים שלה שמוגדרים לערכי ברירת המחדל, או להתאים אישית את ערכי ברירת המחדל.
כדי ליצור הגדרת ברירת מחדל של יומני זרימה של VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
כדי ליצור הגדרה מותאמת אישית של יומני תנועה ב-VPC, צריך לציין כל פרמטר שרוצים להתאים אישית.
לדוגמה, כדי להתאים אישית את מרווח הצבירה, הסינון, קצב הדגימה המשני, המטא-נתונים ופרמטרים של רישום ביומן של חיבורים כשיוצרים הגדרה של יומני תנועה ב-VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
POST -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
"aggregationInterval": "AGGREGATION_INTERVAL",
"filterExpr": "FILTER_EXPRESSION",
"flowSampling": SAMPLING_RATE,
"metadata": "LOGGING_METADATA",
"crossProjectMetadata": "CROSS_PROJECT_METADATA",
"connectionLogging": "CONNECTION_LOGGING"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה פרויקט המכסה. בקשות ה-API נספרות בפרויקט הזה. מידע נוסף זמין בדף Quotas and System Limits במסוף Google Cloud . -
ORGANIZATION_ID: מזהה הארגון. CONFIG_NAME: שם להגדרה.
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכיםINTERVAL_5_SEC(ברירת מחדל),INTERVAL_30_SEC,INTERVAL_1_MIN,INTERVAL_5_MIN,INTERVAL_10_MINאוINTERVAL_15_MIN. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמר בנושא סינון יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
INCLUDE_ALL_METADATA. - משתמשים ב-
EXCLUDE_ALL_METADATAכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
CUSTOM_METADATAכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בפרמטרmetadataFields:-
metadataFields: METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאCUSTOM_METADATA.
-
- כדי לכלול את כל הערות המטא-נתונים (ברירת המחדל), משתמשים ב-
-
CROSS_PROJECT_METADATA: הערות חוצות פרויקטים. אפשר להגדיר את הערךCROSS_PROJECT_METADATA_ENABLED(ברירת מחדל) אוCROSS_PROJECT_METADATA_DISABLED. מידע נוסף זמין במאמר הערות בפרויקטים שונים. -
CONNECTION_LOGGING: רישום ביומן של חיבורי TCP. אפשר להגדיר את הערךENABLEDאוDISABLED(ברירת מחדל). אם האפשרות הזו מופעלת, VPC Flow Logs מתעד אירועי חיבור לתעבורת TCP ממכונות וירטואליות ומנקודות קצה של serverless, ואליהן. מידע נוסף זמין במאמר רישום ביומן של חיבורי TCP.
כשמפעילים את VPC Flow Logs בארגון, יומני התנועה נכתבים ומחויבים בפרויקט ב- Google Cloud של המשאב שמדווח על יומני התנועה. מידע נוסף זמין במאמר בנושא תמחור וחיוב.
הצגת סטטוס ההגדרה של יומני זרימה של VPC
כדי לבדוק באילו משאבים מופעלים יומני זרימה של VPC, אפשר לעיין בהגדרות של יומני הזרימה של VPC. כדי לראות את כל ההגדרות, קראו את המאמר הצגת ההגדרות של יומני הזרימה של VPC (הכול). אם אתם משתמשים ב-Compute Engine API כדי להפעיל ולנהל את יומני הזרימה של VPC, קראו את המאמר הצגת ההגדרות של יומני הזרימה של VPC (רק ב-Compute Engine API).
הצגת ההגדרות של VPC Flow Logs (הכול)
המסוף
כדי לראות את כל ההגדרות של יומני הזרימה של VPC:
נכנסים לדף VPC Flow Logs במסוף Google Cloud .
בקטעים Organization-level configurations (הגדרות אישיות ברמת הארגון) ו-Project-level configurations (הגדרות אישיות ברמת הפרויקט), אפשר לראות את ההגדרות האישיות הפעילות והמושהות. אם הסטטוס של ההגדרה של VPC Flow Logs למשאב הוא On, המשמעות היא שהרישום ביומן מופעל.
אפשר גם לראות את ההגדרות של יומני הזרימה של VPC בעמודה Flow log configs בדף המשאבים. לדוגמה, כדי לראות אילו רשתות VPC ורשתות משנה כוללות הגדרות של VPC Flow Logs:
עוברים לדף VPC networks.
לוחצים על הכרטיסייה Networks in current project (רשתות בפרויקט הנוכחי) או על הכרטיסייה Subnets in current project (רשתות משנה בפרויקט הנוכחי). בעמודה Flow log configs (הגדרות של יומני זרימה), אפשר לראות את ההגדרות הפעילות והמושהות של יומני הזרימה של VPC.
gcloud
כדי לראות את ההגדרות של יומני הזרימה של VPC, משתמשים בפקודות gcloud network-management vpc-flow-logs-configs list ו-gcloud network-management vpc-flow-logs-configs describe.
הצגת ההגדרות ברמת הארגון
כדי לראות את כל ההגדרות של VPC Flow Logs בארגון, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs list --location=global \ --organization=ORGANIZATIONכדי לראות הגדרה ספציפית של יומני זרימה של VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs describe CONFIG_NAME \ --location=global \ --organization=ORGANIZATIONמחליפים את מה שכתוב בשדות הבאים:
-
ORGANIZATION: מזהה הארגון -
CONFIG_NAME: השם של ההגדרה
-
צפייה בהגדרות ברמת הפרויקט
כדי לראות את כל ההגדרות של יומני הזרימה של VPC בפרויקט, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs list --location=global
כדי לראות הגדרה ספציפית של יומני זרימה של VPC, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs describe CONFIG_NAME \ --location=globalמחליפים את
CONFIG_NAMEבשם של הגדרת היומנים של תעבורת ה-VPC שרוצים להציג.
הצגת כל ההגדרות של משאב
כדי לראות את כל ההגדרות של VPC Flow Logs ברשת VPC, ברשת משנה, בצירוף ל-VLAN או במנהרת VPN, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs show-effective-flow-logs-configs \
--location=global \
--resource=TARGET_RESOURCE
מחליפים את TARGET_RESOURCE באחד מהמשאבים הבאים:
"projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET": מציגה את כל ההגדרות של תת-הרשת, כולל:- כל ההגדרות שבהן רשת המשנה היא משאב היעד
- כל ההגדרות של רשת ה-VPC של רשת המשנה
- כל ההגדרות של הארגון שהוא הבעלים של הפרויקט של רשת המשנה
Compute Engine API בלבד: הגדרת יומני הזרימה של VPC לרשת המשנה
כדי לזהות את ההגדרות בפלט, מחפשים את
"scope": "COMPUTE_API_SUBNET". ההגדרה הזו לא קיימת אם אתם משתמשים רק ב-Network Management API כדי להגדיר יומני זרימה של VPC.
"projects/PROJECT_ID/regions/REGION/interconnectAttachments/VLAN_ATTACHMENT": מציג את כל ההגדרות של הצירוף ל-VLAN, כולל:- כל ההגדרות שבהן הצירוף ל-VLAN הוא משאב היעד
- כל ההגדרות של רשת ה-VPC של חיבור ה-VLAN
- כל ההגדרות של הארגון שבבעלותו הפרויקט של הצירוף ל-VLAN
"projects/PROJECT_ID/regions/REGION/vpnTunnels/VPN_TUNNEL": מציג את כל ההגדרות של מנהרת Cloud VPN, כולל:- כל ההגדרות שבהן מנהרת Cloud VPN היא משאב היעד
- כל ההגדרות של רשת ה-VPC של מנהרת Cloud VPN
- כל ההגדרות של הארגון שבבעלותו הפרויקט של מנהרת Cloud VPN
"projects/PROJECT_ID/global/networks/NETWORK": מציג את כל ההגדרות של רשת ה-VPC, כולל:- כל ההגדרות שבהן הרשת היא משאב היעד
- כל ההגדרות של הארגון שהוא הבעלים של הפרויקט של הרשת
כשמציינים את משאב היעד, מחליפים את הערכים הבאים:
-
PROJECT_ID: מזהה הפרויקט של משאב היעד -
REGION: האזור של משאב היעד, אם המשאב הוא רשת משנה, צירוף ל-VLAN או מנהרת VPN -
SUBNET: השם של רשת המשנה -
VLAN_ATTACHMENT: השם של הצירוף ל-VLAN -
VPN_TUNNEL: השם של מנהרת ה-VPN -
NETWORK: השם של הרשת
API
צפייה בהגדרות ברמת הארגון
כדי לראות את כל ההגדרות של יומני הזרימה של VPC בארגון, משתמשים בשיטה
organizations.locations.vpcFlowLogsConfigs.list:GET -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs
כדי להציג הגדרה ספציפית של VPC Flow Logs בארגון, משתמשים בשיטה
organizations.locations.vpcFlowLogsConfigs.get:GET -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה פרויקט המכסה. בקשות ה-API נספרות בפרויקט הזה. -
ORGANIZATION_ID: מזהה הארגון. -
CONFIG_NAME: שם ההגדרה.
-
אם אין לכם את ההרשאות הנדרשות לביצוע המשימות הקודמות ברמת הארגון, אתם יכולים להשתמש בבקשה הבאה כדי לראות את כל ההגדרות של יומני הזרימה של VPC בארגון של הפרויקט שלכם:
GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs:queryOrgVpcFlowLogsConfigs
מחליפים את
PROJECT_IDבמזהה הפרויקט.
צפייה בהגדרות ברמת הפרויקט
כדי לראות את כל ההגדרות של VPC Flow Logs בפרויקט, משתמשים בשיטה
projects.locations.vpcFlowLogsConfigs.list:GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs
כדי להציג הגדרה ספציפית של יומני זרימה של VPC, משתמשים בשיטה
projects.locations.vpcFlowLogsConfigs.get:GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט -
CONFIG_NAME: השם של ההגדרה של VPC Flow Logs
-
הצגת כל ההגדרות של משאב
כדי להציג את כל ההגדרות של יומני זרימה של VPC ברשת VPC, ברשת משנה, בצירוף ל-VLAN או במנהרת VPN, משתמשים בבקשה הבאה:
GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs:showEffectiveFlowLogsConfigs?resource="TARGET_RESOURCE"
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: המזהה של Google Cloud הפרויקט
TARGET_RESOURCE: אחד ממשאבי היעד הבאים:
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET: מציג את כל ההגדרות של תת-הרשת, כולל:- כל ההגדרות שבהן רשת המשנה היא משאב היעד
- כל ההגדרות של רשת ה-VPC של רשת המשנה
- כל ההגדרות האישיות של הארגון שבבעלותו הפרויקט של רשת המשנה
רק ב-Compute Engine API: הגדרת יומני הזרימה של VPC ברשת המשנה
כדי לזהות את ההגדרה בפלט, מחפשים את
"scope": "COMPUTE_API_SUBNET". ההגדרה הזו לא קיימת אם אתם משתמשים רק ב-Network Management API כדי להגדיר יומני זרימה של VPC.
projects/PROJECT_ID/regions/REGION/interconnectAttachments/VLAN_ATTACHMENT: מציג את כל ההגדרות של הצירוף ל-VLAN, כולל:- כל ההגדרות שבהן הצירוף ל-VLAN הוא משאב היעד
- כל ההגדרות של רשת ה-VPC של חיבור ה-VLAN
- כל ההגדרות של הארגון שבבעלותו הפרויקט של הצירוף ל-VLAN
projects/PROJECT_ID/regions/REGION/vpnTunnels/VPN_TUNNEL: lists all configurations for the Cloud VPN tunnel, including the following:- כל ההגדרות שבהן מנהרת Cloud VPN היא משאב היעד
- כל ההגדרות של רשת ה-VPC של מנהרת Cloud VPN
- כל ההגדרות של הארגון שבבעלותו הפרויקט של מנהרת Cloud VPN
projects/PROJECT_ID/global/networks/NETWORK: מציג את כל ההגדרות של רשת ה-VPC, כולל:- כל ההגדרות שבהן הרשת היא משאב היעד
- כל ההגדרות של הארגון שהוא הבעלים של הפרויקט של הרשת
כשמציינים את משאב היעד, מחליפים את הערכים הבאים:
-
PROJECT_ID: מזהה הפרויקט של משאב היעד -
REGION: האזור של משאב היעד, אם המשאב הוא רשת משנה, צירוף ל-VLAN או מנהרת VPN -
SUBNET: השם של רשת המשנה -
VLAN_ATTACHMENT: השם של הצירוף ל-VLAN -
VPN_TUNNEL: השם של מנהרת ה-VPN -
NETWORK: שם הרשת
הצגת ההגדרות של יומני זרימה של VPC (רק Compute Engine API)
בקטע הזה מוסבר איך לראות אילו הגדרות של VPC Flow Logs לרשתות משנה מנוהלות על ידי Compute Engine API. כדי לראות את כל ההגדרות של יומני הזרימה של VPC, אפשר לעיין במאמר בנושא הצגת ההגדרות של יומני הזרימה של VPC.
המסוף
נכנסים לדף VPC Flow Logs במסוף Google Cloud .
בקטע Project-level configurations (הגדרות ברמת הפרויקט), לוחצים על הכרטיסייה Subnets (Compute Engine API) (רשתות משנה (Compute Engine API)) ורואים באילו רשתות משנה בפרויקט מופעלים יומני תנועה של VPC.
ההגדרות האלה מנוהלות על ידי Compute Engine API. הגדרות שמנוהלות על ידי Network Management API מוצגות בכרטיסייה Subnets (רשתות משנה).
gcloud
כדי לראות באילו רשתות משנה ברשת VPC מופעלים יומני תעבורה של VPC, מריצים את הפקודה הבאה:
gcloud compute networks subnets list \
--project PROJECT_ID \
--network="NETWORK" \
--format="csv(name,region,logConfig.enable)"מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט שאתם שולחים אליו את השאילתה -
NETWORK: השם של הרשת שמכילה את רשתות המשנה
עדכון ההגדרה של VPC Flow Logs
אפשר לעדכן את ההגדרה של VPC Flow Logs. למידע נוסף על הפרמטרים שאפשר לשנות, קראו את המאמר דגימה ועיבוד של יומנים.
עדכון הגדרה ברמת הארגון
כשמעדכנים את ההגדרה של יומני זרימה של VPC בארגון, ההגדרה ששונתה חלה על כל רשתות המשנה, על כל חיבורי ה-VLAN ועל כל מנהרות Cloud VPN בכל רשתות ה-VPC בארגון.
המסוף
נכנסים לדף VPC Flow Logs במסוף Google Cloud .
בקטע הגדרות ברמת הארגון, בוחרים הגדרה אחת או יותר שרוצים לעדכן ולוחצים על עריכה.
משנים את ההגדרות הבאות:
- מרווח צבירת הנתונים. כברירת מחדל, מרווח הצבירה מוגדר ל-5 שניות.
- האם להגדיר את הסטטוס של ההגדרה של יומני הזרימה של ה-VPC כפעיל או כלא פעיל. הסטטוס פעיל מציין שההגדרה שנבחרה של יומני הזרימה של ה-VPC פעילה ומייצרת יומני זרימה.
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול הערות חוצות פרויקטים. כברירת מחדל, האפשרות הערות מטא-נתונים בין פרויקטים מסומנת. מידע נוסף זמין במאמר בנושא הערות חוצות פרויקטים.
- האם לכלול מטא-נתונים ברשומות הסופיות ביומן. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- האם להפעיל רישום ביומן של חיבורי TCP. כברירת מחדל, האפשרות רישום חיבורים ביומן לא מסומנת. אם האפשרות הזו נבחרה, VPC Flow Logs מתעד אירועי חיבור לתעבורת TCP ממכונות וירטואליות ומנקודות קצה ללא שרתים, ואליהן. מידע נוסף זמין במאמר בנושא רישום ביומן של חיבורי TCP.
- תדירות הדגימה המשנית.
100%– כל הרשומות שנוצרו על ידי תהליך הדגימה הראשי של יומן תעבורת הנתונים נשמרות. אי אפשר להגדיר את קצב הדגימה של יומן זרימת הנתונים הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
לוחצים על Save.
gcloud
משתמשים בפקודה gcloud network-management vpc-flow-logs-configs update.
הסוגריים המרובעים [] בפקודות הבאות מציינים פרמטרים אופציונליים.
כדי לעדכן את ההגדרה של יומני זרימה של VPC בארגון, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
--location=global \
--organization=ORGANIZATION \
[--aggregation-interval=AGGREGATION_INTERVAL] \
[--filter-expr=FILTER_EXPRESSION] \
[--flow-sampling=SAMPLING_RATE] \
[--metadata=LOGGING_METADATA] \
[--cross-project-metadata=CROSS_PROJECT_METADATA] \
[--connection-logging=CONNECTION_LOGGING] \
[--state=STATE]
לדוגמה, כדי לעדכן את הפרמטר של מרווח הצבירה, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
--location=global \
--organization=ORGANIZATION \
--aggregation-interval=AGGREGATION_INTERVAL
מחליפים את מה שכתוב בשדות הבאים:
-
CONFIG_NAME: השם של ההגדרה שרוצים לעדכן. ההגדרה נמצאת באותו פרויקט Google Cloud כמו המשאב שההגדרה משמשת עבורו. -
ORGANIZATION: מזהה הארגון.
כדי לעדכן את הפרמטרים האופציונליים, מחליפים את הערכים הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכים הבאים:interval-5-sec(ברירת מחדל),interval-30-sec,interval-1-min,interval-5-min,interval-10-minאוinterval-15-min. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמרים סינון יומנים ודוגמאות למסנני יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת המחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- משתמשים ב-
include-all-metadataכדי לכלול את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
exclude-all-metadataכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
custom-metadataכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בדגל--metadata-fields:-
--metadata-fields=METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה:src_instance,dst_instance. אפשר להגדיר את המדיניות הזו רק אם המדיניותmetadataמוגדרת כ-custom-metadata.
-
- משתמשים ב-
-
CROSS_PROJECT_METADATA: הערות חוצות פרויקטים. אפשר להגדיר את הערךcross-project-metadata-enabled(ברירת מחדל) אוcross-project-metadata-disabled. מידע נוסף זמין במאמר בנושא הערות חוצות פרויקטים. -
CONNECTION_LOGGING: רישום ביומן של חיבורי TCP. אפשר להגדיר את הערךenabledאוdisabled(ברירת המחדל). אם האפשרות הזו מופעלת, VPC Flow Logs מתעד אירועי חיבור לתעבורת TCP ממכונות וירטואליות ומנקודות קצה בלי שרתים (serverless), ואליהן. מידע נוסף זמין במאמר בנושא רישום ביומן של חיבור TCP. STATE: המצב של ההגדרה. הערך יכול להיותenabled(ברירת מחדל) אוdisabled.
API
משתמשים בשיטה organizations.locations.vpcFlowLogsConfigs.patch.
מידע על השדות שאפשר לשנות זמין במאמר בנושא משאב REST: projects.locations.vpcFlowLogsConfigs.
כדי לעדכן את ההגדרה של יומני תנועה ב-VPC בארגון, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS
{
...fields to modify
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה פרויקט המכסה. בקשות API נספרות בפרויקט הזה. מידע נוסף זמין בדף Quotas and System Limits במסוף Google Cloud . -
ORGANIZATION_ID: המזהה של הארגון שעבורו נעשה שימוש בהגדרה. -
CONFIG_NAME: השם של ההגדרה שרוצים לעדכן. -
FIELDS: השם של השדה או השדות שרוצים לעדכן, מופרדים בפסיקים. לדוגמה,aggregationInterval,flowSampling,metadata,connectionLogging.
לדוגמה, כדי לעדכן את השדה aggregationInterval של ההגדרה my-config ב-my-organization, משתמשים בבקשת ה-API הבאה:
PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/my-organization/locations/global/vpcFlowLogsConfigs/my-config?updateMask=aggregationInterval
{
aggregationInterval:AGGREGATION_INTERVAL
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה פרויקט המכסה. בקשות ה-API נספרות בפרויקט הזה. AGGREGATION_INTERVALעם אחד מהערכים הנתמכים של הפרמטר הזה.
עדכון הגדרה ברמת הפרויקט
הגדרות ברמת הפרויקט כוללות הגדרות של רשתות VPC, רשתות משנה, קבצים מצורפים של VLAN ומנהרות Cloud VPN. כשמעדכנים את ההגדרות של יומני הזרימה של VPC ברשת VPC, ההגדרות החדשות חלות על כל רשתות המשנה, החיבורים ל-VLAN ומנהרות Cloud VPN ברשת.
כדי לעדכן הגדרה של יומני VPC Flow שמנוהלים על ידי Compute Engine API, קראו את המאמר עדכון פרמטרים של הגדרות לרשתות משנה.
המסוף
נכנסים לדף VPC Flow Logs במסוף Google Cloud .
בקטע הגדרות ברמת הפרויקט, בוחרים הגדרה אחת או יותר שרוצים לעדכן ולוחצים על Edit.
משנים את ההגדרות הבאות:
- מרווח צבירת הנתונים. כברירת מחדל, מרווח הצבירה מוגדר ל-5 שניות.
- האם להגדיר את הסטטוס של ההגדרה של יומני הזרימה של ה-VPC כפעיל או כלא פעיל. הסטטוס פעיל מציין שההגדרה שנבחרה של יומני הזרימה של ה-VPC פעילה ומייצרת יומני זרימה.
- האם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות הסופיות ביומן. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- האם להפעיל רישום ביומן של חיבורי TCP. כברירת מחדל, האפשרות רישום חיבורים ביומן לא מסומנת. אם האפשרות הזו נבחרה, VPC Flow Logs מתעד אירועי חיבור לתעבורת TCP ממכונות וירטואליות ומנקודות קצה ללא שרתים, ואליהן. מידע נוסף זמין במאמר בנושא רישום ביומן של חיבורי TCP.
- תדירות הדגימה המשנית.
100%פירושו שכל הרשומות שנוצרו בתהליך הדגימה הראשי של יומני התנועה נשמרות. אי אפשר להגדיר את קצב הדגימה של יומן זרימת הנתונים הראשי. מידע נוסף זמין במאמר דגימה ועיבוד של יומנים.
לוחצים על Save.
אפשר גם להשתמש בתפריט Manage flow logs במיקומים הבאים כדי לערוך את ההגדרות של VPC Flow Logs:
- הכרטיסיות Networks in current project (רשתות בפרויקט הנוכחי) ו-Subnets in current project (רשתות משנה בפרויקט הנוכחי) בדף VPC networks (רשתות VPC)
- הכרטיסייה VLAN attachments (צירופים ל-VLAN) בדף Interconnect (חיבור Interconnect)
- הכרטיסייה מנהרות VPN בדף VPN
gcloud
משתמשים בפקודה gcloud network-management vpc-flow-logs-configs update.
הסוגריים המרובעים [] בפקודה הבאה מציינים פרמטרים אופציונליים.
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
--location=global \
[--network=NETWORK | --subnet=SUBNET | --interconnect-attachment=VLAN_ATTACHMENT | --vpn-tunnel=VPN_TUNNEL] \
[--aggregation-interval=AGGREGATION_INTERVAL] \
[--filter-expr=FILTER_EXPRESSION] \
[--flow-sampling=SAMPLING_RATE] \
[--metadata=LOGGING_METADATA] \
[--connection-logging=CONNECTION_LOGGING] \
[--state=STATE]
לדוגמה, כדי לעדכן את הפרמטר של מרווח הצבירה, מריצים את הפקודה הבאה:
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
--location=global \
--aggregation-interval=AGGREGATION_INTERVAL
מחליפים את מה שכתוב בשדות הבאים:
-
CONFIG_NAME: השם של ההגדרה שרוצים לעדכן. ההגדרה נמצאת באותו פרויקט Google Cloud כמו המשאב שההגדרה משמשת עבורו.
כדי לעדכן את הפרמטרים האופציונליים, מחליפים את הערכים הבאים:
-
NETWORK,SUBNET,VLAN_ATTACHMENTאוVPN_TUNNEL: השם של משאב היעד. אפשר לציין רק משאב אחד לכל הגדרה. אפשר להשתמש באפשרות הזו כדי לעדכן את השם של משאב היעד. צריך לציין את הערך בפורמט הבא:- רשת VPC:
projects/PROJECT_ID/global/networks/NAME - רשת משנה:
projects/PROJECT_ID/regions/REGION/subnetworks/NAME - צירוף ל-VLAN:
projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME - מנהרת Cloud VPN:
projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME - מחליפים את הערכים בשדות הבאים:
-
PROJECT_ID: המזהה של Google Cloud הפרויקט שמכיל את המשאב. -
REGION: האזור של המשאב. -
NAME: שם המשאב.
-
- רשת VPC:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה שנוצרו על ידי ההגדרה הזו. אפשר להגדיר את הפרמטר הזה לערכים הבאים:interval-5-sec(ברירת מחדל),interval-30-sec,interval-1-min,interval-5-min,interval-10-minאוinterval-15-min. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף מופיע במאמרים בנושא סינון יומנים ודוגמאות למסנני יומנים. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הפרמטר הזה לערך שגדול מ-0.0ועד1.0(כל היומנים, ברירת מחדל). מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים. -
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- משתמשים ב-
include-all-metadataכדי לכלול את כל הערות המטא-נתונים (ברירת מחדל). - משתמשים ב-
exclude-all-metadataכדי להחריג את כל הערות המטא-נתונים. - משתמשים ב-
custom-metadataכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים. כדי לציין את שדות המטא-נתונים, משתמשים בדגל--metadata-fields:-
--metadata-fields=METADATA_FIELDS: מחליפים אתMETADATA_FIELDSברשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה:src_instance,dst_instance. אפשר להגדיר את ההגדרה הזו רק אם ההגדרה שלmetadataהיאcustom-metadata.
-
- משתמשים ב-
-
CONNECTION_LOGGING: רישום ביומן של חיבורי TCP. אפשר להגדיר את הערךenabledאוdisabled(ברירת מחדל). אם מפעילים את VPC Flow Logs, המערכת מתעדת אירועי חיבור של תנועת TCP ממכונות וירטואליות ומנקודות קצה ללא שרת (serverless) ואליהן. מידע נוסף זמין במאמר בנושא רישום ביומן של חיבור TCP. STATE: המצב של ההגדרה. יכול להיותenabled(ברירת מחדל) אוdisabled.
API
משתמשים בשיטה projects.locations.vpcFlowLogsConfigs.patch.
מידע על השדות שאפשר לשנות זמין במאמר בנושא משאב REST: projects.locations.vpcFlowLogsConfigs.
כדי לעדכן הגדרה של יומני זרימה של VPC, צריך לכלול את הפרמטרים הבאים בבקשת ה-API:
PATCH https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS
{
...fields to modify
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמכיל את ההגדרות של VPC Flow Logs. המזהה הזה זהה למזהה הפרויקט של המשאב שבו נעשה שימוש בהגדרה. -
CONFIG_NAME: השם של מערך ההגדרות שרוצים לעדכן. -
FIELDS: השם של השדה או השדות שרוצים לעדכן, מופרדים בפסיקים. לדוגמה,aggregationInterval,flowSampling,metadata,connectionLogging.
לדוגמה, כדי לעדכן את השדה aggregationInterval של ההגדרה my-config ב-my-project, משתמשים בבקשת ה-API הבאה:
PATCH https://networkmanagement.googleapis.com/v1/projects/my-project/locations/global/vpcFlowLogsConfigs/my-config?updateMask=aggregationInterval
{
aggregationInterval:AGGREGATION_INTERVAL
}
מחליפים את AGGREGATION_INTERVAL באחד מהערכים הנתמכים של הפרמטר הזה.
עדכון פרמטרים של הגדרות עבור רשתות משנה
בקטע הזה מוסבר איך לעדכן הגדרה של יומני תנועה ב-VPC שמנוהלת על ידי Compute Engine API.
כדי לראות אילו הגדרות של VPC Flow Logs מנוהלות על ידי Compute Engine API, אפשר לעיין במאמר בנושא הצגת רשתות משנה שבהן מופעל VPC Flow Logs.
המסוף
נכנסים לדף VPC networks במסוף Google Cloud .
בקטע Subnets in current project, לוחצים על רשת המשנה שרוצים לעדכן.
לוחצים על Edit.
אופציונלי: משנים את ההגדרות הבאות:
- מרווח צבירת הנתונים. כברירת מחדל, מרווח הצבירה מוגדר ל-5 שניות.
- אם להגדיר סינון של יומנים. כברירת מחדל, האפשרות שמירת יומנים שתואמים למסנן בלבד לא מסומנת.
- האם לכלול מטא-נתונים ברשומות היומן הסופיות. כברירת מחדל, הערות מטא-נתונים כוללות את כל השדות.
- תדירות הדגימה המשנית.
50%פירושו שחצי מהרשומות שנוצרו על ידי תהליך הדגימה של יומן התנועה הראשי נשמרות. אי אפשר להגדיר את תדירות הדגימה של יומן הזרימה הראשי. מידע נוסף זמין במאמר בנושא דגימה ועיבוד של יומנים.
לוחצים על Save.
לחלופין, אפשר לעדכן את פרמטרי ההגדרה של יומני הזרימה של VPC באמצעות התפריט Manage flow logs (ניהול יומני זרימה) בקטע Subnets in current project (רשתות משנה בפרויקט הנוכחי) בדף VPC networks (רשתות VPC).
gcloud
מריצים את הפקודה הבאה:
gcloud compute networks subnets update SUBNET_NAME \
[--logging-aggregation-interval=AGGREGATION_INTERVAL] \
[--logging-flow-sampling=SAMPLING_RATE] \
[--logging-filter-expr=FILTER_EXPRESSION] \
[--logging-metadata=LOGGING_METADATA] \
[--logging-metadata-fields=METADATA_FIELDS] \
מחליפים את מה שכתוב בשדות הבאים:
-
AGGREGATION_INTERVAL: מרווח הצבירה של יומני התנועה ברשת המשנה הזו. אפשר להגדיר את המרווח לכל אחת מהאפשרויות הבאות: 5 שניות (ברירת מחדל), 30 שניות, דקה, 5 דקות, 10 דקות או 15 דקות. -
SAMPLING_RATE: תדירות הדגימה של הזרימה המשנית. אפשר להגדיר את הדגימה של זרימת הנתונים המשנית מ-0.0(ללא דגימה) עד1.0(כל היומנים). ברירת המחדל היא0.5. מידע נוסף זמין במאמר דגימה ועיבוד של יומנים. -
FILTER_EXPRESSION: ביטוי שמגדיר אילו יומנים רוצים לשמור. האורך של הביטוי מוגבל ל-2,048 תווים. מידע נוסף זמין במאמרים בנושא סינון יומנים ודוגמאות למסנני יומנים.
LOGGING_METADATA: הערות המטא-נתונים שרוצים לכלול ביומנים:- כדי לכלול את כל הערות המטא-נתונים, משתמשים ב-
include-all. - משתמשים בערך
exclude-allכדי להחריג את כל ההערות של המטא-נתונים (ברירת המחדל). - משתמשים ב-
customכדי לכלול רשימה מותאמת אישית של שדות מטא-נתונים שצוינו ב-METADATA_FIELDS.
- כדי לכלול את כל הערות המטא-נתונים, משתמשים ב-
METADATA_FIELDS: רשימה מופרדת בפסיקים של שדות מטא-נתונים שרוצים לכלול ביומנים. לדוגמה,src_instance,dst_instance. אפשר להגדיר את המדיניות הזו רק אם המדיניותLOGGING_METADATAמוגדרת כ-custom.
API
כדי לעדכן את ההתנהגות של VPC Flow Logs, משנים את השדות של דגימת היומנים.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
{
"logConfig": {
...fields to modify
},
"fingerprint": "SUBNET_FINGERPRINT"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט שבו נמצאת רשת המשנה. -
REGION: האזור שבו נמצאת רשת המשנה. -
SUBNET_NAME: השם של תת-הרשת הקיימת. -
SUBNET_FINGERPRINT: מזהה טביעת האצבע של תת-הרשת הקיימת, שמופיע כשמבצעים תיאור של תת-רשת. - במאמר הפעלת יומני VPC Flow כשיוצרים רשת משנה מפורטים השדות שאפשר לשנות.
למידע נוסף, עיינו בשיטה subnetworks.patch.
הפסקת איסוף היומנים
כדי להשהות את איסוף היומנים של משאב מסוים, צריך להשבית את כל ההגדרות הפעילות של יומני הזרימה של ה-VPC.
אם אתם לא צריכים יותר הגדרה של יומני זרימה של VPC, אתם יכולים למחוק את ההגדרה. איסוף היומנים מופסק וההגדרה נמחקת.
כדי להפסיק את איסוף יומני החיבורים של TCP בלבד, צריך לעדכן את ההגדרה של רישום החיבורים למושבת.
כדי להפסיק את איסוף היומנים ולמחוק הגדרה של יומני זרימה של VPC שמנוהלת על ידי Compute Engine API, אפשר לעיין במאמר בנושא השבתה של יומני זרימה של VPC עבור רשת משנה.
השבתה של הגדרת יומני זרימה של VPC
המסוף
נכנסים לדף VPC Flow Logs במסוף Google Cloud .
בקטעים Organization-level configurations או Project-level configurations, בוחרים הגדרה אחת או יותר של יומני VPC Flow שרוצים להשבית ומשנים את סטטוס ההגדרה ל-Turn off.
אם הבחירה כוללת הגדרות פעילות וגם לא פעילות, בתפריט שינוי סטטוס ההגדרה לוחצים על השבתה של כל ההגדרות.
gcloud
כדי להשהות את איסוף היומנים בהגדרה של יומני זרימה של VPC, משתמשים בפקודה gcloud network-management vpc-flow-logs-configs update.
השהיה של הגדרה ברמת הארגון
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
--location=global \
--organization=ORGANIZATION \
--state=disabled
מחליפים את מה שכתוב בשדות הבאים:
-
CONFIG_NAME: השם של ההגדרה -
ORGANIZATION: מזהה הארגון
השהיה של הגדרה ברמת הפרויקט
gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
--location=global \
--state=disabled
מחליפים את CONFIG_NAME בשם של ההגדרה.
API
השהיה של הגדרה ברמת הארגון
כדי להשהות את איסוף היומנים, משתמשים ב-organizations.locations.vpcFlowLogsConfigs.patch.
PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=state
{
"state": "DISABLED"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה פרויקט המכסה. בקשות API נספרות בפרויקט הזה. -
ORGANIZATION_ID: המזהה של הארגון. -
CONFIG_NAME: השם של ההגדרה.
השהיית הגדרה ברמת הפרויקט
כדי להשהות את איסוף היומנים, משתמשים בשיטה projects.locations.vpcFlowLogsConfigs.patch.
PATCH https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=state
{
"state": "DISABLED"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: המזהה של Google Cloud הפרויקט שמכיל את ההגדרה. המזהה הזה זהה למזהה הפרויקט של המשאב שבו נעשה שימוש בהגדרה. -
CONFIG_NAME: השם של ההגדרה.
מחיקת הגדרות של יומני זרימה של VPC
המסוף
נכנסים לדף VPC Flow Logs במסוף Google Cloud .
בקטעים הגדרות ברמת הארגון או הגדרות ברמת הפרויקט, בוחרים הגדרה אחת או יותר של יומני תנועה ב-VPC שרוצים למחוק ולוחצים על מחיקה.
gcloud
כדי למחוק הגדרה של יומני זרימה של VPC, משתמשים בפקודה gcloud network-management vpc-flow-logs-configs delete.
מחיקת הגדרה ברמת הארגון
gcloud network-management vpc-flow-logs-configs delete CONFIG_NAME \
--location=global \
--organization=ORGANIZATION
מחליפים את מה שכתוב בשדות הבאים:
-
CONFIG_NAME: השם של ההגדרה -
ORGANIZATION: מזהה הארגון
מחיקת הגדרה ברמת הפרויקט
gcloud network-management vpc-flow-logs-configs delete CONFIG_NAME \
--location=global
מחליפים את CONFIG_NAME בשם של ההגדרה שרוצים למחוק.
API
מחיקת הגדרה ברמת הארגון
כדי למחוק הגדרה של VPC Flow Logs, משתמשים בשיטה organizations.locations.vpcFlowLogsConfigs.delete.
DELETE -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה פרויקט המכסה. בקשות ה-API נספרות בפרויקט הזה. -
ORGANIZATION_ID: מזהה הארגון. -
CONFIG_NAME: שם ההגדרה.
מחיקת הגדרה ברמת הפרויקט
כדי למחוק הגדרה של VPC Flow Logs, משתמשים בשיטה projects.locations.vpcFlowLogsConfigs.delete.
DELETE https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: המזהה של Google Cloud הפרויקט שמכיל את התצורה -
CONFIG_NAME: השם של ההגדרה
השבתת VPC Flow Logs ברשת משנה
בקטע הזה מוסבר איך למחוק הגדרה של יומני זרימה ב-VPC שמנוהלת על ידי Compute Engine API. כשמשביתים את יומני הזרימה של VPC עבור רשת משנה, איסוף היומנים נפסק וההגדרה נמחקת.
המסוף
נכנסים לדף VPC networks במסוף Google Cloud .
לוחצים על רשת המשנה שרוצים לעדכן.
לוחצים על Edit.
בקטע יומני זרימה, בוחרים באפשרות מושבת.
לוחצים על Save.
gcloud
מריצים את הפקודה הבאה:
gcloud compute networks subnets update SUBNET_NAME \
--no-enable-flow-logs
API
כדי להפסיק את איסוף רשומות היומן, משביתים את VPC Flow Logs ברשת משנה.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
{
"logConfig": {
"enable": false
},
"fingerprint": "SUBNET_FINGERPRINT"
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט שבו נמצאת רשת המשנה -
REGION: האזור שבו נמצאת רשת המשנה -
SUBNET_NAME: השם של תת-הרשת הקיימת -
SUBNET_FINGERPRINT: מזהה טביעת האצבע של תת-הרשת הקיימת, שמופיע כשמבצעים תיאור של תת-רשת
למידע נוסף, עיינו בשיטה subnetworks.patch.
דוגמאות למסנני יומנים
בקטע הזה מופיעות דוגמאות למסנני יומנים שאפשר להגדיר כדי לשמור רק יומנים שתואמים למסנן. למידע נוסף, ראו סינון יומנים.
דוגמה 1. הגבלת איסוף היומנים למכונה וירטואלית ספציפית בשם my-vm
במקרה הזה, נרשמים רק יומנים שבהם השדה src_instance כפי שדווח על ידי מקור התנועה הוא my-vm, או השדה dst_instance כפי שדווח על ידי יעד התנועה הוא my-vm.
gcloud network-management vpc-flow-logs-configs update my-config \
--location=global \
--filter-expr="(src_instance.vm_name == 'my-vm' && reporter=='SRC') || (dest_instance.vm_name == 'my-vm' && reporter=='DEST')"
אם הפעלתם את יומני הזרימה של VPC באמצעות Compute Engine API, מריצים את הפקודה הבאה:
gcloud compute networks subnets update my-subnet \
--logging-filter-expr="(src_instance.vm_name == 'my-vm' && reporter=='SRC') || (dest_instance.vm_name == 'my-vm' && reporter=='DEST')"
דוגמה 2. הגבלת איסוף היומנים לחבילות שכתובות ה-IP של המקור שלהן נמצאות ב10.0.0.0/8רשת המשנה
gcloud network-management vpc-flow-logs-configs update my-config \
--location=global \
--filter-expr="inIpRange(connection.src_ip, '10.0.0.0/8')"
אם הפעלתם את יומני הזרימה של VPC באמצעות Compute Engine API, מריצים את הפקודה הבאה:
gcloud compute networks subnets update my-subnet \
--logging-filter-expr="inIpRange(connection.src_ip, '10.0.0.0/8')"
דוגמה 3. הגבלת איסוף היומנים לתעבורת נתונים של מכונות וירטואליות שהיא חיצונית לרשת VPC
gcloud network-management vpc-flow-logs-configs update my-config \
--location=global \
--filter-expr="!(has(src_vpc.vpc_name) && has(dest_vpc.vpc_name))"
אם הפעלתם את יומני הזרימה של VPC באמצעות Compute Engine API, מריצים את הפקודה הבאה:
gcloud compute networks subnets update my-subnet \
--logging-filter-expr="!(has(src_vpc.vpc_name) && has(dest_vpc.vpc_name))"
דוגמה 4. הגבלת איסוף היומנים לצירוף VLAN או למנהרת Cloud VPN ספציפיים, my-gateway
gcloud network-management vpc-flow-logs-configs update my-config \
--location=global \
--filter-expr="dest_gateway.name == 'my-gateway'"
דוגמה 5. הגבלת איסוף היומנים לצירופים ל-VLAN
gcloud network-management vpc-flow-logs-configs update my-config \
--location=global \
--filter-expr="dest_gateway.type == 'INTERCONNECT_ATTACHMENT'"
דוגמה 6. הגבלת איסוף היומנים לרשת VPC ספציפית, my-network
gcloud network-management vpc-flow-logs-configs update my-config \
--location=global \
--filter-expr="src_vpc.vpc_name == 'my-network'"
פתרון בעיות
הקטעים הבאים יכולים לעזור לכם לאבחן בעיות בהגדרת VPC Flow Logs.
נראה שיומני זרימת הנתונים של רשתות משנה מושבתים, למרות שהפעלתם אותם
כשמגדירים רשת משנה ל-proxy בלבד עבור איזון עומסים פנימי של אפליקציות ומשתמשים בפקודה
gcloud compute networks subnetsכדי להפעיל את יומני התנועה של VPC, נראה שהפקודה מצליחה, אבל יומני התנועה לא מופעלים בפועל. הדגל--enable-flow-logsלא משפיע אם משתמשים גם בדגל--purpose=INTERNAL_HTTPS_LOAD_BALANCER.כשמשתמשים במסוף Google Cloud או ב-API כדי להפעיל יומני תנועה, מוצגת הודעת השגיאה: 'הערך 'true' בשדה 'resource.enableFlowLogs' לא תקין'. הוגדר שדה לא תקין ברשת משנה עם המטרה INTERNAL_HTTPS_LOAD_BALANCER."
ברשתות משנה של שרתי proxy בלבד אין מכונות וירטואליות, ולכן אי אפשר להשתמש ביומני זרימה של VPC. זה תקין.