عیب یابی استقرار عمومی

این سند خلاصه ای از مسائل و قطعنامه های عیب یابی استقرار مشترک است. برخی از این پیشنهادات را می توان به طور مستقیم انجام داد و برخی دیگر ممکن است نیاز به مشاوره از مدیر شبکه شما داشته باشند.

شروع مهم در بوت سیستم

برای اینکه موضوع سرور در بوت سیستم شروع شود، فایل واحد سیستم باید فعال شود. دستور زیر را اجرا کنید:

sudo systemctl enable mattermost.service

sudo systemctl enable mattermost.service

اگر پایگاه داده شما در همان سیستم به عنوان مهم ترین سرور شما است، توصیه می کنیم پیش فرض را ویرایش کنید /lib/systemd/system/mattermost.service فایل واحد سیستم برای اضافه کردن After=postgresql.service و BindsTo=postgresql.service به [Unit] بخش.

اجرای Mattermost بدون پروکسی

مهم ترین اتصال به 443 به جای 8065. مهم ترین باینری نیاز به مجوزهای صحیح برای انجام این اتصال دارد. شما باید فعال کنید CAP_NET_BIND_SERVICE قابلیت اجازه می دهد که مواد جدید باینری برای اتصال به پورت های پایین تر از 1024 با اجرای دستور زیر:

sudo setcap cap_net_bind_service=+ep ./mattermost/bin/mattermost

sudo setcap cap_net_bind_service=+ep ./mattermost/bin/mattermost

یادداشت

ما به شدت توصیه می کنیم از یک پروکسی در مقابل سرور Mattermost برای حداکثر 200 کاربر همزمان استفاده کنید. اگر کمتر از ۲۰۰ کاربر همزمان دارید، می توانید TLS را راه اندازی کنید. اگر شما بیش از 200 کاربر همزمان هستید، برای مدیریت ترافیک به یک پروکسی مانند NGINX در مقابل Mattermost نیاز خواهید داشت.

بررسی دقیق ترین سیاهه‌های مربوط

شما می توانید برای Mattermost به گزارش ها دسترسی داشته باشید و از آنها برای عیب یابی استفاده کنید. این مراحل فرض می کنند که شما مجوزهای مدیر سیستم مناسب برای انجام این کار دارید.

مهمترین سیاهه‌های مربوط به سرور

• اطمینان حاصل کنید که فایل های ورود به سیستم ایجاد می شوند: ناوبری به کنسول سیستم > محیط زیست > ورود به سیستم > ورود به سیستم > ورود به سیستم، تایید کنید که سیستم های خروجی به فایل به درستی تنظیم شده است.
• شما می توانید مسیر فایل های ورود به سیستم کنسول > محیط زیست > ورود به سیستم > ثبت نام > دایرکتوری ورود به سیستم را به دست آورید.

فایل ورود به سیستم سرور حاصله فراخوانی می شود mattermost.log و می تواند با یک ویرایشگر متن استاندارد باز شود یا به طور مستقیم به اشتراک گذاشته شود.

یادداشت

برای یک سیستم باز کردن کامل تر کنسول سیستم > محیط زیست > ورود به سیستم، تنظیم سطح ورود به DEBUGDEBUG، سپس تکرار موضوع به آن را دوباره وارد کنید. اطمینان حاصل کنید که پس از عیب یابی برای ذخیره فضای دیسک، سطح ورود فایل را به INFO بازگردانید.

اگر دسترسی به فایل سیستم امکان پذیر نیست، به System Console > Reporting > Server Logs بروید تا سیستم های فعلی سیستم را که می تواند به یک فایل کپی شود، پیدا کنید.

شما می توانید اطلاعات بیشتر در مورد تنظیمات ورود به سیستم پیدا کنید

فایل های ورود به سیستم قابل دسترسی نیستند

از Mattermost v11.4، مسیرهای فایل ورود به سیستم معتبر هستند تا اطمینان حاصل شود که آنها در یک دایرکتوری ریشه ورود به سیستم تعیین شده باقی می مانند.

1. اگر فایل های ورود به سیستم در System Console > Reporting > Server Logs یا بسته های پشتیبانی ظاهر نمی شوند، پیام های خطا را در کنسول سرور بررسی کنید تا ببینید آیا مسیر فایل ورود به سیستم خارج از دایرکتوری مجاز است: "Blocked attempt to read log file outside allowed root"ورود به مسیرهای فایل خارج از دایرکتوری مشخص شده توسط MM_LOG_PATHمتغیر محیط ایجاد خطاها و از دانلود بسته های پشتیبانی حذف می شود. اگر MM_LOG_PATH تنظیم نشده است، پیش فرض logsدایرکتوری استفاده می شود. پیام خطا شناسایی می کند که کدام تنظیم پیکربندی دارای یک مسیر نامعتبر است:
   • LogSettings.FileLocation– فایل ورود به سیستم سرور اصلی
   • LogSettings.AdvancedLoggingJSON– اهداف فایل ورود به سیستم پیشرفته
   • ExperimentalAuditSettings.AdvancedLoggingJSON– اهداف پرونده ورود به سیستم حسابرسی
2. یکی از این راه حل ها را انتخاب کنید: گزینه A – از دایرکتوری ورود به سیستم پیش فرض استفاده کنید:
   • پیکربندی خود را برای استفاده از پیش فرض به روز کنید logsدایرکتوری
   • حذف یا به روز رسانی MM_LOG_PATH متغیر محیط
   • سرور موضوع راه اندازی مجدد
   گزینه B – پیکربندی ریشه ورود به سیستم برای مطابقت با مسیرهای ورود به سیستم شما:
   • تنظیم MM_LOG_PATHمتغیر محیط به یک دایرکتوری که شامل تمام فایل های ورود به سیستم شما است
   • اطمینان حاصل کنید که تمام مسیرهای فایل ورود به سیستم پیکربندی شده در این دایرکتوری ریشه قرار دارند
   • سرور موضوع راه اندازی مجدد
3. بررسی گزارش ها در دسترس هستند:
   • ناوبری به کنسول سیستم > گزارش > گزارش > گزارش سرور
   • تأیید ورودی های ورود به سیستم قابل مشاهده هستند
   • ایجاد یک بسته پشتیبانی تست برای تأیید سیاههها گنجانده شده است

مستندات محدودیت های مسیر ورود به سیستم را برای نمونه های پیکربندی دقیق مشاهده کنید.

مهمترین گزارش های برنامه دسکتاپ

دسترسی به سیاهههای برنامه دسکتاپ با رفتن به راهنما > نمایش سیاهههای مربوط به نوار منو.

متناوبا، شما می توانید فایل های ورود به برنامه های دسکتاپ را در دایرکتوری زیر دسترسی پیدا کنید:

• ویندوز: %userprofile%AppDataRoamingMattermostlogs
• لینوکس: ~/.local/share/Mattermost/logsیا ~/.config/Mattermost/logs
• MacOS: ~/Library/Logs/Mattermost(تنای DMG) یا ~Library/Containers/Mattermost.Desktop/Data/Library/Logs/Mattermost(فقط نصب و راه اندازی Appstore)

مهم ترین سیاهههای مربوط به وب

برنامه مبتنی بر مرورگر فایل های ورود به سیستم اضافی را تولید نمی کند. اگر برنامه باید اشکال زدایی شود، از ابزارهای توسعه یکپارچه در مرورگر خود برای تاریخچه عمل استفاده کنید.

مهم ترین گزارش خدمات اطلاع رسانی

ورود به سیستم برای موضوع مهمترین سرویس اطلاع رسانی فشار از طریق سیستم با logger اداره می شود و به آن اضافه می شود /var/log/syslog.

مرور مهم ترین محیط

یک جدول زمانی برای از بین بردن وقایع قبل از خطا / مشکل قرار دهید. به عنوان مثال، اگر شما به تازگی فایروال خود را دوباره پیکربندی کرده اید و در حال حاضر مسائل مربوط به اتصال را دارید، ممکن است ارزش بررسی تنظیمات را داشته باشد یا به عقب برگردید تا ببینید که آیا این مشکل را حل می کند یا خیر.

• اگر این مشکل پس از آن به یک دوره عملیات عادی رخ داده باشد، آیا چیزی در محیط تغییر کرده است؟
  • آیا مشتری، میزبان یا سرور ارتقا یافته بود؟
  • آیا به روز رسانی سیستم عامل اعمال شد؟
  • آیا محیط شبکه تغییر کرده است؟ به عنوان مثال، آیا یک سرور منتقل شد یا یک دامنه مهاجرت کرد؟
  • آیا سیستم (مشتری یا سرور) به تازگی شکست خورده یا به طور غیر طبیعی خاتمه یافته است؟
• چند کاربر تحت تاثیر قرار می گیرند؟
  • آیا این مشکل یکی را تحت تاثیر قرار می دهد، برخی یا همه کاربران؟
  • آیا این مشکل فقط برای کاربری که به تازگی به محیط اضافه شده است، مانند یک کارمند جدید رخ می دهد؟
  • آیا تفاوت هایی بین کاربرانی که تحت تاثیر قرار می گیرند و کاربرانی که تحت تاثیر قرار نمی گیرند وجود دارد؟

همچنین می توانید پیام های خطا را به صورت آنلاین جستجو کنید. راه حل های موجود از انجمن ما اغلب می تواند یافت و اعمال شود.

اتصال به سرور دیگر

1. ایجاد یک حساب کاربری در https://community.mattermost.com.
2. برنامه تلفن همراه خود را پاک کرده و آن را دوباره نصب کنید.
3. در برنامه تلفن همراه خود، URL سرور https://community.mattermost.com و سپس اعتبار ورود خود را وارد کنید تا آزمایش کنید که آیا اتصال کار می کند یا خیر.

ارتباط با یک دستگاه دیگر

• اگر دستگاه تلفن همراه دیگری در دسترس دارید، سعی کنید با آن ارتباط برقرار کنید تا ببینید آیا مشکل شما هنوز هم بازتولید می کند یا خیر.
• اگر دستگاه دیگری در دسترس ندارید، با سایر هم تیمی ها بررسی کنید تا ببینید آیا آنها همان مشکل را دارند یا خیر.

باز کردن یک بلیط پشتیبانی برای استقرار خود میزبانی

اگر شما یک اشتراک پرداخت شده به یک ارائه دقیق، مانند Mattermost Professional یا Matterost Enterprise دارید، شما حق دارید بلیط های پشتیبانی را از طریق پورتال پشتیبانی آنلاین ما باز کنید.

هنگام باز کردن یک بلیط پشتیبانی به عنوان بخشی از اشتراک پرداخت شده شما، مهم است که شما به ما اطلاعات بیشتری را به موقع ارائه دهید. دانستن اینکه چه اطلاعاتی مرتبط است می تواند گیج کننده باشد. ما از آناگرام C.L.U.E.S استفاده می کنیم تا به یاد داشته باشیم که به چه چیزی نیاز داریم:

• پیکربندی ها
• گزارش ها
• کاربران تحت تاثیر قرار
• محیط زیست
• مراحلی برای تولید مثل

C.L.U.E.S نشان دهنده تمام اطلاعاتی است که می تواند مسئله شما را روشن کند. با استفاده از این جزئیات، ما می توانیم شروع به جستجو برای یک علت کنیم، چه یک تغییر پیکربندی ساده باشد یا یک اشکال محصول. این همچنین به ما کمک می کند زمانی که ما نیاز به تشدید مسئله به توسعه دهندگان ما به طوری که آنها می توانند به عنوان زمان به عنوان وصله بهبود محصول ما صرف.

دستورالعمل های کلی برای اطلاعات

این دستورالعمل ها را هنگام ارائه داده های تشخیصی به ما دنبال کنید:

• اطمینان حاصل کنید که فایل هایی که ارائه می دهید تا حد امکان کامل هستند، به جای ارائه چند خط. کل فایل ها و تنظیمات ورود به سیستم ما را با زمینه های مهم ارائه می دهد.
• در صورت امکان فایل های پیکربندی و ورود به سیستم را در قالب متن ساده ارائه دهید، زیرا این ها برای ما بسیار آسان تر از تصاویر هستند.
• اطمینان حاصل کنید که فایل های پیکربندی و ورود به سیستم را برای حذف نام کاربری، رمزهای عبور و گروه های LDAP متوقف کنید. این جزئیات را با رشته های نمونه ای که در صورت امکان حاوی همان کاراکترهای خاص هستند، جایگزین کنید، زیرا شخصیت های خاص علل رایج خطاهای پیکربندی هستند.
• تصاویر یا ضبط صفحه نمایش از رفتار غیر منتظره محصول را ارائه می دهد تا ما دقیقا می دانیم که کاربران شما چه چیزی را می بینند.

پیکربندی

چرا ما به داده های پیکربندی شما نیاز

در سیستم های لینوکس، تنظیمات به طور کلی در فایل های پیکربندی ذخیره می شوند. بسیاری از مسائل را می توان با فعال کردن یا غیرفعال کردن یک تنظیم پیکربندی حل کرد. به منظور پیدا کردن یک راه حل، ما باید به عنوان یک تصویر کامل از راه اندازی سیستم خود را به عنوان امکان پذیر است. این همچنین به ما کمک می کند تا باگ ها را بازتولید کنیم تا توسعه دهندگان ما بتوانند آنها را تعمیر کنند.

چه داده های پیکربندی شامل

پیکربندی شامل (اما نه محدود به):

• مهم ترین config.jsonفایل.
• پیکربندی برای پروکسی معکوس، به عنوان مثال. NGINX، HAProxy، AWS.
• پیکربندی پایگاه داده.
• پیکربندی SAML زمانی که مسئله مربوط به احراز هویت SAML است. پیکربندی برای خدمات Mattermost در SAML IdP است.
• هر سیستم دیگری که مهم است به یا سیستم هایی که بین کاربر و سرور ماتر وجود دارد متصل می شود.

چگونه به داده های پیکربندی خود دسترسی پیدا

موضوع ترین پیکربندی

موضوع ترین پیکربندی معمولا در ذخیره می شود /opt/mattermost/config/config.json. اگر شما جزئیات را به پایگاه داده مهاجرت کرده اید، می توانید پیکربندی را با استفاده از آن دریافت کنید mmctlیا با اجرای این پرس و جو پایگاه داده:

SELECT Value FROM Configurations WHERE Active = 1;

پیکربندی پروکسی معکوس

NGINX معمولا پیکربندی خود را به دو بخش تقسیم می کند: پیکربندی سرور اصلی در /etc/nginx/nginx.conf، و یک پیکربندی سرور مجازی. در اوبونتو، این در آن ذخیره می شود /etc/nginx/sites-available. ارائه هر دو این فایل های پیکربندی مفید است، اما ارائه دومی مهم تر است.

پیکربندی SAML

اگر مشکلی که شما می بینید با ورود به سیستم SAML است، ما باید پیکربندی کامل را برای سرویس Mattermost در ارائه دهنده SAML ببینیم. پیکربندی برای خدمات Mattermost در SAML IdP است. ارائه تصاویر مشابه با تصاویر موجود در مستندات راه اندازی کافی است زیرا اکثر ارائه دهندگان SAML با استفاده از یک رابط وب پیکربندی شده اند.

پیکربندی LDAP

مدیر LDAP باید مقادیر صحیح را برای تنظیمات Matermost LDAP زیر تأیید کند:

• نام میزبان سرور LDAP.
• پورت، امنیت و گواهینامه های اتصال LDAP.
• BaseDN، نام کاربری را متصل کنید و رمز عبور را متصل کنید.
• فیلترهای کاربر، گروه، مهمان و مدیر.
• ویژگی های نمایش.

این می تواند به عنوان یک فایل متنی یا به عنوان تصاویر از سرور LDAP ارائه شود.

سایر تنظیمات

اگر مشکلی را در تلفن همراه تجربه می کنید و از یک MDM یا VPN برای اتصال به سرور استفاده می کنید، این تنظیمات برای تشخیص مشکل ضروری خواهد بود. یک مدیر سیستم برای سیستم خارجی باید بتواند پیکربندی را در اختیار شما قرار دهد.

گزارش ها

چرا ما به آنها نیاز داریم

تقریبا تمام سیستم های کامپیوتری دارای سیاهههای مربوط به خطاها و رفتار برنامه هستند که می تواند به ما نشان دهد که چه اتفاقی می افتد زمانی که یک برنامه در حال اجرا است. گزارش های خطا هنگام تشخیص یک مشکل ارزشمند هستند، اما تنها در صورتی که تا حد ممکن کامل باشند.

چه سیاهههای مربوط به در دسترس

مهم ترین

Mattermost دارای دو فایل ورود به سیستم، یکی برای پیام های عمومی و دیگری برای پیام های مربوط به اطلاع رسانی است. این موارد در موارد زیر یافت می شود:

• /opt/mattermost/logs/mattermost.log
• /opt/mattermost/logs/notification.log

پروکسی

محل این بستگی به پیکربندی پروکسی شما دارد، اما یک مکان خوب برای شروع جستجو در /var/log. مدیر پروکسی شما باید بتواند به شما در پیدا کردن سیاهههای مربوط کمک کند.

پایگاه داده

PostgreSQL و MySQL دارای سیاهههای مختلف هستند و مکان آنها بر اساس پیکربندی شما متفاوت است. اگر این مسئله مربوط به اتصال پایگاه داده است، مستندات پایگاه داده را برای مکان یابی سیاههها بررسی کنید.

SAML، LDAP و سیستم های دیگر

مدیر سیستم سازمان شما باید بتواند این ها را برای شما پیدا کند.

نحوه دسترسی به سیاهههای

مهم ترین

اطمینان حاصل کنید که ورود به سیستم اشکال زدایی فعال است تا بتوانیم بیشترین اطلاعات را از سیاهههای مربوط به آن دریافت کنیم. برای انجام این کار، به System Console > Environment > Loging بروید، سپس هر دو سطح فایل کنسول و سطح ورود به فایل را به DEBUG تنظیم کنید. به یاد داشته باشید که تغییرات خود را ذخیره کنید.

اگر رفتار در یک زمان یا تاریخ شناخته شده آغاز شد، استفاده کنید journalctlبرای دریافت سیاهههای مربوط به این مانند این:

sudo journalctl -u mattermost --since "2020-08-23 17:15:00" > mattermost_journalctl.log

جایگزین 2020-08-23 17:15:00 با تاریخ و زمان (نسبت به سرور) زمانی که رفتار شروع شد. برای به دست آوردن زمان سرور، استفاده از dateفرمان. اگر فایل های ورود به سیستم تولید شده برای ارسال بیش از حد بزرگ هستند، آنها را با این دستور فشرده کنید:

tar -czf /tmp/mattermost.log.tgz

سیاهههای فشرده بر روی سرور در واقع خواهد بود /tmp/mattermost.log.tgz.

اگر فایل فشرده شده هنوز بیش از حد بزرگ است، از این دستورات برای تقسیم فایل فشرده شده به دو یا چند فایل 20MB استفاده کنید:

mkdir -p /tmp/mattermost-logs
cd /tmp/mattermost-logs
tar czf - /opt/mattermost/logs/mattermost.log | split -b 20m - mattermost.log.tgz.

فایل های فشرده بر روی سرور در واقع خواهد شد /tmp/mattermost-logsو نام برده شود mattermost.log.tgz.aa، mattermost.log.tgz.abو غیره. از یک سرویس گیرنده انتقال فایل استفاده کنید که از SSH/SFTP مانند Cyberduck پشتیبانی می کند تا این فایل ها را از سرور کپی کند.

اگر شما در حال تجربه مسائل با Elasticsearch، LDAP، و یا پایگاه داده، شما می توانید راه حل و کار فعال کردن در config.jsonبا تنظیم Traceبه trueتحت تنظیمات مربوطه خود را. ترکیب این با DEBUGخروجی ورود به سیستم فایل سطح منجر به فایل های ورود به سیستم بزرگ می شود، بنابراین فقط جریان را به اندازه کافی طولانی برای تکرار رفتار باقی می گذارد. گزارش های حاصل از آن همچنین حاوی داده های حساس تر از جمله داده های کاربر خواهد بود، بنابراین قبل از به اشتراک گذاری آن با ما، آن را به طور کامل ضدعفونی کنید.

سیستم های ورود به سیستم

محل فایل های ورود به سیستم های دیگر متفاوت است، اما یک راه خوب برای دریافت سیاهههای مربوط به تمام فرآیندها در سرور Mattermost استفاده از آن است journalctlاین گونه:

sudo journalctl --since "2020-08-23 17:15:00" > mattermost_journalctl.log

جایگزین 2020-08-23 17:15:00` با تاریخ و زمان (نسبت به سرور) زمانی که خطا رخ داد. می توانید از --untilبا همان فرمت زمان برای دریافت سیاهههای مربوط به دو بار:

sudo journalctl --since "2020-08-23 17:15:00" --until "2020-08-23 16:30:00" > mattermost_journalctl.log

کاربران تحت تاثیر

چرا به آن نیاز داریم

مهم ترین سرورها مکان های پر هرج و مرج هستند. هزاران پست، اقدامات websocket و تماس های webhook در هر ثانیه اتفاق می افتد در حالی که کاربران می توانند در ده ها کانال در چندین تیم باشند. دانستن اینکه کدام کاربران تحت تاثیر یک مشکل قرار می گیرند می تواند به ما کمک کند تا تمام این اطلاعات را برای پیدا کردن علت ریشه ای بررسی کنیم.

چه اطلاعاتی را شامل

این باید یک توضیح دقیق از هر چیزی باشد که کاربران نهایی که رفتار غیر منتظره را گزارش می دهند، مشترک است. این شامل (اما محدود به آن نیست):

• عضویت تیم و کانال، از جمله پیام های مستقیم و گروهی.
• روش های احراز هویت.
• سیستم عامل مشتری و نسخه های برنامه.
• چگونه کاربران به موضوع ترین سرور متصل می شوند؟
• هر چیز دیگری که این کاربران در آن مشترک هستند مانند زمانی که آنها پیوستند، آیا اطلاعات ورود آنها به تازگی تغییر کرده است، یا اگر آنها از طریق LDAP هماهنگ شده باشند.

توجه به نمایندگان: این اطلاعات نیز مورد نیاز است:

• نام مشتری
• مخاطبین مشتری
• مجوز مشتری، به عنوان مثال شرکت/حرفه ای
• سطح مشتری

محیط زیست

جایی که مهم ترین سرور در معماری شما قرار دارد، تاثیر زیادی بر مسائل بالقوه دارد. به عنوان مثال، یک سرور پروکسی پیکربندی اشتباه می تواند کاربران را از اتصال جلوگیری کند حتی اگر هیچ مشکلی با Mattermost وجود نداشته باشد.

چه اطلاعاتی را شامل

به همین دلیل، داشتن یک تصویر کامل از سرورها و شبکه ای که سرور Mattermost در آن فعالیت می کند، کلید حل مشکلات است. این شامل (اما محدود به آن نیست):

• موضوع ترین نسخه (به عنوان مثال 7.3.0، 7.8.3)
• سیستم عامل سرور و نسخه (به عنوان مثال RHEL7، اوبونتو 20.04)
• هر گونه ارکستراسیون / اتوماسیون مورد استفاده مانند Docker یا Kubernetes
• پروکسی معکوس و نسخه (به عنوان مثال NGINX 1.16)
• نوع و نسخه پایگاه داده (به عنوان مثال PostgreSQL 14)
• ارائه دهنده SAML (به عنوان مثال ویندوز سرور 2012 Active Directory, Okta, KeyCloak)
• ارائه دهنده LDAP (به عنوان مثال ویندوز سرور 2016 دایرکتوری فعال، Okta، OpenLDAP)
• نوع و نسخه هر پروکسی یا VPN در شبکه ای که سرور مهم از طریق آن متصل می شود

در هنگام توصیف محیط به همان اندازه خاص باشید. اگر شما در حال دیدن خطاهایی مانند Connection نیستید، مطمئن شوید که هر فایروال یا پروکسی های فیلتر شده را که ممکن است در شبکه شما باشد، یا ورودی یا خروجی.

مثال ها

مهم ترین سرور

• نام میزبان خارجی: ماتورموس.example.com
• نام میزبان داخلی: ماده.lan
• مهم ترین v7.3.0
• پلاگین زوم v1.4.1
• NGINX v1.18.0

سرور پایگاه داده

• نام میزبان داخلی: postgresql.lan
• PostgreSQL v13
• ارائه دهنده LDAP – 192.168.1.102
• نام میزبان داخلی: ldap.lan
• OpenLDAP 2.4.54 (محصب داکر)

مهم ترین سرورها

• نام های میزبان: mm1.local.lan، mm2.local.lan، mm3.local.lan، mm4.local.lan

مهم ترین نسخه های سرور

• میلی متر1-3: 5.25.4
• MM4: 5.21.0

سرور پروکسی

• نام میزبان خارجی: ماتورموس.example.com
• نام میزبان داخلی: proxy.local.lan
• NGINX v1.16.0

سرورهای پایگاه داده

• نام های میزبان: db1.local.lan، db2.local.lan، db3.local.lan
• اولیه: db1.local.lan
• فقط بخوانید: db2.local.lan, db3.local.lan
• PostgreSQL v13

سرور Elasticsearch

• نام میزبان: elastic.local.lan
• Elasticsearch v7.9 با این افزونه ها
• تجزیه و تحلیل-icu

گام هایی برای تولید مثل

چه چیزی است

اگر این رفتار تنها زمانی اتفاق می افتد که کاربر یک عمل خاص را انجام دهد، ارائه مراحل دقیق برای تکثیر آن به ما کمک می کند تا مطمئن شویم که اشکال مناسب را پیدا و رفع می کنیم. این جزئیات باید تا حد امکان توصیفی باشد، اما هیچ چیز بهتر از یک تصویر یا ضبط صفحه نمایش از رفتار نیست.

خلاصه ای کوتاه از مراحل برای بازتولید نیز مفید است. اگر می خواهید چند نمونه داشته باشید، به بلیط های باگ در برخی از بلیط های Mattermost Jira نگاه کنید.

چگونه این جزئیات را ارائه

macOS

مطبوعات ⌘ ⇧ 5 برای باز کردن ابزار ضبط صفحه نمایش و انتخاب منطقه از صفحه نمایش شما می خواهید برای ضبط. برای گرفتن یک تصویر، فشار دهید ⌘ ⇧ 4 و منطقه را برای گرفتن اسکرین شات انتخاب کنید. فایل های اسکارت به طور پیش فرض بر روی دسکتاپ قرار می گیرند.

ویندوز

مطبوعات Ctrl Shift S برای باز کردن ابزار snipping برای گرفتن یک تصویر. اگر می خواهید یک ضبط صفحه را بگیرید، باید نرم افزار شخص ثالث مانند OBS.

iOS

یک اسکرین شات یا ضبط صفحه نمایش در آیفون داشته باشید.

اندروید

یک اسکرین شات بگیرید یا صفحه نمایش خود را در دستگاه Android خود ضبط کنید.

ضمیمه

یادداشتی در مورد مسائل موبایلی

از آنجا که برنامه تلفن همراه حالت اشکال زدایی ندارد، تشخیص مسائل ناشی از داده های کاربر نیاز به یک پروکسی مانند چارلز یا میت امپروکسی دارد. این ها ترافیک را از مشتری رهگیری و ضبط می کنند که می تواند برای بازتولید مسائل تکرار شود. با یک متخصص مهم برای کمک به راه اندازی این ها صحبت کنید.

مسائل مربوط به ورود SAML

اگر مشکل با ورود به سیستم SAML باشد، یک قطعه مهم از زمینه جریان ورود SAML است. این شامل هدرها و اطلاعات احراز هویت است که می تواند مسائلی را که به راحتی حل می شوند، نشان دهد. این دستورالعمل ها را برای مشاهده جریان ورود SAML در صورت تجربه احراز هویت SAML دنبال کنید.

بررسی کلیدها و گواهینامه ها

فایل های کلیدی و گواهی هرگز نباید به اشتراک گذاشته شوند، اما اگر خطا نشان دهنده یک مشکل با فرمت یک کلید یا گواهی باشد، باید با اجرای این دستور، فرمت کلیدها و گواهینامه ها را تأیید کنید:

cat -A /path/to/key-or.cert

خروجی باید این معیارها را دقیقاً تأیید کند تا معتبر باشد:

• با شروع کنید -----BEGIN CERTIFICATE-----$.
• همه خطوط باید با $. اگر آنها به پایان برسند ^M$سپس آنها را به پایانه های خط UNIX با dos2unix.
• پایان دادن به -----END CERTIFICATE-----$.

source:

• https://docs.mattermost.com/deployment-guide/server/troubleshooting.html