tailspin

ملف السجل المضيق

سمات

• عرض (أو tail ) أي ملف سجل لأي تنسيق

• لا يوجد إعداد أو تكوين مطلوب

• يسلط الضوء على الأرقام والتواريخ و IP-Addresses و UUIDs وعنوان URL والمزيد

• جميع المجموعات المميزة قابلة للتخصيص

• من السهل الاندماج مع الأوامر الأخرى

• يستخدم less تحت الغطاء

• مدعوم من قفص manifold

جدول المحتويات

• ملخص

• الاستخدام

• التثبيت

• تسليط الضوء على المجموعات

• مشاهدة المجلدات

• تخصيص مجموعات تسليط الضوء

• العمل مع stdin و stdout

• باستخدام النداء less

• إعدادات

---

ملخص

يعمل tailspin من خلال القراءة من خلال سطر ملف السجل سطرًا ، وتشغيل سلسلة من regexes مقابل كل سطر. تتعرف regexes على الأنماط التي تتوقع أن تجدها في ملفات تسجيل ، مثل التواريخ والأرقام والكلمات الرئيسية للشدة والمزيد.

لا يقوم tailspin بأي افتراضات على تنسيق أو موضع العناصر التي تريد تسليط الضوء عليها. لهذا السبب ، لا يتطلب أي تكوين وسيعمل تسليط الضوء باستمرار عبر ملفات سجل مختلفة.

الاستخدام

الاسم الثنائي لـ tailspin هو tspin .

 # اقرأ من الملف والعرض في `less`tspin application.log# قراءة من الملف والطباعة إلى stdouttspin application.log -print# قراءة من stdin وطباعة إلى stdoutkubectl logs [pod name] -follow | TSPIN# التقاط stdout لأمر آخر وعرض في `less`tspin -القائم على القبل" kubectl logs -f pod_name '

التثبيت

مديري الحزم

 # homebrewwrew تثبيت tailspin# cargocargo تثبيت Tailspin# Archlinuxpacman -S tailspin# nixnix -shell -p tailspin# netbsdpkgin تثبيت tailspin# freebsdpkg تثبيت tailspin

من المصدر

 تثبيت البضائع -مسار.

سيتم وضع ثنائي في ~/.cargo/bin ، تأكد من إضافة المجلد إلى متغير بيئة PATH .

مهم

عند البناء من المصدر ، تأكد من أنك تستخدم أحدث إصدار من less .

تسليط الضوء على المجموعات

بلح

الكلمات الرئيسية

عناوين URL

أرقام

عناوين IP

يقتبس

مسارات ملف UNIX

أساليب HTTP

uuids

أزواج القيمة الرئيسية

عناوين المؤشر

عمليات UNIX

مشاهدة المجلدات

يمكن أن يستمع tailspin لإدخالات الخط الجديد في مجلد معين. تعد مشاهدة المجلدات مفيدة لمراقبة ملفات السجل التي يتم تدويرها.

عند مشاهدة المجلدات ، سيبدأ tailspin في وضع المتابعة (إحباط مع Ctrl + C ) وسيقوم فقط بطباعة إدخالات الخط الجديد والتي تصل بعد البداية الأولية.

تخصيص مجموعات تسليط الضوء

ملخص

إنشاء theme.toml في ~/.config/tailspin لتخصيص مجموعات تسليط الضوء.

الأنماط لها الشكل التالي:

 style = {fg = "color" ، bg = "color" ، italic = false ، bold = false ، endline = false}

لتحرير مجموعات الضوء المختلفة ، قم بتضمينها في ملف theme.toml الخاص بك. على سبيل المثال ، لتحرير مجموعة تسليط الضوء على date ، أضف ما يلي إلى theme.toml :

 [التاريخ] النمط = {fg = "الأخضر"}

قم بتوسيع القسم أدناه للاطلاع على التكوين الافتراضي لمجموعات الضوء:

إعدادات مجموعات تسليط الضوء الافتراضي

 [Date] Date = {fg = "magenta"} time = {fg = "blue"} Zone = {fg = "red"

[[الكلمات الرئيسية]] الكلمات = ['null' ، 'true' ، 'false'] style = {fg = "red" ، italic = true}

[[الكلمات الرئيسية]] الكلمات = ['get'] style = {fg = "black" ، bg = "green"}

[url] http = {fg = "red" ، faint = true} https = {fg = "green" ، faint = true} host = {fg = "blue" ، faint = true} path = {fg = "blue" } query_params_key = {fg = "magenta"} query_params_value = {fg = "cyan"} = {fg = "red"}

[Number] style = {fg = "cyan"}

[IP] number = {fg = "blue" ، italic = true} eleft = {fg = "magenta" ، italic = true} separator = {fg = "red"}

[quotes] style = {fg = "yellow"} token = '"' '[path] segment = {fg =" green "، italic = true} separator = {fg =" yellow "}

[uuid] number = {fg = "blue" ، italic = true} letter = {fg = "magenta" ، italic = true} separator = {fg = "red"}

[pointer] number = {fg = "blue" ، italic = true} eleft = {fg = "magenta" ، italic = true} separator = {fg = "red"}

[key_value] key = {faint = true} فاصل = {fg = "white"}

[Process] name = {fg = "green"} separator = {fg = "red"} id = {fg = "yellow"}

[json] key = {fg = "yellow"} quote_token = {fg = "yellow" ، faint = true} curly_bracket = {fint = true} square_bracket = {pint = true} comma = {pint = true} colon = {{fint = صحيح}

تعطيل مجموعات تسليط الضوء

لتعطيل أو تمكين مجموعات تسليط الضوء بشكل فردي ، استخدم الأعلام --enable و --disable :

 # قم بتمكين مجموعة تمييز عنوان URL فقط ، مما يؤدي إلى تعطيل تطبيق RESTTSPIN.

إضافة كلمات رئيسية عبر theme.toml

لإضافة كلمات رئيسية مخصصة ، إما تضمينها في قائمة الكلمات الرئيسية أو إضافة إدخالات جديدة:

 [[الكلمات الرئيسية]] الكلمات = ['myCustomKeyword'] style = {fg = "green"}

[[الكلمات الرئيسية]] الكلمات = ['null' ، 'true' ، 'false'] style = {fg = "red" ، italic = true}

إضافة كلمات رئيسية من سطر الأوامر

في بعض الأحيان يكون من المناسب إضافة مجموعات تمييز على الطيران دون الحاجة إلى تعديل تومل. لإضافة النقاط البارزة من سطر الأوامر ، استخدم --words-[red|green|yellow|blue|magenta|cyan] علامة تليها قائمة مفصولة بالكلمات المراد تسليط الضوء عليها.

مخصص regex Highlighters

عندما تحتاج إلى مزيد من التحكم في التمييز ، يمكنك استخدام REGEX Highlighter. يتيح لك هذا المتكافئ تحديد إعادة تطبيق regex وأسلوب على النص المتطابق.

وهو يدعم مجموعة واحدة من التقاط () . عند العثور عليها ، سيتم تطبيق النمط على النص الذي تم التقاطه.

 [[regexps]] regex = 'chation (.*).' style = {fg = "red"}

العمل مع stdin و stdout

السلوك الافتراضي مع الأنابيب

بشكل افتراضي ، سيفتح tailspin ملفًا في Pager less . ومع ذلك ، إذا قمت بتنشيط شيء ما في tailspin ، فسيقوم بطباعة الإخراج المميز مباشرة إلى stdout . هذا مشابه لتشغيل tspin [file] --print .

للسماح tailspin تسليط الضوء على سجلات الأوامر المختلفة ، يمكنك تنشيط إخراج تلك الأوامر في tailspin مثل:

 Journalctl -f | tspincat/var/log/syslog | TSPinkUcubectl سجلات -f pod_name | tspin

التقاط إخراج الأمر ومشاهدته less

لالتقاط إخراج الأمر وعرضه less ، استخدم العلم --listen-command :

 Tspin -Listen -Command 'Kubectl logs -f pod_name'

سيؤدي ذلك إلى تشغيل Command kubectl logs -f pod_name في الخلفية وتنشيط الإخراج إلى tailspin . سيتم عرض الإخراج less ، مما يتيح لك التنقل والبحث من خلال السجلات.

باستخدام النداء less

ملخص

يستخدم tailspin less كـ Pager لعرض ملفات السجل المميزة. يمكنك الحصول على مزيد من المعلومات حول less عبر أمر MAN ( man less ) أو عن طريق الضغط على زر H للوصول إلى شاشة المساعدة.

التنقل

يستخدم التنقل في ضمن less مجموعة من المنافع الرئيسية التي قد تكون مألوفة لمستخدمي vim أو غيرهم من المحررين الذين يشبهون vi . فيما يلي نظرة عامة موجزة على أوامر التنقل الأكثر فائدة:

• J / K : قم بتمرير خط واحد لأعلى / لأسفل

• D / u : قم بالتمرير لنصف صفحة لأعلى / لأسفل

• G / G : انتقل إلى أعلى / أسفل الملف

متابعة الوضع

عندما تقوم بتشغيل tailspin مع علامة -f أو --follow ، سيتم التمرير إلى الأسفل وطباعة خطوط جديدة على الشاشة عند إضافتها إلى الملف.

للتوقف عن متابعة الملف ، مقاطعة مع Ctrl + C. سيؤدي ذلك إلى إيقاف الخلاف ، ولكن الحفاظ على فتح الملف ، مما يتيح لك مراجعة المحتوى الحالي.

لاستئناف اتباع الملف من داخل less ، اضغط على Shift + F.

يبحث

استخدم / متبوعًا باستعلام البحث. على سبيل المثال ، /ERROR يجد الحدوث الأول للخطأ .

بعد البحث ، يجد N المثيل التالي ، ويجد N المثيل السابق.

تصفية

يسمح less بتصفية خطوط بكلمة رئيسية ، باستخدام النمط ويتبعه . على سبيل المثال ، يعرض &ERROR خطوطًا فقط مع خطأ .

لإظهار الخطوط التي تحتوي فقط على ERROR أو WARN ، استخدم تعبيرًا منتظمًا: &(ERROR|WARN) .

لمسح المرشح ، والاستخدام وبدون نمط.

إعدادات

 -F ،-متابع ، اتبع محتويات الملف ،-بدء التشغيل في نهاية الملف ،-طباعة المخرجات إلى stdout-c ،-القبض "[[[ cmd] 'استمع إلى الإخراج (stdout) للأمر المقدم-مسار المبارز [المسار] استخدم ملف التكوين من المسار المقدم-الكلمات-[لون] [الكلمات] يبرز الكلمات المقدمة باللون المحدد -لا تبرز كلمات المفاتيح-لا بنيتين ، تسليط الضوء على المنطق ، الخالية ، شدة السجل ، أفعال الراحة الشائعة-القابلة للتنفيذ = [ALMINESS_GROUP] تمكين مجموعة أو أكثر من المجموعات المميزة ، مما يؤدي إلى تعطيل الباقي-DISICAB مجموعات ، تمكين البقية