پیداکردن کوئری‌های پرهزینه در PostgreSQL و خواندن درست plan

سرور باید از قبل PostgreSQL نسخهٔ ۱۸ باشد و افزونهٔ pg_stat_statements در آن بارگذاری و در schema موردنظر نصب شده باشد. انتخاب سیستم‌عامل در این صفحه مربوط به کلاینت مدیریت است و افزونه‌ای روی سرور فعال نمی‌کند. در Ubuntu نسخه‌های ۲۶٫۱۰ و ۲۶٫۰۴ و Debian نسخه‌های ۱۳ و ۱۲، باینری‌های کلاینت PGDG در /usr/lib/postgresql/18/bin قرار دارند. در RHEL، Rocky Linux و AlmaLinux شاخه‌های ۹ و ۱۰، مسیر /usr/pgsql-18/bin به کار می‌رود؛ فرمان‌های این شاخه مسیر کامل psql را دارند تا کلاینت قدیمی‌ترِ توزیع اشتباهی اجرا نشود. اتصال پایش و اتصال آزمایشگاه را جدا نگه دارید. فایل‌های محافظت‌شدهٔ libpq متعلق به حساب اجراکنندهٔ کلاینت‌اند؛ تنظیمات سرور را برای یکسان‌کردن مسیرها بین توزیع‌ها جابه‌جا نکنید.

این مسیرها از مستندات استخراج شده‌اند و آزمون عملی سازگاری محسوب نمی‌شوند. ابتدا /etc/os-release و نسخهٔ دقیق محصول را بررسی کنید. حساب‌ها، دسترسی شبکه و اعتبارنامه‌های محافظت‌شده باید از قبل آماده باشند. برای آماده‌کردن ابزارها، سرویس موجود را دوباره راه‌اندازی نکنید، دیتابیس تازه مقداردهی اولیه نکنید، پورتی روی فایروال باز نکنید و Python سیستم را تغییر ندهید.

cat /etc/os-release
id
test -x /usr/lib/postgresql/18/bin/psql
/usr/lib/postgresql/18/bin/psql --version

از ایستگاه مدیریت به دیتابیس موردنظر وصل شوید. پنل‌های SQL بخش مشاهده باید در همین اتصال اجرا شوند، چون نمونهٔ اول در جدول موقت این نشست ذخیره می‌شود. autocommit را روشن نگه دارید؛ پیچیدن همهٔ مراحل در یک تراکنش طولانی می‌تواند تصویر آمار را ثابت نگه دارد.

اگر افزونه موجود نیست یا جای دیگری نصب شده، از رویهٔ همان محیط استفاده کنید؛ نبودن آن را با نصب یا restart بدون برنامه جبران نکنید.

/usr/lib/postgresql/18/bin/psql -X -v ON_ERROR_STOP=1 'service=academy_stats'

هویت کامل هر رکورد از database، user، queryid و toplevel تشکیل می‌شود؛ queryid به‌تنهایی کافی نیست. همراه شمارنده‌ها، زمان آغاز آمار همان رکورد و وضعیت reset و dealloc را هم ذخیره می‌کنیم تا بعداً دو چیز نامربوط را از هم کم نکنیم.

پس از گرفتن نمونه، در prompt منتظر بازه‌ای بمانید که بار مورد بررسی واقعاً در آن جریان دارد. این مقاله برای سرویس اصلی بار مصنوعی تولید نمی‌کند. زمان شروع و پایان را در یادداشت رخداد نگه دارید.

SELECT version(), current_database();
SELECT extversion FROM pg_extension WHERE extname='pg_stat_statements' AND extnamespace='public'::regnamespace;
CREATE TEMP TABLE academy_info_before AS SELECT clock_timestamp() AS captured_at, stats_reset, dealloc FROM public.pg_stat_statements_info;
CREATE TEMP TABLE academy_stat_before AS SELECT dbid,userid,queryid,toplevel,stats_since,calls,total_exec_time,rows,shared_blks_read,temp_blks_written FROM public.pg_stat_statements WHERE dbid=(SELECT oid FROM pg_database WHERE datname=current_database());
\prompt 'Wait for the representative interval, then press Enter: ' interval_done