rpc_completed چه مسئله‌ای را حل می‌کند؟

هدف اصلی این رویداد، تفکیک هزینه فراخوانی‌های پارامتری، رویه‌های ذخیره‌شده و دستورهایی که درایورهای کلاینت به شکل RPC ارسال می‌کنند است. ارزش عملی آن زمانی آشکار می‌شود که تیم پایگاه داده به جای نگاه کردن به میانگین‌های کلی، هر رخداد را با database_id، session_id، نام برنامه، متن SQL و زمان وقوع مرتبط کند. چنین ارتباطی کمک می‌کند کندی گذرا، رفتار پارامتری و تفاوت بار برنامه‌ها از یکدیگر جدا شوند.

فیلدهای مهمی که باید بر اساس metadata سرور بررسی شوند عبارت‌اند از duration، cpu_time، logical_reads، writes، row_count، result. این نام‌ها نقش راهنما دارند؛ چون نسخه نصب‌شده تعیین می‌کند هر ستون Data یا Action دقیقاً با چه نوعی در دسترس باشد. رویدادهای همراه پیشنهادی نیز module_end، sql_statement_completed، error_reported، attention هستند. انتخاب هم‌زمان همه آن‌ها همیشه لازم نیست و باید از سؤال عیب‌یابی مشتق شود.

نحو پایه Session برای rpc_completed

CREATE EVENT SESSION [XE_rpc_completed] ON SERVER
ADD EVENT sqlserver.rpc_completed
(
    ACTION
    (
        sqlserver.sql_text,
        sqlserver.database_id,
        sqlserver.session_id
    )
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\rpc_completed.xel');
GO

ده مثال عملی و غیرتکراری برای rpc_completed

مثال 1: شناسایی metadata رویداد rpc_completed

پیش از ساخت Session باید وجود رویداد، Package و توضیح ثبت‌شده روی همان سرور بررسی شود. این کار برای rpc_completed به‌خصوص در محیط‌هایی با نسخه‌های متفاوت از خطای نامعتبر بودن Event جلوگیری می‌کند.

SELECT o.name AS event_name, p.name AS package_name, o.description
FROM sys.dm_xe_objects AS o
INNER JOIN sys.dm_xe_packages AS p ON p.guid = o.package_guid
WHERE o.object_type = N'event'
  AND o.name = N'rpc_completed';

نکته کاربردی: اگر خروجی خالی بود، ابتدا نسخه SQL Server و نام دقیق رویداد را بررسی کنید؛ این مرحله برای rpc_completed از ساخت اسکریپت ناسازگار جلوگیری می‌کند.

مثال 2: مشاهده ستون‌ها و داده‌های قابل ثبت در rpc_completed

ستون‌های Event باید از metadata خوانده شوند تا فیلتر و تحلیل بر اساس فیلدهای واقعاً موجود انجام شود. در این مثال، ستون‌های پیشنهادی مانند duration, cpu_time, logical_reads, writes, row_count, result با تعریف سرور مقایسه می‌شوند.

SELECT c.name AS column_name, c.type_name, c.column_type, c.description
FROM sys.dm_xe_object_columns AS c
WHERE c.object_name = N'rpc_completed'
ORDER BY c.column_id;

نکته کاربردی: این Query مبنای طراحی Parser است؛ به نام ستون‌های حدسی تکیه نکنید و ساختار همان نسخه را مستند سازید.

مثال 3: ساخت Session پایه برای rpc_completed با ring_buffer

برای آزمایش کوتاه و کنترل‌شده می‌توان از ring_buffer استفاده کرد. Session زیر اطلاعات زمینه‌ای مانند متن SQL، شناسه پایگاه داده و نام برنامه را در کنار رویداد rpc_completed نگه می‌دارد.

IF EXISTS (SELECT 1 FROM sys.server_event_sessions WHERE name = N'XE_rpc_completed_1')
    DROP EVENT SESSION [XE_rpc_completed_1] ON SERVER;
GO
CREATE EVENT SESSION [XE_rpc_completed_1] ON SERVER
ADD EVENT sqlserver.rpc_completed
(
    ACTION
    (
        sqlserver.sql_text,
        sqlserver.database_id,
        sqlserver.client_app_name,
        sqlserver.session_id
    )
)
ADD TARGET package0.ring_buffer
WITH (MAX_MEMORY = 4096 KB, EVENT_RETENTION_MODE = ALLOW_SINGLE_EVENT_LOSS);
GO

نکته کاربردی: ring_buffer برای نمونه‌برداری سریع مناسب است؛ برای نگه‌داری طولانی یا حجم بالای rpc_completed بهتر است event_file انتخاب شود.

مثال 4: اعمال Predicate اختصاصی روی rpc_completed

جمع‌آوری بدون فیلتر می‌تواند داده فراوان تولید کند. این نمونه با شرط [duration] > (1000000) تنها رخدادهای مهم‌تر را ثبت می‌کند و هزینه تحلیل را کاهش می‌دهد.

IF EXISTS (SELECT 1 FROM sys.server_event_sessions WHERE name = N'XE_rpc_completed_1_Filtered')
    DROP EVENT SESSION [XE_rpc_completed_1_Filtered] ON SERVER;
GO
CREATE EVENT SESSION [XE_rpc_completed_1_Filtered] ON SERVER
ADD EVENT sqlserver.rpc_completed
(
    ACTION (sqlserver.sql_text, sqlserver.database_id, sqlserver.session_id)
    WHERE ([duration] > (1000000))
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\rpccompleted_filtered.xel', max_file_size = 100, max_rollover_files = 4);
GO

نکته کاربردی: آستانه را بر اساس SLA و نرخ واقعی rpc_completed تنظیم کنید؛ مقدار نمونه نباید بدون اندازه‌گیری به محیط تولید منتقل شود.

مثال 5: شروع و توقف امن Session مربوط به rpc_completed

فعال‌سازی باید زمان‌بندی‌شده باشد تا داده فقط در بازه عیب‌یابی جمع‌آوری شود. Query زیر وضعیت Session را نیز بررسی می‌کند و از فرمان‌های تکراری جلوگیری می‌کند. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

IF NOT EXISTS
(
    SELECT 1
    FROM sys.dm_xe_sessions
    WHERE name = N'XE_rpc_completed_1'
)
    ALTER EVENT SESSION [XE_rpc_completed_1] ON SERVER STATE = START;
GO
-- پس از پایان بازه پایش
IF EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name = N'XE_rpc_completed_1')
    ALTER EVENT SESSION [XE_rpc_completed_1] ON SERVER STATE = STOP;
GO

نکته کاربردی: در محیط تولید زمان آغاز، پایان، دلیل فعال‌سازی و مالک تحلیل را در Change Log ثبت کنید.

مثال 6: خواندن Target حافظه‌ای rpc_completed

برای دیدن رخدادهای ring_buffer، داده Target به XML تبدیل می‌شود. این روش برای مشاهده سریع مناسب است و نیاز به فایل خارجی ندارد. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

SELECT
    CAST(t.target_data AS xml) AS ring_buffer_xml
FROM sys.dm_xe_session_targets AS t
INNER JOIN sys.dm_xe_sessions AS s
    ON s.address = t.event_session_address
WHERE s.name = N'XE_rpc_completed_1'
  AND t.target_name = N'ring_buffer';

نکته کاربردی: ring_buffer ظرفیت محدود دارد و با ورود رخدادهای جدید، داده قدیمی ممکن است حذف شود؛ برای تحلیل تاریخی از فایل استفاده کنید.

مثال 7: خواندن فایل‌های XEL مربوط به rpc_completed

در Sessionهای پایدار، event_file قابلیت مرور و آرشیو مناسب‌تری دارد. این Query همه فایل‌های چرخشی مرتبط با rpc_completed را به ترتیب زمانی برمی‌گرداند.

SELECT
    object_name,
    file_name,
    file_offset,
    CAST(event_data AS xml) AS event_xml
FROM sys.fn_xe_file_target_read_file
(
    N'C:\XE\rpccompleted_filtered*.xel',
    NULL, NULL, NULL
)
WHERE object_name = N'rpc_completed'
ORDER BY file_name, file_offset;

نکته کاربردی: Wildcard فقط باید فایل‌های Session هدف را پوشش دهد تا داده رویدادهای دیگر با تحلیل مخلوط نشود.

مثال 8: تجزیه زمان و Actionهای rpc_completed از XML

برای گزارش‌گیری، XML باید به ستون‌های جدولی تبدیل شود. نمونه زیر timestamp، session_id، database_id و sql_text را استخراج می‌کند و می‌توان فیلدهای اختصاصی rpc_completed را نیز افزود.

WITH EventData AS
(
    SELECT CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\rpccompleted_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'rpc_completed'
)
SELECT
    x.value('(event/@timestamp)[1]', 'datetime2(3)') AS utc_time,
    x.value('(event/action[@name="session_id"]/value)[1]', 'int') AS session_id,
    x.value('(event/action[@name="database_id"]/value)[1]', 'int') AS database_id,
    x.value('(event/action[@name="sql_text"]/value)[1]', 'nvarchar(max)') AS sql_text
FROM EventData;

نکته کاربردی: Timestamp رویداد معمولاً باید با منطقه زمانی سامانه گزارش‌گیری هماهنگ شود؛ تبدیل را در لایه نمایش یا ETL به‌صورت صریح انجام دهید.

خطاهای رایج در کار با rpc_completed

• ساخت Predicate بر اساس ستونی که در metadata نسخه نصب‌شده وجود ندارد؛ پیش از اجرا، تعریف rpc_completed را از DMVها بخوانید.
• فعال کردن rpc_completed بدون محدودیت database_id، session_id یا آستانه مناسب و سپس پر شدن سریع Target.
• افزودن Actionهای زیاد مانند sql_text در همه رخدادها بدون ارزیابی امنیت و سربار.؛ با تمرکز اختصاصی بر rpc_completed
• خواندن مستقیم XML در هر بار نمایش داشبورد به جای تبدیل دوره‌ای به جدول Stage.؛ با تمرکز اختصاصی بر rpc_completed
• نتیجه‌گیری از یک رخداد منفرد بدون مقایسه با طرح اجرا، انتظارها، لاگ برنامه و شاخص‌های سیستم.؛ با تمرکز اختصاصی بر rpc_completed

ملاحظات Performance و ظرفیت‌سنجی rpc_completed

ثبت بدون فیلتر در سامانه پرترافیک می‌تواند حجم رویداد زیادی ایجاد کند و خواندن متن SQL نیز باید با رعایت محرمانگی انجام شود. هزینه Session فقط از نام Event تعیین نمی‌شود؛ تعداد رخداد در ثانیه، Actionهای انتخابی، Predicate، نوع Target، سرعت دیسک و MAX_DISPATCH_LATENCY همگی اثر دارند. بهترین روش، اجرای آزمایشی در بار مشابه تولید و مقایسه CPU، I/O، حجم XEL و نرخ از دست رفتن رخدادها است.

برای این موضوع، توصیه عملی چنین است: بر اساس database_id، نام برنامه و آستانه duration فیلتر کنید و برای نگه‌داری طولانی از event_file استفاده کنید. همچنین فایل‌ها باید سقف اندازه و تعداد Rollover داشته باشند تا پایش به مصرف کنترل‌نشده فضای ذخیره‌سازی منجر نشود. اگر داده برای حسابرسی لازم است، انتقال به مخزن جداگانه و سیاست Retention مستند ضروری خواهد بود.

مثال 9: مدیریت رفتار NULL هنگام تحلیل rpc_completed

همه Actionها یا Data Fieldها در تمام رخدادها مقدار ندارند. با NULLIF و COALESCE می‌توان خروجی خوانا ساخت بدون آنکه نبود داده با مقدار صفر اشتباه گرفته شود. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

WITH Parsed AS
(
    SELECT
        CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\rpccompleted_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'rpc_completed'
)
SELECT
    COALESCE
    (
        NULLIF(x.value('(event/action[@name="client_app_name"]/value)[1]', 'nvarchar(256)'), N''),
        N'برنامه نامشخص'
    ) AS client_app_name
FROM Parsed;

نکته کاربردی: در انبار داده، NULL را بدون تصمیم طراحی به رشته ثابت تبدیل نکنید؛ نسخه خام و نسخه نمایشی را جدا نگه دارید.

مثال 10: پایش کم‌هزینه و قابل حذف برای rpc_completed

نمونه نهایی Session را با event_file چرخشی، Startup State غیرفعال و تنظیم Dispatch مناسب می‌سازد. سپس دستور حذف کنترل‌شده ارائه می‌شود تا محیط پس از عیب‌یابی پاک بماند. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

CREATE EVENT SESSION [XE_rpc_completed_1_Production] ON SERVER
ADD EVENT sqlserver.rpc_completed
(
    ACTION (sqlserver.database_id, sqlserver.session_id, sqlserver.client_app_name)
    WHERE ([duration] > (1000000))
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\rpccompleted_prod.xel', max_file_size = 128, max_rollover_files = 8)
WITH
(
    MAX_MEMORY = 8192 KB,
    EVENT_RETENTION_MODE = ALLOW_SINGLE_EVENT_LOSS,
    MAX_DISPATCH_LATENCY = 10 SECONDS,
    TRACK_CAUSALITY = ON,
    STARTUP_STATE = OFF
);
GO
-- پاک‌سازی پس از اتمام تحلیل
DROP EVENT SESSION [XE_rpc_completed_1_Production] ON SERVER;
GO

نکته کاربردی: برای rpc_completed تعادل میان از دست ندادن رخداد و سربار را بر اساس حساسیت مسئله انتخاب کنید؛ همیشه Session آزمایشی را در بار مشابه تولید بسنجید.

بهترین روش‌های طراحی راهکار rpc_completed

1. سؤال عیب‌یابی را پیش از انتخاب rpc_completed بنویسید و مشخص کنید چه تصمیمی باید از داده حاصل شود.
2. نام Session، مسیر فایل و مدت فعال بودن rpc_completed را استاندارد و قابل ردیابی انتخاب کنید.
3. Actionها را حداقلی نگه دارید و فقط داده‌ای را ثبت کنید که در تحلیل یا همبستگی استفاده خواهد شد.؛ با تمرکز اختصاصی بر rpc_completed
4. زمان UTC رویداد را با ساعت برنامه، سیستم‌عامل و داشبورد هم‌تراز کنید.؛ با تمرکز اختصاصی بر rpc_completed
5. پس از اصلاح، همان سناریو را تکرار و معیار قبل و بعد را با روش یکسان مقایسه کنید.؛ با تمرکز اختصاصی بر rpc_completed
6. Sessionهای موقت را حذف کنید و برای Sessionهای دائمی مالک، هدف، ظرفیت و بازبینی دوره‌ای تعیین کنید.؛ با تمرکز اختصاصی بر rpc_completed

سؤالات متداول اختصاصی rpc_completed

rpc_completed دقیقاً چه زمانی برای تحلیل مفید است؟

هنگامی مفید است که مسئله شما به پایان فراخوانی‌های RPC مربوط باشد و لازم باشد داده واقعی اجرای SQL Server را با زمان، Session و متن درخواست تطبیق دهید.

آیا می‌توان rpc_completed را برای آموزش مبتدیان استفاده کرد؟

بله، بهتر است آموزش با metadata، یک ring_buffer کوتاه و سپس خواندن XML شروع شود تا دانشجو بدون پیچیدگی زیاد چرخه کامل rpc_completed را ببیند.

برای پروژه تجاری چه مدت rpc_completed را فعال نگه داریم؟

مدت مناسب به نرخ رخداد و SLA وابسته است؛ معمولاً بازه کوتاه و هدفمند با فایل چرخشی بهتر از فعال‌سازی دائمی و بدون فیلتر است. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

چگونه خروجی rpc_completed را وارد داشبورد سازمانی کنیم؟

فایل‌های XEL را در یک فرآیند زمان‌بندی‌شده بخوانید، XML را به جدول Stage تبدیل کنید و سپس شاخص‌های موردنیاز را با کلید زمان، Session و پایگاه داده مدل کنید. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

تفاوت rpc_completed با module_end چیست؟

rpc_completed روی پایان فراخوانی‌های RPC تمرکز دارد، در حالی که module_end زاویه دیگری از اجرای درخواست را ثبت می‌کند؛ ترکیب آن‌ها تصویر کامل‌تری می‌دهد.

برای راه‌اندازی پایش rpc_completed چه خدماتی لازم است؟

در پروژه‌های حساس، طراحی Predicate، ظرفیت فایل، Parser XML، داشبورد و سیاست نگه‌داری باید متناسب با بار واقعی انجام شود و می‌توان از مشاوره یا اجرای تخصصی SQL Server استفاده کرد. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

رایج‌ترین خطا هنگام ساخت Session rpc_completed چیست؟

استفاده از نام ستون یا Predicate بدون بررسی metadata همان نسخه، فعال‌سازی بدون محدودیت و فراموش کردن توقف Session از خطاهای رایج هستند. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

rpc_completed چه اثری بر Performance دارد؟

اثر آن به نرخ رویداد، Actionها، Target و فیلتر بستگی دارد. ثبت بدون فیلتر در سامانه پرترافیک می‌تواند حجم رویداد زیادی ایجاد کند و خواندن متن SQL نیز باید با رعایت محرمانگی انجام شود. بنابراین آزمایش سربار و تعیین آستانه ضروری است.

بهترین روش نگه‌داری داده rpc_completed چیست؟

برای تحلیل پایدار از event_file چرخشی، مسیر امن، سقف حجم، آرشیو زمان‌دار و پاک‌سازی خودکار استفاده کنید و داده حساس را کنترل دسترسی دهید. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

آیا rpc_completed در همه نسخه‌های SQL Server یکسان است؟

خیر، رویدادها و ستون‌ها ممکن است میان نسخه‌ها، Editionها یا محیط‌های Managed تفاوت داشته باشند؛ sys.dm_xe_objects و sys.dm_xe_object_columns منبع نهایی همان سرور هستند. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

سؤال‌های مصاحبه درباره rpc_completed

1. چگونه وجود rpc_completed و ستون‌های آن را روی نسخه هدف بررسی می‌کنید؟
2. چه زمانی ring_buffer را برای rpc_completed انتخاب می‌کنید و چه زمانی event_file را؟
3. برای کاهش سربار rpc_completed چه Predicate و Actionهایی پیشنهاد می‌دهید؟
4. چگونه داده XML مربوط به rpc_completed را به گزارش جدولی تبدیل می‌کنید؟
5. چه رویدادهای همراهی برای تفسیر درست rpc_completed لازم می‌دانید و چرا؟

چک‌لیست نهایی اجرای rpc_completed

• تأیید metadata و سازگاری نسخه
• تعریف سؤال و آستانه جمع‌آوری
• انتخاب Target و سقف فایل
• آزمون سربار در بار مشابه
• ثبت زمان شروع و پایان
• تجزیه XML و حفظ نسخه خام
• مقایسه قبل و بعد از اصلاح
• حذف یا بازبینی Session پس از پایان؛ با تمرکز اختصاصی بر rpc_completed

جمع‌بندی آموزش rpc_completed

rpc_completed زمانی ارزشمند است که به‌صورت هدفمند برای تفکیک هزینه فراخوانی‌های پارامتری، رویه‌های ذخیره‌شده و دستورهایی که درایورهای کلاینت به شکل RPC ارسال می‌کنند استفاده شود. Session خوب، کوچک، قابل توقف، دارای خروجی قابل تحلیل و متصل به تصمیم فنی است. با اجرای مثال‌های این مقاله می‌توان از کشف metadata تا ساخت فایل XEL و تحلیل خروجی پیش رفت، سپس یافته‌ها را با module_end و sql_statement_completed تکمیل کرد.

برای مقایسه این Event با سایر رخدادها، دوباره به مقاله مادر رویدادهای مهم Performance در SQL Server بازگردید. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

خدمات برنامه‌نویسی و پایگاه داده؛ ویژه rpc_completed

برنامه‌نویسی در اصفهان

قبول سفارش‌های برنامه‌نویسی و پایگاه داده: 09131253620؛ ویژه rpc_completed

انجام پروژه‌های برنامه‌نویسی، آموزش برنامه‌نویسی و آموزش پایگاه داده SQL Server با رویکرد حرفه‌ای و قابل توسعه. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

مجموعه‌ای معتبر با سابقه فعالیت حرفه‌ای از سال ۱۳۷۵ شمسی؛ ویژه rpc_completed

از سال ۱۳۷۵ شمسی تاکنون در زمینه طراحی و اجرای پروژه‌های برنامه‌نویسی، پایگاه داده، سیستم‌های تحت وب، وب‌سایت و راهکارهای نرم‌افزاری فعالیت می‌کنیم. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

• دانلود پروژه‌های مجانی برنامه‌نویسی سی‌شارپ؛ با تمرکز اختصاصی بر rpc_completed
• دانلود پروژه‌های رایگان پایگاه داده SQL Server؛ با تمرکز اختصاصی بر rpc_completed
• دانلود پروژه‌های رایگان Microsoft Access؛ با تمرکز اختصاصی بر rpc_completed
• دانلود پروژه‌های UML و نمودارهای مهندسی نرم‌افزار؛ با تمرکز اختصاصی بر rpc_completed
• دانلود پروژه‌های ASP.NET Web Forms همراه مستندات؛ با تمرکز اختصاصی بر rpc_completed
• دانلود گزارش‌های کارآموزی رایگان؛ با تمرکز اختصاصی بر rpc_completed
• دانلود طرح‌های توجیهی و پروژه‌های کارآفرینی؛ با تمرکز اختصاصی بر rpc_completed
• دانلود پروژه‌های Multimedia Builder همراه مستندات؛ با تمرکز اختصاصی بر rpc_completed

برای سفارش پروژه‌های برنامه‌نویسی و پایگاه داده، سیستم‌های تحت وب، وب‌سایت و راهکارهای نرم‌افزاری جدید، با شماره تلفن همراه 09131253620 تماس حاصل فرمایید. این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

ایتا، واتساپ و تماس مستقیم: +989131253620 این نکته در پرونده فنی rpc_completed با داده همان رویداد ارزیابی می‌شود.

تماس با ما