Add dotnet-dump (#39)

Co-authored-by: Mohammad Kasaei <[email protected]>
Mohaymen-ICT · Jul 27, 2024 · 02a87bf · 02a87bf
1 parent 5417ebc
commit 02a87bf
Show file tree

Hide file tree

Showing 2 changed files with 55 additions and 1 deletion.
diff --git a/star-docs/onboarding/checklists/debugging/backend/dotnet-tools/dotnet-counters.md b/star-docs/onboarding/checklists/debugging/backend/dotnet-tools/dotnet-counters.md
@@ -1,4 +1,4 @@
-# شهبود کلی نسبت به سرویس از طریق dotnet-counters
+# dotnet-counters
 
 یکی از ابزارهایی که برای بررسی وضعیت کلی سرویس ارائه شده 
 `dotnet-counters`

diff --git a/star-docs/onboarding/checklists/debugging/backend/dotnet-tools/dotnet-dump.md b/star-docs/onboarding/checklists/debugging/backend/dotnet-tools/dotnet-dump.md
@@ -0,0 +1,54 @@
+# dotnet-dump 
+
+برای باگ‌هایی که مسئله‌ی حافظه وجود دارد و می‌خواهیم دقیقا شی‌هایی که در حافظه وجود دارد را مورد بررسی قرار دهیم. از ابزار 
+dotnet-dump
+استفاده می‌کنیم.
+
+## نصب ابزار در سیستم
+برای نصب ابزار در سیستم از دستور زیر استفاده می‌کنیم.
+
+```bash
+dotnet tool install --global dotnet-dump
+```
+
+پس از آن می‌توانیم از دستورات مختلف این ابزار استفاده کنیم.
+
+لینک توضیحات کامل این ابزار در
+[این صفحه](https://learn.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-dump)
+وجود دارد.
+
+## تحلیل لاگ فایل دامپ
+ابزار 
+dotnet-dump
+به شما امکان بررسی فایل‌های دامپ را می‌دهد و می‌توان از راه داده‌های خوبی از فایل استخراج کرد.
+دستورات و امکانات این ابزار در 
+[این سایت](https://learn.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-dump#dotnet-dump-analyze)
+و به صورت مفصل‌تر در
+[این صفحه](https://learn.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-dump#analyze-sos-commands)
+و
+[این صفحه](https://learn.microsoft.com/en-us/dotnet/core/diagnostics/sos-debugging-extension)
+قابل مشاهده است.
+
+## استفاده در محیط عملیاتی
+در لحظه‌ای که سرویس دچار مشکل می‌شود لازم است یک دستوری در کانتینر بزنیم که باعث می‌شود فایل لاگ دامپ تهیه شود.
+در این حالت یک لاگ با اطلاعات مشخصی از حافظه به صورت یک فایل ذخیره می‌شود.
+سپس لازم است فایل را از داخل کانتینر خارج کنیم تا بتوانیم آن‌را تحلیل کنیم.
+
+دستور ساخت فایل دامپ به صورت زیر است.
+
+```bash
+dotnet-dump collect -p 1 
+```
+
+هم‌چنین امکان تعیین نوع لاگ‌گیری و جزئیات آن را در دستور تعیین کرد. که در
+[این لینک](https://learn.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-dump#synopsis-1)
+به صورت مفصل توضیح داده شده است.
+
+در صورت نیاز به انتهای فایل فرمت
+`.dmp`
+را اضافه کنید. پس از آن می‌توان فایل را با 
+Visual studio
+یا ابزارهای دیگر
+باز کرد.
+
+