כדי לשלוח נתוני מעקב ל 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 שניות.
| קטגוריה | סך כל יחידות המכסה |
|---|---|
| פעולות קריאה1 | 300 ל-60 שניות |
| פעולות כתיבה2 | 4,800 כל 60 שניות |
| טווחים שהועברו3,4 | 3,000,000 ביום עד 5,000,000,000 ביום |
1 פעולות קריאה כוללות את GetTrace, ListTraces,
ListSpan. שיחה אל ListTraces צורכת 25 יחידות מכסה. שיחות אל GetTrace צורכות ListSpan יחידת מכסה אחת.
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 וMINIMAL100 בתצוגה COMPLETE |
| אורך מקסימלי של שם span | 128 בייטים |
| מספר התוויות או המאפיינים המקסימלי לכל יחידה לוגית למעקב | 32 |
| הגודל המקסימלי של מפתח לתווית או למאפיין | 128 בייטים |
| הגודל המקסימלי של ערך של תווית או מאפיין | 256 בייטים |
| מספר האירועים המקסימלי לטווח | 128 |
| חותמת הזמן המקסימלית בעבר של טווח שניתן להעביר | 14 ימים |
| חותמת הזמן המקסימלית בעתיד של טווח זמן שניתן להעברה | 3 ימים |
| חותמת הזמן המקסימלית של אירוע ביחס לחותמת הזמן של יחידה לוגית למעקב | 365 ימים |
חריגה ממגבלה לא תמיד גורמת לכך שקריאה ל-API תיכשל עם שגיאה. לדוגמה, לא מדווחת שגיאה כשמספר המאפיינים שמצורפים לטווח חורג מ-32. במקום זאת, בתרחיש הזה, Cloud Trace API משתמש באלגוריתם לא דטרמיניסטי כדי לבחור 32 מאפיינים להעברה. המערכת מתעלמת משאר המאפיינים.
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 באזורים הבאים: 300 MB לכל שאר האזורים. |
מכסה. |
trace.proto.
מגבלות על היקפי מעקב
| מגבלות על היקפי מעקב | ערך |
|---|---|
| המספר המקסימלי של היקפי מעקב לכל פרויקט | 100 |
| מספר הצפיות המקסימלי לכל היקף מעקב | 20 |
תקופות השמירה של נתוני המעקב
| קטגוריה | תקופת שמירה |
|---|---|
| נתוני Span שאוחסנו על ידי Cloud Trace | 30 ימים |
_Trace bucket |
30 ימים |
ניהול המכסה
בקטע הזה מוסבר איך לבקש שינוי במכסה ואיך לעקוב אחרי ניצול המכסה.
בקשה לשינוי המכסה של Cloud Trace API
אפשר לבקש להגדיל או להקטין את המגבלות של Cloud Trace API באמצעות מסוףGoogle Cloud . מידע נוסף זמין במאמר בנושא איך רואים ומנהלים את המכסות.
אם מופיעה שגיאה Edit is not allowed for this quota, אפשר לפנות לתמיכה כדי לבקש שינויים במכסת השימוש. חשוב גם לזכור שצריך להפעיל את החיוב בפרויקטGoogle Cloud כדי לסמן את תיבות הסימון.
מעקב אחרי השימוש במכסה
כדי לוודא שלא תחרגו מהמכסה ותאבדו את היכולת לעקוב אחרי הביצועים של האפליקציות, חשוב לוודא שאתם מעדכנים את המכסה בקבוצות ועוקבים אחרי נפח השימוש במכסה. לדוגמה, אפשר ליצור מדיניות התראות שתשלח לכם התראה כשהשימוש שלכם חורג מסף מסוים. למידע מפורט על מעקב אחרי בקשות ה-API והבנת התגובות שלהן, אפשר לעיין במאמר בנושא מעקב אחרי השימוש ב-API.
כדי לראות את המכסות שלכם ב-Cloud Trace API ואת מכסות הטמעת הנתונים היומיות של יחידות לוגיות למעקב, אפשר לעיין במאמר הצגה וניהול של מכסות.
במאמר הגבלת השימוש מוסבר איך להקטין את מכסת יחידות ה-API ואת מכסת יחידות הטמעת הנתונים של יחידה לוגית למעקב יומית.
כדי לבקש להגדיל את יחידות המכסה של ה-API או את מכסות ההטמעה של טווח הזמן היומי, אפשר לעיין במאמר בנושא בקשה להגדלת מכסה.
במאמר יצירת התראה על חריגה ממכסת השימוש מוסבר בפירוט איך ליצור מדיניות התראות כדי לעקוב אחרי מכסת השימוש בממשק Trace API ואחרי קצב ההעברה של יחידה לוגית למעקב של Trace.