# لاگ‌ها

Source: https://instatus.com/help/fa/observability/logs

در صفحهٔ وضعیت خود **Observability** ← **لاگ‌ها** را باز کنید. تازه‌ترین لاگ‌ها بالا هستند و بالای آن‌ها نموداری از حجم لاگ‌ها قرار دارد. خط قرمز نمودار خطاهاست، پس در یک نگاه می‌بینید مشکل از کی شروع شده.

![کاوشگر لاگ با شمار هر سطح، نمودار حجم و تازه‌ترین لاگ‌ها](https://instatus.com/help/observability/logs.png)

| At a glance | Details |
| :-- | :-- |
| [جست‌وجو](https://instatus.com/help/fa/observability/logs#جستوجو) | کلمه بنویسید، Enter بزنید |
| [فیلتر](https://instatus.com/help/fa/observability/logs#فیلتر) | level:،‏ service:،‏ trace_id: یا هر ویژگی |
| [بازهٔ زمانی](https://instatus.com/help/fa/observability/logs#تغییر-بازهٔ-زمانی) | بازه‌های آماده، سفارشی یا کشیدن روی نمودار |
| [خواندن لاگ](https://instatus.com/help/fa/observability/logs#خواندن-لاگ) | روی یک ردیف کلیک کنید |
| [زنده](https://instatus.com/help/fa/observability/logs#زنده) | L را بزنید |
| [خروجی](https://instatus.com/help/fa/observability/logs#خروجی) | CSV،‏ JSON یا کپی |

## جست‌وجو

کلمه‌ها را در کادر جست‌وجو بنویسید و **Enter** بزنید. کلمه‌ها در هر جای پیام و با هر ترتیبی پیدا می‌شوند. برای یافتن دقیق یک عبارت، آن را در گیومه بگذارید، مثل `"rate limited"`.

نمودار، شمارش‌ها و فهرست همراه با جست‌وجوی شما به‌روز می‌شوند.

![جست‌وجوی یک عبارت در گیومه همراه با فیلتر سرویس](https://instatus.com/help/observability/logs-search.png)

## فیلتر

روی کادر جست‌وجوی خالی کلیک کنید تا ببینید بر اساس چه چیزهایی می‌توانید فیلتر کنید. یک فیلد و سپس یک مقدار انتخاب کنید. هر فیلد رایج‌ترین مقدارهایش را همراه با تعداد تکرار نشان می‌دهد.

![فهرست فیلدهای قابل فیلتر، زیر کادر جست‌وجو](https://instatus.com/help/observability/logs-suggestions.png)

| فیلتر       | پیدا می‌کند                                                                      |
| ------------ | -------------------------------------------------------------------------- |
| `level:`     | یک سطح: `fatal`،‏ `error`،‏ `warn`،‏ `info`،‏ `debug` یا `trace`              |
| `service:`   | لاگ‌های یک سرویس                                                      |
| `trace_id:`  | همهٔ لاگ‌های یک درخواست در همهٔ سرویس‌ها                            |
| هر ویژگی | نامش را بنویسید، مثل `http.route:` یا `customer.id:`                    |

هر فیلتر به یک برچسب در کادر جست‌وجو تبدیل می‌شود. برای حذف، روی **×** آن کلیک کنید. برای مستثنا کردن، پیش از فیلتر `-` بگذارید، مثل `-level:debug`.

### فیلتر بر اساس سطح

برای باز کردن انتخابگر سطح، `level:` را بنویسید. نشان می‌دهد هر سطح چند لاگ دارد. برای انتخاب چند سطح **فاصله** و سپس **Enter** را بزنید. دو میان‌بر حالت‌های رایج را پوشش می‌دهند: `level:>=warn` هشدارها و موارد جدی‌تر را نگه می‌دارد و `-level:debug` لاگ‌های اشکال‌زدایی را پنهان می‌کند.

![انتخابگر سطح با شمار هر سطح و دو میان‌بر](https://instatus.com/help/observability/logs-levels.png)

دکمهٔ **سرویس** کنار کادر جست‌وجو میان‌بری برای `service:` است. کلیک روی یک سطح بالای نمودار آن را روشن یا خاموش می‌کند.

### نحو جست‌وجو

| بنویسید                                  | پیدا می‌کند                                       |
| -------------------------------------- | ------------------------------------------- |
| `timeout`                              | لاگ‌هایی که کلمه را دارند                  |
| `"connection pool"`                    | دقیقاً همین عبارت                           |
| `timeout retry`                        | هر دو کلمه، با هر ترتیبی                    |
| `timeout OR refused`                   | یکی از دو کلمه                                 |
| `-timeout` یا `NOT timeout`            | لاگ‌هایی که کلمه را ندارند                       |
| `level:error service:api`              | هر دو فیلتر                                |
| `(timeout OR refused) AND service:api` | گروه‌بندی با پرانتز                    |
| `service:"billing worker"`             | مقداری با فاصله، در گیومه              |

`AND`،‏ `OR` و `NOT` با حروف بزرگ نوشته می‌شوند. اگر جست‌وجو قابل خواندن نباشد، مثلاً چون گیومه بسته نشده، کاوشگر این را اعلام می‌کند و نتایج قبلی را نگه می‌دارد.

جست‌وجوهای اخیر شما با باز کردن کادر جست‌وجو نمایش داده می‌شوند، پس جست‌وجوی پرکاربرد یک کلیک فاصله دارد.

## تغییر بازهٔ زمانی

روی دکمهٔ بازهٔ زمانی کلیک کنید تا از ۱۵ دقیقهٔ اخیر تا ۷ روز اخیر را انتخاب کنید، یا با **از** و **تا** یک بازهٔ سفارشی تعیین کنید.

![منوی بازهٔ زمانی با بازه‌های آماده و بازهٔ سفارشی](https://instatus.com/help/observability/logs-time-range.png)

برای بزرگ‌نمایی یک جهش، روی نمودار از رویش بکشید. دکمهٔ بازگشت شما را به بازهٔ قبلی برمی‌گرداند.

## خواندن لاگ

روی یک ردیف کلیک کنید، یا با **↑** **↓** به آن بروید و **Enter** بزنید. پنل جزئیات باز می‌شود و این‌ها را دارد:

- متن کامل پیام، همراه با **کپی پیام**.
- **لاگ‌های مشابه**، برای جست‌وجوی پیام‌های مشابه.
- **N لاگ در این ردیابی ←**، وقتی لاگ متعلق به یک درخواست باشد. همهٔ لاگ‌های آن درخواست را در همهٔ سرویس‌ها نشان می‌دهد.
- ویژگی‌های لاگ و منبع آن (سرویس، میزبان و نسخه‌ای که از آن آمده). روی یک مقدار کلیک کنید تا بر اساسش فیلتر کنید، مستثنایش کنید یا کپی‌اش کنید.

![لاگ خطایی که در پنل جزئیات باز شده، با پیام، پیوند ردیابی و ویژگی‌هایش](https://instatus.com/help/observability/logs-detail.png)

پیکان‌های بالای پنل به لاگ قبلی و بعدی می‌روند.

## زنده

**L** را بزنید یا روی **زنده** کلیک کنید تا لاگ‌ها را همان لحظهٔ رسیدن ببینید. لاگ‌های جدید بالا می‌آیند و سرصفحه نشان می‌دهد در هر ثانیه چند لاگ می‌رسد. جست‌وجو و فیلترها همچنان اعمال می‌شوند، پس `level:error` در حالت زنده یک جریان زندهٔ خطاهاست.

![نمایش زنده با لاگ‌های تازه‌ای که می‌رسند و نرخ در هر ثانیه](https://instatus.com/help/observability/logs-live.png)

برای توقف، روی دکمهٔ مکث کلیک کنید یا دوباره **L** را بزنید. نمودار بازهٔ زمانی پیش از حالت زنده را حفظ می‌کند. اگر لاگ‌ها سریع‌تر از توان نمایش برسند، پیامی اطلاع می‌دهد: مکث کنید و جست‌وجو کنید تا همه را ببینید.

## خروجی

لاگ‌های موردنظر را با کادرهای انتخاب علامت بزنید. بالای فهرست نواری با **خروجی CSV**،‏ **خروجی JSON** و **کپی** ظاهر می‌شود.

![سه لاگ انتخاب‌شده با دکمه‌های خروجی CSV و JSON و کپی بالای فهرست](https://instatus.com/help/observability/logs-export.png)

دکمهٔ دانلود در انتهای نوار جست‌وجو همهٔ لاگ‌های بارگذاری‌شده در فهرست را با فرمت CSV خروجی می‌گیرد. خروجی‌ها زمان، سرویس، سطح و پیام هر لاگ را دارند. برای گرفتن ویژگی‌های یک لاگ، آن را باز کنید و در پنل جزئیات از **کپی به‌صورت JSON** استفاده کنید.

## میان‌برهای صفحه‌کلید

| کلید               | کاربرد                                 |
| ----------------- | ------------------------------------ |
| `↓` `↑` یا `J` `K` | جابه‌جایی بین لاگ‌ها                   |
| `Enter`           | باز کردن لاگ انتخاب‌شده                |
| `Esc`             | بستن پنل جزئیات یا منو      |
| `L`               | شروع یا توقف نمایش زنده              |
| `Space`           | انتخاب چند مقدار در انتخابگر      |

- [ردیابی‌ها](https://instatus.com/help/fa/observability/traces): ببینید هر درخواست وقتش را کجا صرف می‌کند
- [داشبوردها](https://instatus.com/help/fa/observability/dashboards): عددهای مهم‌تان در یک صفحه
