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

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

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

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

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

מכסות

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

  • לשלוח 12 קריאות ל-API של ListTraces כל 60 שניות.
  • שליחת 10 ListTraces קריאות ל-API ו-50 GetTrace קריאות ל-API כל 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
האורך המקסימלי של שם טווח ‫1,024 בייטים
מספר התוויות או המאפיינים המקסימלי לכל יחידה לוגית למעקב 1024
הגודל המקסימלי של מפתח לתווית או למאפיין ‫512 בייטים
הגודל המקסימלי של ערך לתווית או למאפיין ‫65,532 בייטים
מספר האירועים המקסימלי לטווח 256
חותמת הזמן המקסימלית בעבר של טווח שניתן להעביר 14 ימים
חותמת הזמן העתידית המקסימלית של טווח שניתן להעביר 3 ימים
חותמת הזמן המקסימלית בעבר של אירוע ביחס לחותמת הזמן של טווח 365 ימים

חריגה ממגבלה לא בהכרח תגרום לכך שקריאה ל-API תיכשל עם שגיאה. לדוגמה, לא מדווחת שגיאה כשמספר המאפיינים שמצורפים ליחידה לוגית למעקב חורג מ-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.4 GB באזורים הבאים: asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1.

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

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

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

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

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

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

ניהול המכסה

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

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

כדי לבדוק אם אפשר לבקש להגדיל או להקטין את המכסה של Cloud Trace API באמצעות מסוף 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 ואת מכסת יחידות הטמעת הנתונים של יחידה לוגית למעקב יומית.

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

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

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

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

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