# עקבות

Source: https://instatus.com/help/he/observability/traces

עקבה היא בקשה אחת, שעוקבים אחריה דרך כל שירות שהיא נוגעת בו. כל שלב הוא ספאן: קריאת HTTP, שאילתת מסד נתונים, קריאה לשירות אחר. עקבות מראות איפה בקשה איטית בזבזה את זמנה ואיפה בקשה כושלת נשברה.

פתחו את **Observability** ← **עקבות** בדף הסטטוס שלכם. כל שורה היא בקשה אחת.

![סייר העקבות עם משכי הבקשות לאורך זמן ושורה אחת לכל בקשה](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [חיפוש](https://instatus.com/help/he/observability/traces#מציאת-בקשות-איטיות-וכושלות) | status:error, duration:>1s, service: |
| [פתיחה](https://instatus.com/help/he/observability/traces#פתיחת-עקבה) | לחצו על שורה כדי לראות את המפל |
| [תיקון](https://instatus.com/help/he/observability/traces#תיקון-בקשה-כושלת) | העתיקו הנחיית תיקון לסוכן התכנות |
| [יומנים](https://instatus.com/help/he/observability/traces#פתיחת-עקבה) | מעבר ליומנים של בקשה |

עקבות מגיעות ברגע שהאפליקציה שולחת אותן: סמנו את **עקבות** כש[מעתיקים את הנחיית ההגדרה](https://instatus.com/help/he/observability/send-logs#אפשרות-1-העתיקו-הנחיה), או השתמשו במכשור אוטומטי.

## קריאת התרשים

כל נקודה היא בקשה, שממוקמת לפי מתי קרתה וכמה זמן נמשכה. נקודות אדומות נכשלו. מעל התרשים:

- **עקבות**: כמה בקשות החיפוש מצא.
- **שגיאות**: כמה נכשלו, ומה חלקן.
- **p50**,‏ **p95**,‏ **p99**: חצי, 95% ו-99% מהבקשות היו מהירות מהערך הזה.

גררו בתרשים כדי להתקרב לחלון זמן.

## מציאת בקשות איטיות וכושלות

השתמשו בתיבת החיפוש כמו בדף [יומנים](https://instatus.com/help/he/observability/logs#סינון). המסננים האלה מיועדים לעקבות:

| מסנן          | מוצא                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | בקשות שנכשלו                                |
| `duration:>1s`  | בקשות איטיות משנייה. גם `>500ms`,‏ `<100ms` |
| `service:api`   | בקשות ששירות אחד טיפל בהן                     |
| `span.name:`    | ספאנים עם שם מסוים, למשל `GET /v1/users`    |
| כל מאפיין   | למשל `http.route:` או `http.response.status_code:` |

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

כפתור ההורדה מייצא את הרשימה כ-CSV.

## פתיחת עקבה

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

![עקבה שעוברת בשלושה שירותים, עם קריאה איטית ל-Okta בתחתית המפל](https://instatus.com/help/observability/trace-waterfall.png)

בדוגמה הזו טעינת דף נמשכת 842 מילישניות. המפל מראה למה: `web` קורא ל-`api`, ‏`api` קורא ל-`sso`, ו-`sso` מחכה ל-Okta במשך 468 מילישניות.

- לחצו על ספאן כדי לראות את המאפיינים שלו, כמו הנתיב, קוד הסטטוס או שאילתת מסד הנתונים.
- **N יומנים מהספאן הזה ←** פותח את היומנים שנכתבו במהלך הספאן הזה.
- **N יומנים** למעלה פותח כל יומן של הבקשה, בכל השירותים.
- **העתקת מזהה העקבה** מעתיק את המזהה, כדי לשתף אותו או לחפש עם `trace_id:`.
- השתמשו ב-**↑** **↓** או **J** **K** כדי לעבור לעקבה הקודמת או הבאה, וב-**Esc** כדי לסגור.

## תיקון בקשה כושלת

ספאנים שנכשלו מסומנים באדום. **רק שגיאות** מסתיר את הספאנים שעבדו, כך שהכשל בולט גם בעקבה ארוכה.

![בקשה כושלת עם הספאנים השגויים באדום וכפתור להעתקת הנחיית תיקון](https://instatus.com/help/observability/trace-error.png)

**העתקת פרומפט לתיקון** מעתיק תיאור של הבקשה הכושלת: הספאנים, השגיאות והמאפיינים שלהם. הדביקו אותו בסוכן התכנות בפרויקט של האפליקציה, ויהיה לו כל מה שצריך כדי למצוא את הסיבה.

- [מדדים](https://instatus.com/help/he/observability/metrics): גלו מה השתנה, השינוי הגדול ביותר קודם
- [יומנים](https://instatus.com/help/he/observability/logs): חפשו, סננו ועקבו אחרי היומנים בשידור חי
