מכסות ומגבלות

בדף הזה מפורטות המגבלות שחלות על השימוש ב-Cloud Logging.

מכסות רישום ביומן ומגבלות שימוש

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

חלק מהערכים מופיעים כערכים לכל פרויקט, אבל בהערה מצוין שהערך חל גם על חשבונות לחיוב, על תיקיות ועל ארגונים, ולא מדובר בהיררכיה. לדוגמה, אם יש לכם כמה Cloud de Confiance פרויקטים בארגון, תוכלו להגדיר עד 200 יעד לכל Cloud de Confiance פרויקט. באותו ארגון, תוכלו גם להגדיר עד 200 יעדים ברמת הארגון.

קטגוריה הערך המקסימלי של המגבלה או
ערך המכסה הראשוני		 הערות
גודל של LogEntry ‫256 KiB המגבלה הזו היא משוערת ומבוססת על גדלי נתונים פנימיים, ולא על הגודל בפועל של בקשת API בארכיטקטורת REST. אי אפשר להגדיל את המכסה.
הגודל של רשומה ביומן הביקורת ‎512 KiB אי אפשר להגדיל את המכסה.
מספר התוויות ‫64 לכל LogEntry אי אפשר להגדיל את המכסה.
האורך של מפתח תווית LogEntry ‫512 B כשנכתבת רשומה ביומן שמשויכים אליה מפתחות תוויות גדולים מדי, Cloud Logging חותך אותם. אי אפשר להגדיל את המכסה.
אורך של ערך התווית LogEntry ‫64 KiB כשערכי תוויות גדולים מדי נכתבים ברשומה ביומן, Cloud Logging מקצר אותם. אי אפשר להגדיל את המכסה.
אורך של שאילתה בשפת השאילתות של רישום ביומן ‫20,000 תווים אי אפשר להגדיל את המכסה.
התפצלות שאילתה 200 קטגוריות

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

מטעמי ביצועים, מומלץ לצמצם את מספר דלי המידע של היומנים וליצור אותם באזור אחד. אם אתם צריכים לעיתים קרובות לשלוח שאילתות לגבי רשומות ביומן שמקורן במשאבים שונים, כדאי להפנות את הרשומות ביומן לכמה מאגרי יומנים מרכזיים.
מספר הכיורים ‫200 לכל Cloud de Confiance פרויקט אפשר להגדיל את המספר הזה ל-4,000. המכסה הזו חלה גם על חשבונות לחיוב, תיקיות וארגונים, והיא לא היררכית.
האורך של מסנן הכללה של אובייקט sink ‫20,000 תווים אי אפשר להגדיל את המכסה.
אורך של מסנן החרגה של sink ‫20,000 תווים אי אפשר להגדיל את המכסה.
מספר מסנני ההחרגה ‫50 לכל כיור

אי אפשר להגדיל את המכסה.

אם אתם צריכים יותר מ-50 מסנני החרגה, כדאי לצמצם את מסנן ההכללה.
מספר המאגרי לוגים ‫100 לכל Cloud de Confiance פרויקט

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

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

אם מגדילים את המספר המקסימלי של קטגוריות ביומן, יכול להיות שתהיה פגיעה בחוויית המשתמש כי אוסף תצוגות יומן (log scope) שמוגדר כברירת מחדל לא יכול לכלול את כל קטגוריות ביומן בפרויקט.
מספר השדות המותאמים אישית שנוספו לאינדקס 20 לכל קטגוריה ביומן

אי אפשר להגדיל את המכסה.

‫Cloud Logging תומך באינדוקס טקסט מלא. לכן לא מומלץ להגדיר אינדוקס מותאם אישית.
מספר תצוגות היומן ‫30 לכל קטגוריה ביומן

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

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

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

‫Logging API מקבל רשומות ביומן עם חותמות זמן ישנות יותר, והרשומות האלה מנותבות ליעדי sink. עם זאת, אם רשומות ביומן עם חותמות זמן ישנות יותר מנותבות לקטגוריה ביומן, הן לא נשמרות.
חותמת זמן עתידית שאפשר לשמור בקטגוריות של יומנים עד יום אחד בעתיד ה-API של Logging דוחה רשומות עם חותמות זמן שחלפו יותר מיום אחד בעתיד ומחזיר שגיאה INVALID_ARGUMENT. אי אפשר להגדיל את המכסה.
מספר היקפי היומן לכל משאב 100 אפשר להגדיל את המספר הזה ל-10,000.
מספר הצפיות ביומן ומספר הפרויקטים שנכללים בהיקף היומן 100 מומלץ שבאוסף תצוגות יומן (log scope) יופיעו תצוגות של יומנים במקום פרויקטים, כשזה אפשרי. הצגת תוצאות של יומן הדפים העסקיים מובילה לקיצור זמן השאילתה ולשיפור הבהירות לגבי הרשומות ביומן שנכללות בשאילתה.
מספר הפרויקטים שכלולים בהיקף היומן 5 מומלץ שבאוסף תצוגות יומן (log scope) יופיעו תצוגות של יומנים במקום פרויקטים, כשזה אפשרי. תצוגות היומן יכולות להיות בפרויקטים שונים.

מכסות ומגבלות של Logging API

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

כדי לראות את המכסות של ה-API, עוברים אל מרכז הבקרה של ה-API, בוחרים API ואז בוחרים באפשרות Quotas (מכסות).

קטגוריה ערך מקסימלי של המגבלה או
ערך מכסת ההתחלה		 הערות
משך החיים של טוקנים של דפים ב-API 24 שעות אי אפשר להגדיל את המכסה.
הגודל של בקשת entries.write ‫10 MB אי אפשר להגדיל את המכסה.
שיעור הבקשות של entries.write, לפי אזור ‫4.8 GB לדקה, לכל Cloud de Confiance פרויקט, באזורים asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1

‫300 MB לדקה, לכל Cloud de Confiance פרויקט, בכל שאר האזורים

אפשר לבקש להגדיל את המכסה.

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

מידע נוסף על המכסות האלה זמין במאמר מכסות להעברת נתונים לפי אזור.

שימוש במסנני החרגה לא מפחית את קצב בקשות הכתיבה, כי רשומות היומן מוחרגות אחרי שליחת הבקשה entries.write.
מספר הבקשות של entries.list ‫60 לדקה, לכל Cloud de Confiance פרויקט

אי אפשר להגדיל את המכסה.

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

כדי לשלוח שאילתות על נפחים גדולים של יומנים, כדאי להשתמש ב-BigQuery APIs. כדי להעביר כמויות גדולות של יומנים, כדאי להשתמש ב-sink ביומן או בהעתקת רשומות ביומן.
מספר שמות המשאבים השונים בפקודה אחת של entries.write 1000

אי אפשר להגדיל את המכסה.

השדה logName של רשומה ביומן מציין את שם המשאב של הרשומה ביומן.
בקשות שליטה לדקה 600

אי אפשר להגדיל את המכסה.

המכסה הזו חלה על כל מה שנכלל גם במכסת הבקשות היומית של בקשות בקרה, וגם על בקשות API למחיקת יומנים ולניהול מדדים שמבוססים על יומנים.
בקשות בקרה ביום ‫1,000 לכל Cloud de Confiance פרויקט

אי אפשר להגדיל את המכסה.

המכסה הזו חלה על בקשות ל-API ליצירה ולעדכון של החרגות ושל מאגרי נתונים.
מספר הפרויקטים או שמות המשאבים האחרים בבקשה אחת של entries.list Cloud de Confiance
100 אי אפשר להגדיל את המכסה.
קצב הייצוא לנושאי Pub/Sub ‫60GB לדקה לכל Cloud de Confiance פרויקט, תיקייה או ארגון שבהם מוגדר יעד ההעברה

אפשר לשלוח בקשת תמיכה להגדלת המכסה. הגדלת המכסה מתבצעת על סמך הזמינות של Pub/Sub.

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

מכסות להעברת נתונים לפי אזור

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

בטבלה הבאה מוצגת מכסת ברירת המחדל לכל אזור:

אזור הטמעת הנתונים ערך ברירת המחדל
‫asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1 ‫4.8 GB לדקה, לכל Cloud de Confiance פרויקט
כל האזורים הנותרים ‫300 MB לדקה, לכל Cloud de Confiance פרויקט

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

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

בדיקת המכסות של Cloud Logging API

כדי לבדוק את המכסות של Cloud Logging API:

  1. במסוף Cloud de Confiance , נכנסים לדף Quotas & System Limits:

    כניסה לדף Quotas & System Limits

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שמופיע בה הכותרת המשנית IAM & Admin.

  2. מסננים את רשימת המכסות של שירות Cloud Logging API.

בקשת שינויים במכסה של Cloud Logging API

אפשר לבקש להגדיל או להקטין את המגבלות של Logging API באמצעות מסוףCloud de Confiance . מידע נוסף זמין במאמר בנושא איך רואים ומנהלים את המכסות.

ניהול ומעקב אחרי המכסות של Cloud Logging API

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

אופטימיזציה של השימוש ב-entries.list

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

  • חשוב לוודא שאתם משתמשים ב-Cloud Logging API בצורה יעילה. מידע נוסף זמין במאמר בנושא אופטימיזציה של השימוש ב-API.

  • אם אתם יודעים מראש שרשומות היומן שאתם רוצים לנתח חורגות מהמכסה של entries.list, אתם יכולים להגדיר sink ביומן כדי לייצא את היומנים ליעד נתמך.

רישום ביומן ביקורת

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

סוג יומן הביקורת גודל מקסימלי
פעילות האדמין ‎512 KiB
גישה לנתונים ‎512 KiB
אירוע מערכת ‎512 KiB
הגישה נדחתה בגלל מדיניות ‎512 KiB

תקופות שמירה של היומנים

תקופות השמירה הבאות של Cloud Logging חלות על קטגוריות של יומנים, ללא קשר לסוגי היומנים שנכללים בקטגוריה או אם הם הועתקו ממיקום אחר. פרטי השמירה הם:

קטגוריה משאבים תקופת ברירת המחדל לשמירה שמירה מותאמת אישית
_Required פרויקט, תיקייה, ארגון ‫400 ימים אי אפשר להגדיר
_Default תיקייה, ארגון 30 ימים אי אפשר להגדיר
_Default פרויקט 30 ימים ניתן להגדרה
בהגדרת המשתמש פרויקט 30 ימים ניתן להגדרה

במקרה של _Default ושל מאגרי יומנים שהוגדרו על ידי המשתמשים ונמצאים בפרויקטים, אפשר להגדיר את Cloud Logging כך שהיומנים יישמרו למשך יום אחד עד400 days. במאמר הגדרת שמירה מותאמת אישית מוסבר איך מגדירים כללי שמירה.

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