پرش به محتوا

رفع نمایش رکوردهای تکراری Queue و خطای Recording missing در Issabel

تشخیص ارجاع‌های ضبط صف و اصلاح محدود ماژول Monitoring با امکان بازگشت
1 آذر 1405 توسط
رفع نمایش رکوردهای تکراری Queue و خطای Recording missing در Issabel
سینا طیفوری

اگر در بخش PBX / Calls Recordings برای یک تماس صف ده‌ها ردیف می‌بینید و بیشتر آن‌ها پیام Recording missing دارند، فوراً سراغ تعمیر دیتابیس نروید. این وضعیت می‌تواند از چند CDR متعلق به شاخه‌های یک تماس، باقی‌ماندن نام فایل ضبط اولیه در آن‌ها و حذف همان فایل هنگام تغییر مسیر ضبط ناشی شود. در چنین حالتی ممکن است فایل نهایی مکالمه سالم باشد، اما ماژول Monitoring قدیمی هر ارجاع را یک ضبط مستقل نشان دهد.

در این راهنما، علت و اصلاح بررسی‌شده در یک نصب قدیمی Issabel را توضیح می‌دهیم. دامنهٔ کد با ماژول متعلق به بستهٔ issabel-pbx-4.0.0-6.noarch تطبیق داده شده است؛ نام فایل‌ها، ساختار جدول و توابع را پیش از استفاده در نسخه‌های دیگر بررسی کنید. این یک اصلاح محلی در کد Monitoring است و کاربرد آن به تشخیص همین زنجیرهٔ علت وابسته است.

علائم این سناریو چیست؟

  • یک تماس صف چندین بار در فهرست ضبط‌ها ظاهر می‌شود.
  • تعدادی از ردیف‌ها زمان صفر و وضعیت ناموفق یا بدون پاسخ دارند.
  • چند ردیف یک مقدار یکسان در recordingfile دارند.
  • برای فایل اولیه پیام فقدان ضبط دیده می‌شود، اما فایل نهایی همان مسیر تماس قابل پیدا کردن است.
  • آزمون سلامت جدول، خطای خرابی جاری نشان نمی‌دهد و CDR جدید همچنان ثبت می‌شود.

این نشانه‌ها باید کنار هم بررسی شوند. صرف صفر بودن زمان یا مشاهدهٔ یک پیام Missing، حذف عمدی فایل موقت را اثبات نمی‌کند. برای بررسی عمومی‌تر فایل گمشده یا بی‌صدا، راهنمای عیب‌یابی ضبط مکالمه در Issabel را نیز ببینید.

علت فنی: یک تماس، چند CDR و دو مرحلهٔ ضبط

CDR همان فایل صوتی نیست. یک تماس، بسته به شاخه‌ها، کانال‌ها و تلاش‌های شماره‌گیری، می‌تواند چند رکورد جزئیات تماس تولید کند. مستندات رسمی CDR در Asterisk این موضوع را توضیح می‌دهد؛ جزئیات رفتار به نسخه و تنظیمات وابسته است.

در زنجیرهٔ بررسی‌شده، ضبط اولیه آغاز شده بود و شاخه‌های صف همان نام recordingfile را به ارث برده بودند. سپس مسیر sub-record-cancel ضبط اولیه را متوقف و فایل آن را حذف کرده بود؛ مسیر بعدی فایل تازه‌ای ساخته بود. CDRهای فرعیِ نهایی‌شده همچنان به نام قبلی اشاره می‌کردند، در حالی که فایل نهایی سالم بود. این رفتار از لاگ و dialplan همان نصب تأیید شد و نباید به همهٔ نصب‌های Issabel تعمیم داده شود.

Monitoring قدیمی، ردیف‌های دارای نام ضبط غیرخالی را بدون یکتاسازی فایل فهرست می‌کرد. در نتیجه یک نام چند بار نمایش داده می‌شد و resolver برای نام حذف‌شده پیام Missing می‌ساخت. retry صف و اعضای غیرقابل دسترس می‌توانند تعداد شاخه‌ها را بیشتر کنند؛ اصلاح وضعیت اعضا موضوعی جداست و باید با قصد عملیاتی صف هماهنگ باشد. برای آن بخش، راهنمای عیب‌یابی صف تماس در Issabel مفید است.

زنجیرهٔ ارجاع ضبط در صف: نام اولیه در چند CDR ثبت می‌شود، لغو ضبط فایل اولیه را حذف می‌کند و فایل جدید ساخته می‌شود؛ اصلاح Monitoring ارجاع‌های فاقد فایل را کنار می‌گذارد
الگوی مشاهده‌شده؛ اصلاح نمایش، دادهٔ CDR یا فایل مفقود را بازیابی نمی‌کند. نمایش نمودار در اندازهٔ اصلی

پیش از patch، خرابی واقعی را از خطای نمایش جدا کنید

ابتدا نسخهٔ بسته و وجود فایل‌های هدف را بررسی کنید:

rpm -q issabel-pbx
stat /var/www/html/modules/monitoring/libs/paloSantoMonitoring.class.php
stat /var/www/html/modules/monitoring/index.php

در نشست مجاز دیتابیس، با بازهٔ زمانی محدود تعداد ردیف و نام فایل متمایز را مقایسه کنید. بازهٔ زیر صرفاً نمونه است؛ برای جدول بزرگ، برنامهٔ اجرا و هزینهٔ query را پیش از گسترش بازه بررسی کنید:

SELECT COUNT(*) AS cdr_rows,
       COUNT(DISTINCT recordingfile) AS recording_names
FROM asteriskcdrdb.cdr
WHERE calldate >= '2026-01-01 10:00:00'
  AND calldate <  '2026-01-01 10:10:00'
  AND recordingfile <> '';

اختلاف این دو عدد وجود ارجاع مشترک را نشان می‌دهد؛ سلامت یا وجود فایل را ثابت نمی‌کند. برای یک نمونه، CDRها، لاگ تماس و مسیر resolve‌شدهٔ فایل را تطبیق دهید. 

مرحلهٔ اول: از دو فایل نسخهٔ قابل بازگشت بگیرید

ادامهٔ مراحل برای مدیر مجاز با دسترسی root، ترجیحاً ابتدا در محیط آزمایشی است. مسیر زیر عمومی و نمونه است؛ پوشهٔ پشتیبان باید بیرون از web root و با دسترسی محدود باشد. خروجی مسیر ساخته‌شده را برای rollback نگه دارید:

MONITORING_DIR=/var/www/html/modules/monitoring
PATCH_BACKUP_DIR=$(mktemp -d /root/monitoring-patch.XXXXXXXX)
chmod 700 "$PATCH_BACKUP_DIR"

cp -a "$MONITORING_DIR/libs/paloSantoMonitoring.class.php" "$PATCH_BACKUP_DIR/"
cp -a "$MONITORING_DIR/index.php" "$PATCH_BACKUP_DIR/"

stat "$MONITORING_DIR/libs/paloSantoMonitoring.class.php" \
     "$MONITORING_DIR/index.php" > "$PATCH_BACKUP_DIR/stat-before.txt"
sha256sum "$PATCH_BACKUP_DIR/paloSantoMonitoring.class.php" \
          "$PATCH_BACKUP_DIR/index.php" > "$PATCH_BACKUP_DIR/sha256-before.txt"
printf '%s\n' "$PATCH_BACKUP_DIR"

اگر هر فرمان خطا داد، به ویرایش ادامه ندهید. مالکیت، mode و در صورت فعال‌بودن SELinux، context اولیه را نیز ثبت کنید. تغییر مالکیت یا مجوز عمومی فایل‌ها بخشی از این اصلاح نیست.

مرحلهٔ دوم: شمارش و انتخاب ردیف نماینده را اصلاح کنید

در فایل libs/paloSantoMonitoring.class.php و تابع getNumMonitoring()، فقط query شمارش را تغییر دهید:

// Before
$query = 'SELECT COUNT(*) FROM cdr '.$sWhere;

// After
$query = 'SELECT COUNT(DISTINCT recordingfile) FROM cdr '.$sWhere;

سپس در getMonitoring()، query انتخاب همهٔ CDRها را با این query جایگزین کنید:

$query = 'SELECT cdr.* FROM cdr INNER JOIN (' .
    'SELECT MAX(id) AS id FROM cdr '.$sWhere.' GROUP BY recordingfile' .
    ') AS recording_rows ON cdr.id = recording_rows.id ' .
    'ORDER BY cdr.uniqueid DESC';

ساخت $sWhere و آرایهٔ پارامترهای $paramSQL را حفظ کنید؛ مقدارهای ورودی را مستقیم به SQL نچسبانید. بلوک موجود صفحه‌بندی نیز بعد از query باقی می‌ماند:

if (!empty($limit)) {
    $query .= " LIMIT ? OFFSET ?";
    array_push($paramSQL, $limit, $offset);
}

در این ساختار، فیلترهای موجود داخل زیرquery اعمال می‌شوند؛ سپس برای هر نام ضبط، ردیف دارای بزرگ‌ترین id انتخاب می‌شود. وجود ستون id و یکتایی آن باید پیش‌تر تأیید شده باشد. این روش همهٔ ستون‌ها را از یک ردیف مشخص می‌گیرد و مشکل انتخاب مبهم ستون‌ها در SELECT * ... GROUP BY را ندارد.

ردیف نماینده الزاماً شاخهٔ پاسخ‌داده‌شده، طولانی‌ترین بخش یا بهترین مبنای گزارش مالی نیست. هدف این تغییر فقط نمایش یک مورد برای هر نام فایل در فهرست ضبط‌هاست؛ دادهٔ اصلی CDR نباید حذف یا ادغام شود.

مرحلهٔ سوم: ارجاع فاقد فایل را از فهرست قابل پخش کنار بگذارید

در index.php و حلقهٔ ساخت ردیف‌های فهرست، فراخوانی resolver موجود را نگه دارید. بلوکی را که برای fullpath تهی پیام قرمز می‌ساخت، به شکل زیر تغییر دهید:

$recinfo = $pMonitoring->resolveRecordingPath($value['recordingfile']);
if (is_null($recinfo['fullpath'])) {
    continue;
} else {
    // Keep the existing playback/download code unchanged.
}

این نمونه محل تغییر را نشان می‌دهد؛ بدنهٔ واقعی else را با کامنت جایگزین نکنید. continue فقط همان ردیف را از نمایش کنار می‌گذارد. فایل تازه‌ای ایجاد نمی‌کند، ضبط گمشده را برنمی‌گرداند و هیچ رکورد دیتابیس را اصلاح نمی‌کند.

مرحلهٔ چهارم: بررسی نحو، context و reload وب‌سرور

پیش از بارگذاری تغییر، هر فایل را جداگانه با PHP همان نصب بررسی کنید. گزینهٔ رسمی php -l صرفاً نحو را کنترل می‌کند و جای آزمون اجرای صفحه و query را نمی‌گیرد:

php -l "$MONITORING_DIR/libs/paloSantoMonitoring.class.php"
php -l "$MONITORING_DIR/index.php"

مالکیت و mode را با baseline مقایسه کنید. در سامانهٔ دارای SELinux، مطابق سیاست همان میزبان contextها را بازاعمال کنید؛ برای حل خطا SELinux را خاموش نکنید:

restorecon -v "$MONITORING_DIR/libs/paloSantoMonitoring.class.php" \
              "$MONITORING_DIR/index.php"

سپس پیکربندی Apache را بررسی کنید. فقط پس از موفقیت کنترل‌ها و با اطمینان از اینکه نام سرویس در نصب شما httpd است، reload انجام دهید:

apachectl configtest && systemctl reload httpd && systemctl is-active httpd

در صورت شکست configtest یا lint، reload نکنید و ابتدا خطا را رفع یا rollback کنید. مستندات Apache، configtest را آزمون نحو پیکربندی معرفی می‌کند. این اصلاح به restart کردن Asterisk یا MariaDB نیاز ندارد.

راستی‌آزمایی: حذف پیام کافی نیست

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

در بررسی مبنای این راهنما، query یکتاسازی، تشخیص فایل موجود و نام حذف‌شده توسط resolver، نحو دو فایل، configtest و reload تأیید شده بود؛ پاسخ HTTP نیز موفق بود و خطای Fatal/Parse تازه گزارش نشد. این شواهد جای کنترل تعاملی همهٔ فیلترهای رابط را نمی‌گیرند و اعداد یا نتیجهٔ تضمین‌شده برای نصب دیگری نیستند.

سه محدودیت را هنگام پذیرش نتیجه در نظر بگیرید:

  • صفحه‌بندی: شمارنده نام‌های متمایز دیتابیس را می‌شمارد، اما continue بعد از دریافت نتایج اجرا می‌شود. بنابراین تعداد ردیف نمایشی ممکن است کمتر از شمارنده باشد و صفحهٔ کم‌ردیف یا خالی باقی بماند.
  • نام مشترک: گروه‌بندی بر نام فایل متکی است. اگر ضبط‌های متفاوت نام تکراری دارند، ابتدا کلید یکتای مناسب را طراحی کنید؛ این query را کورکورانه اعمال نکنید.
  • فقدان واقعی: همین فیلتر می‌تواند ضبط واقعاً ازدست‌رفته یا مسیر resolve‌نشده را نیز پنهان کند. پایش جداگانهٔ فایل‌های مفقود و سلامت ضبط همچنان لازم است.

در دیتابیس بزرگ، هزینهٔ COUNT DISTINCT و گروه‌بندی را با بازهٔ محدود و برنامهٔ اجرای query بسنجید. تغییر index یا schema اقدام جداگانه‌ای است و نباید ضمن این patch و بدون بررسی انجام شود.

rollback و نگهداری پس از ارتقا

اگر نمایش یا پخش دچار مشکل شد، پیش از بازگردانی مطمئن شوید بعد از backup، ویرایش یا ارتقای دیگری روی این دو فایل انجام نشده است. متغیر زیر را به مسیر واقعی نسخهٔ پشتیبان خودتان تنظیم کنید؛ مسیر نمونه را عیناً اجرا نکنید:

PATCH_BACKUP_DIR='/root/monitoring-patch.REPLACE_ME'
MONITORING_DIR=/var/www/html/modules/monitoring

cp -a "$PATCH_BACKUP_DIR/paloSantoMonitoring.class.php" "$MONITORING_DIR/libs/"
cp -a "$PATCH_BACKUP_DIR/index.php" "$MONITORING_DIR/"

php -l "$MONITORING_DIR/libs/paloSantoMonitoring.class.php"
php -l "$MONITORING_DIR/index.php"
restorecon -v "$MONITORING_DIR/libs/paloSantoMonitoring.class.php" \
              "$MONITORING_DIR/index.php"
apachectl configtest

پس از تأیید مالکیت و mode اولیه و موفقیت همهٔ بررسی‌ها، systemctl reload httpd را اجرا و صفحه را دوباره آزمایش کنید. چون این تغییر فقط کد نمایش را اصلاح می‌کند، rollback دیتابیس یا فایل‌های صوتی برای آن لازم نیست.

ارتقای بستهٔ issabel-pbx ممکن است patch را بازنویسی کند. diff، نسخهٔ بسته و checksumها را نگه دارید و پس از upgrade ابتدا کد جدید را مقایسه کنید؛ patch قدیمی را بدون بررسی سازگاری دوباره اعمال نکنید. برای نگهداری پایدار، اصلاح بسته‌بندی‌شده و قابل آزمون از ویرایش دستیِ فراموش‌شده بهتر است.

جمع‌بندی

برای رفع رکوردهای تکراری Queue و Recording missing، ابتدا تفاوت میان CDR، نام فایل و فایل واقعی را روشن کنید. وقتی مشکل از شاخه‌های صف و لغو و شروع مجدد ضبط باشد، شمارش نام یکتا، انتخاب یک CDR نماینده و کنارگذاشتن ارجاع فاقد فایل می‌تواند فهرست Monitoring را اصلاح کند. این کار جای تعمیر خرابی واقعی یا پایش فقدان ضبط را نمی‌گیرد.

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

حاکمیت داده‌های پایه در ERP؛ مالکیت، کیفیت و گردش تغییر
الگوی عملی تعیین مسئول، کنترل کیفیت و رسیدگی به تغییر داده‌های مشترک