כדי לשלוח נתוני מעקב ל 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 | 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 באזורים הבאים: 300 MB לכל שאר האזורים. |
מכסה. |
trace.proto.
מגבלות על היקפי מעקב
| מגבלות על היקפי מעקב | ערך |
|---|---|
| המספר המקסימלי של היקפי מעקב לכל פרויקט | 100 |
| מספר הצפיות המקסימלי לכל היקף מעקב | 20 |
תקופות השמירה של נתוני מעקב
| קטגוריה | תקופת שמירה |
|---|---|
Spans שמאוחסנים בקטגוריה _Trace |
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.