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

ב-Cloud Trace יש מכסות לקצב הגשת הבקשות, מגבלות על הטמעת span ותקופות שמירת נתונים, שתלויות בשאלה אם אתם שולחים נתוני מעקב באמצעות Telemetry (OTLP) API או באמצעות Cloud Trace API. חשוב להבין את הספים האלה כדי לעקוב אחרי השימוש, וכך לא לאבד את הניראות של האפליקציות.

מכסות ומגבלות ב-Trace API

בקטע הזה מפורט מידע על המכסות והמגבלות שחלות רק על Trace API. המכסות והמגבלות שמפורטות בקטע הזה לא חלות על Telemetry API.

ב-Cloud Trace יש שני סוגים שונים של מכסות: מכסה לקצב הגשת בקשות ל-Cloud Trace API, ומכסת הטמעה של span שנשלחים ל-Trace.

מכסות

בטבלה הבאה מפורטות יחידות המכסה שזמינות לפעולות קריאה וכתיבה, והמכסה היומית להטמעת span ב-Trace API. לדוגמה, יש לכם סך של 300 קריאות ל-60 שניות לשלוש פקודות ה-API‏ GetTrace,‏ ListTraces ו-ListSpan. הנה שתי דוגמאות שונות לשימוש בכל יחידות המכסה הזמינות:

  • לבצע 12 קריאות ל-API של ListTraces כל 60 שניות.
  • לבצע 10 קריאות ל-API של ListTraces ו-50 קריאות ל-API של GetTrace כל 60 שניות.
קטגוריה סה"כ יחידות מכסה
פעולות קריאה1 ‫300 ל-60 שניות
פעולות כתיבה2 ‫4,800 ל-60 שניות
טווחים שהוטמעו3,4 ‫3,000,000 עד 5,000,000,000 ביום

1 פעולות קריאה כוללות את GetTrace,‏ ListTraces ו-ListSpan. קריאה ל-ListTraces צורכת 25 יחידות מכסה. קריאות ל-GetTrace צורכות יחידת מכסה אחת (ListSpan). שאילתות וצפייה במעקבים באמצעות Trace Explorer במסוף Google Cloud לא צורכות את המכסה הזו.
2 פעולות כתיבה כוללות את PatchTraces,‏ BatchWrite ו-CreateSpan. כל פעולת כתיבה צורכת יחידת מכסה אחת.
‫3 המכסה הזו חלה רק על טווחי זמן שהוטמעו באמצעות Cloud Trace API. אין הגבלה על הטמעת נתונים דרך Telemetry API. ‫4 המכסה היומית להטמעת טווחי מעקב ב-Cloud Trace API נקבעת לפי ההיסטוריה של החשבון לחיוב ובקשות להגדלת המכסה.

מגבלות

בטבלה הזו מפורטות המגבלות של Cloud Trace API.

תיאור ערך
מספר הטווחים המקסימלי לכל קריאה ל-GetTrace 10,000
מספר הטווחים המקסימלי לכל קריאה ל-PatchTraces 25,000
מספר המעקבים המקסימלי לכל קריאה ל-ListTraces ‫1,000 בתצוגות ROOTSPAN ו-MINIMAL
100 בתצוגה COMPLETE
האורך המקסימלי של שם span ‫1,024 בייטים
מספר מקסימלי של תוויות או מאפיינים לכל span 1024
הגודל המקסימלי של מפתח לתווית או למאפיין ‫512 בייטים
הגודל המקסימלי של ערך לתווית או למאפיין ‫65,532 בייטים
מספר האירועים המקסימלי לכל טווח זמן 256
חותמת הזמן המקסימלית בעבר להטמעת טווח 14 ימים
חותמת הזמן המקסימלית בעתיד שבה אפשר להטמיע span 3 ימים
חותמת הזמן המקסימלית בעבר לאירוע ביחס לחותמת הזמן של הטווח 365 ימים

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

ב-Cloud Trace API מפורטים פרטים על נקודות הקצה GetTrace,‏ PatchTraces ו-ListTraces.

האופן שבו מוסיפים הערות ליחידות לוגיות למעקב תלוי בנקודת קצה ל-API של Cloud Trace. אם אתם משתמשים בנקודת הקצה batchWrite, אתם צריכים להוסיף מאפיינים לאובייקט Span. אם אתם משתמשים בנקודת הקצה patchTraces, הוסיפו תוויות לאובייקט TraceSpan.

מגבלות ומכסות ב-Telemetry API

בקטע הזה מפורטות המגבלות שחלות רק כשמשתמשים ב-Telemetry API כדי להטמיע נתוני מעקב. ‫Telemetry API, שמטמיע את OpenTelemetry OTLP API, מיועד לשימוש עם אפליקציות שמשודרגות באמצעות אחת מערכות ה-SDK של OpenTelemetry. המגבלות שמפורטות בקטע הזה לא חלות על Cloud Trace API.

תיאור ערך נתונים
הגודל המקסימלי של מפתחות מאפיינים ‫512 בייטים מגבלה.
הגודל המקסימלי של ערכי מאפיינים ‎64 KiB מגבלה.
הגודל המקסימלי של שם אובייקט Span* ‫1,024 בייטים מגבלה.
המספר המקסימלי של מאפיינים שמצורפים לאובייקט Span* 1024 מגבלה.
מספר מקסימלי של מאפייני משאבים לכל אובייקט ResourceSpans* 1024 מגבלה.
מספר המאפיינים המקסימלי לכל אובייקט ResourceSpan*
כולל מאפיינים שמצורפים לאובייקטים צאצאים מהסוגים הבאים:
Resource,‏ Span,‏ ScopeSpans,‏ Event ו-Link.		 8192 מגבלה.
המספר המקסימלי של אובייקטים מסוג Event* לכל אובייקט מסוג Span* 256 מגבלה.
המספר המקסימלי של אובייקטים מסוג Link* לכל אובייקט מסוג Span* 128 מגבלה.
הגודל המקסימלי של שם אובייקט Event* ‫1,024 בייטים מגבלה.
מספר המאפיינים המקסימלי לכל אובייקט Event* 1024 מגבלה.
מספר המאפיינים המקסימלי לכל אובייקט Link* 1024 מגבלה.
הגודל המקסימלי של כתובות URL של סכימות ‫8,192 בייטים מגבלה.
מספר מקסימלי של בייטים להטמעת מעקב לדקה

‫2.4GB באזורים הבאים: asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1.

‫300MB בכל שאר האזורים.

 מכסה.
*  ההגדרה של המבנה הזה מופיעה בקובץ trace.proto.

מגבלות על היקפי מעקב

מגבלות על היקפי מעקב ערך
המספר המקסימלי של היקפי מעקב לכל פרויקט 100
מספר התצוגות המקסימלי לכל היקף מעקב 20

תקופות השמירה של נתוני המעקב

קטגוריה תקופת שמירה
פרקי זמן שמאוחסנים בקטגוריה _Trace 30 ימים

ניהול המכסות

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

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

כדי לבדוק אם אתם יכולים לבקש להגדיל או להקטין את מכסת בקשות ה-API של Cloud Trace באמצעות מסוף Google Cloud , נכנסים לדף Quotas & System Limits ומחפשים את המכסה הרלוונטית.

  • אם המכסה לא מופיעה ברשימה או אם ביקשתם עדכון של המכסה וקיבלתם את השגיאה Edit is not allowed for this quota, פנו ל-Cloud Customer Care ובקשו לשנות את המכסה. כדי לערוך את המכסות במסוף Google Cloud , צריך להפעיל את החיוב בפרויקטGoogle Cloud .

מעקב אחרי ניצול המכסות

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

  • כדי לראות את המכסות של Cloud Trace API ושל הטמעת הטווחים היומית, קראו את המאמר הצגה וניהול של מכסות.

  • במאמר הגבלת השימוש מוסבר איך להקטין את יחידות המכסה של ה-API ואת יחידות המכסה היומית של הטמעת ה-span.

  • כדי לבקש להגדיל את מכסת היחידות של ה-API או את מכסת הטמעת ה-span היומית, קראו את המאמר בקשה להגדלת המכסה.

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

שאילתות בנפח גבוה

כדי לשלוח שאילתות בנפח גבוה על נתוני המעקב, צרו מערך נתונים מקושר ב-BigQuery והשתמשו ב-BigQuery API.

אל תשתמשו ב-Cloud Trace API לשאילתות בנפח גבוה, כי הקריאות ל-Trace API מוגבלות בקצב.