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

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

فیلدهای مهمی که باید بر اساس metadata سرور بررسی شوند عبارت‌اند از error_number، severity، state، message، category، session_id. این نام‌ها نقش راهنما دارند؛ چون نسخه نصب‌شده تعیین می‌کند هر ستون Data یا Action دقیقاً با چه نوعی در دسترس باشد. رویدادهای همراه پیشنهادی نیز attention، xml_deadlock_report، rpc_completed، sql_statement_completed هستند. انتخاب هم‌زمان همه آن‌ها همیشه لازم نیست و باید از سؤال عیب‌یابی مشتق شود.

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

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

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

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

پیش از ساخت Session باید وجود رویداد، Package و توضیح ثبت‌شده روی همان سرور بررسی شود. این کار برای error_reported به‌خصوص در محیط‌هایی با نسخه‌های متفاوت از خطای نامعتبر بودن 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'error_reported';

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

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

ستون‌های Event باید از metadata خوانده شوند تا فیلتر و تحلیل بر اساس فیلدهای واقعاً موجود انجام شود. در این مثال، ستون‌های پیشنهادی مانند error_number, severity, state, message, category, session_id با تعریف سرور مقایسه می‌شوند.

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'error_reported'
ORDER BY c.column_id;

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

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

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

IF EXISTS (SELECT 1 FROM sys.server_event_sessions WHERE name = N'XE_error_reported_1')
    DROP EVENT SESSION [XE_error_reported_1] ON SERVER;
GO
CREATE EVENT SESSION [XE_error_reported_1] ON SERVER
ADD EVENT sqlserver.error_reported
(
    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 برای نمونه‌برداری سریع مناسب است؛ برای نگه‌داری طولانی یا حجم بالای error_reported بهتر است event_file انتخاب شود.

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

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

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

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

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

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

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

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

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

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

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_error_reported_1'
  AND t.target_name = N'ring_buffer';

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

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

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

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\errorreported_filtered*.xel',
    NULL, NULL, NULL
)
WHERE object_name = N'error_reported'
ORDER BY file_name, file_offset;

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

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

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

WITH EventData AS
(
    SELECT CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\errorreported_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'error_reported'
)
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 به‌صورت صریح انجام دهید.

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

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

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

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

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

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

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

WITH Parsed AS
(
    SELECT
        CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\errorreported_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'error_reported'
)
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: پایش کم‌هزینه و قابل حذف برای error_reported

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

CREATE EVENT SESSION [XE_error_reported_1_Production] ON SERVER
ADD EVENT sqlserver.error_reported
(
    ACTION (sqlserver.database_id, sqlserver.session_id, sqlserver.client_app_name)
    WHERE ([severity] >= (16))
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\errorreported_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_error_reported_1_Production] ON SERVER;
GO

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

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

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

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

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

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

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

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

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

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

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

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

تفاوت error_reported با attention چیست؟

error_reported روی خطاهای گزارش‌شده توسط SQL Server تمرکز دارد، در حالی که attention زاویه دیگری از اجرای درخواست را ثبت می‌کند؛ ترکیب آن‌ها تصویر کامل‌تری می‌دهد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

error_reported زمانی ارزشمند است که به‌صورت هدفمند برای ساخت پایش متمرکز خطاهای مهم، تفکیک خطاهای کاربردی و سیستمی، یافتن Query یا Session مبدأ و تحلیل الگوهای تکرارشونده استفاده شود. Session خوب، کوچک، قابل توقف، دارای خروجی قابل تحلیل و متصل به تصمیم فنی است. با اجرای مثال‌های این مقاله می‌توان از کشف metadata تا ساخت فایل XEL و تحلیل خروجی پیش رفت، سپس یافته‌ها را با attention و xml_deadlock_report تکمیل کرد.

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

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

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

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

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

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

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

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

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

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

تماس با ما