‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

מכסות ומגבלות של 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 קריאות ל-API של ListTraces ו-50 קריאות ל-API של GetTrace בכל 60 שניות.

קטגוריה	סך כל יחידות המכסה
פעולות קריאה¹	‫300 ל-60 שניות
פעולות כתיבה²	‫4,800 כל 60 שניות
טווחים שהועברו^3,4	‫3,000,000 ביום עד 5,000,000,000 ביום

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

מגבלות

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

תיאור	ערך
מספר הטווחים המקסימלי לכל `GetTrace` שיחה	10,000
מספר הטווחים המקסימלי לכל `PatchTraces` שיחה	25,000
מספר המעקבים המקסימלי לכל שיחה ב-`ListTraces`	‫1,000 בתצוגות `ROOTSPAN` ו`MINIMAL` ‫100 בתצוגה `COMPLETE`
אורך מקסימלי של שם span	‫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.

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