وقتی یک پاسخ از دریافت ورودی، بازیابی سند و اجرای ابزار عبور می‌کند، یک خطای نهایی علت را نشان نمی‌دهد. شناسه مشترک کمک می‌کند مراحل همان کار به هم وصل شوند. این شناسه نباید حاوی نام، شماره مشتری یا متن سؤال باشد؛ ردیابی را با ذخیره همه اطلاعات خصوصی یکی نکنید.
روش اجرا و تصمیم‌گیری
برای هر کار یک trace و برای مرحله‌های مهم span تعریف کنید. زمان شروع و پایان، وضعیت، شناسه والد و نام عملیات ثبت شوند. مرز شبکه و صف را در نظر بگیرید؛ اگر شناسه در صف گم شود، مرحله پس‌زمینه در گزارش به کار اصلی وصل نمی‌شود.
تلاش مجدد را به عنوان مرحله یا تلاش مشخص نگه دارید. دو درخواست مستقل کاربر را فقط به دلیل متن مشابه ادغام نکنید. زمان انتظار صف، زمان مدل و زمان ابزار را جدا کنید تا کندی یک بخش به بخش دیگر نسبت داده نشود.
دسترسی به گزارش محدود و مدت نگهداری مشخص باشد. برای خطا، کد و نوع کافی است مگر اینکه بررسی ویژه و مجاز به داده بیشتر نیاز داشته باشد. شناسه ردیابی هم اگر به پرونده خصوصی قابل اتصال است، باید با احتیاط مدیریت شود. نمونه‌برداری گزارش را چنان طراحی کنید که خطاهای مهم بی‌خبر حذف نشوند.
نمونهٔ ساختگی و قابل تکرار
در نمونه ساختگی، کار یک trace دارد: دریافت فرم، انتظار صف، جست‌وجوی سند و تولید پاسخ. زمان کل طولانی است اما داده نشان می‌دهد بخش اصلی انتظار در صف بوده، نه مدل. کاربر با شناسه رسید می‌تواند مشکل را گزارش کند و مسئول فنی همان trace را پیدا کند. متن فرم در گزارش عمومی ثبت نشده است. اگر ابزار دوباره اجرا شده، دو span تلاش با علت retry دیده می‌شوند؛ تعداد کار مشتری همچنان یک است.
محدودیت‌ها و خطاهای رایج
ردیابی به تنهایی درستی پاسخ یا امنیت سیستم را ثابت نمی‌کند. ساعت سرویس‌ها و روش محاسبه مدت باید سازگار باشند. همچنین استاندارد OpenTelemetry مفاهیم عمومی را تعریف می‌کند؛ وجود آن در محصول یا اتصال خاص بدون بررسی پیاده‌سازی ادعا نمی‌شود.
کنترل پیش از استفاده
| کنترل | معیار پذیرش |
|---|---|
| پیوستگی | شناسه در عبور از سرویس، صف و ابزار حفظ شود. |
| زمان | انتظار و اجرای فعال هر مرحله جدا ثبت شوند. |
| حریم خصوصی | متن و راز غیرلازم وارد گزارش عمومی نشوند. |
کاربرگ همراه
فایل برای ترسیم مرحله‌ها پیش از ابزارگذاری است. نام عملیات را ثابت و کم‌تنوع انتخاب کنید؛ قرار دادن سؤال کامل در نام span هم گزارش را شلوغ می‌کند و هم ممکن است داده خصوصی را آشکار کند.
دریافت کاربرگ CSV این راهنما — داده‌های داخل فایل نمونهٔ ساختگی‌اند. نسخهٔ اصلی را نگه دارید و برای آزمون خودتان یک کپی بسازید.
منبع و ادامهٔ کار
OpenTelemetry: ردیابی. تاریخ بررسی منابع: ۱ نوامبر ۲۰۲۶.
اگر کاربرد شما پاسخ‌گویی به مشتری است، مسیر مرتبط اپرا را ببینید و مسئله و محدودیت‌های همین کاربرگ را برای بررسی در دمو همراه داشته باشید.