# فشل التكامل (Integration Failure Rate)

> نسبة عمليات مزامنة التكامل التي فشلت أو نقلت بيانات ناقصة، إلى إجمالي عمليات المزامنة في الفترة.

- **المجال:** المنتج الرقمي (Product Management)
- **الوحدة:** %
- **تكرار القياس:** أسبوعي
- **الاتجاه المرغوب:** أقل أفضل
- **النوع:** تابع (Lagging)
- **الرابط:** https://kpihub.co/k/prod-integration-failure

## الهدف

حماية أقوى مانع تسرّب لديك، فالتكامل المعطّل يحوّل ميزة إلى مصدر إحباط يومي.

## لماذا هو مهم

- التكامل الفاشل بصمت أسوأ من غيابه: العميل يبني على بيانات ناقصة ولا يعلم
- الحساب المرتبط يعتمد على المزامنة يوميًّا، فالفشل يوقف عمله لا ميزة فيه
- أغلب الفشل من الطرف الآخر أو من تغيّر واجهته، فالمراقبة أهم من الإصلاح

## المعادلة

```
Integration Failure % = (Failed or partial sync runs ÷ Total sync runs) × 100
```

افصل الفشل الكامل عن النقل الجزئي. الجزئي أخطر لأنه لا ينبّه أحدًا، والعميل يكتشفه بعد أسابيع في تقرير ناقص لا يعرف سببه.

## مثال محسوب

‏184,000 عملية مزامنة في الأسبوع، فشل 2,208 كليًّا و4,048 نقلت بيانات ناقصة. الحساب: (6,256 ÷ 184,000) × 100 = 3.4%، والجزئي وحده 2.2%.

## النطاق الاسترشادي

تحت 1% للفشل الكامل وقريبًا من الصفر للنقل الجزئي. والجزئي هو المعيار الأهم لأنه لا يُكتشف إلا عند العميل.

## تحليل الاتجاه

- ارتفاعه بعد تحديث الطرف الآخر نمط معروف يستدعي مراقبة إصداراته
- تركّزه في تكامل واحد يعني واجهة الطرف الآخر تتغيّر بلا إشعار
- ارتفاع الجزئي مع ثبات الكامل هو الحالة الأخطر وأقلّها ملاحظةً

## أسئلة تشخيصية

- كم عميلًا يعمل على بيانات ناقصة الآن بلا أن يعلم؟
- هل نُبلغ العميل عند الفشل أم ننتظر أن يكتشف؟
- كم يستغرق اكتشاف الفشل؟ الصمت الطويل أخطر من الفشل نفسه

## نصائح عملية

- نبّه العميل عند كل فشل ولو كان جزئيًّا، فالصمت يفقد الثقة كاملة
- راقب إصدارات الطرف الآخر، فأغلب الفشل يأتي من تغييراته
- افصل الجزئي عن الكامل، فالأول أخطر وأقلّ ظهورًا

## العرض المناسب

- أعمدة بالتكامل لنسبة الفشل الكامل والجزئي
- خط زمني للفشل مع تعليم تحديثات الأطراف الأخرى
- توزيع زمن اكتشاف الفشل

## تحذيرات وفخاخ

- الفشل الجزئي الصامت يبني قرارات العميل على بيانات ناقصة
- عدم إبلاغ العميل يجعل اكتشافه المتأخّر يكلّف الثقة كاملة
- معالجة الفشل بإعادة المحاولة وحدها تخفي تغيّرًا دائمًا في الطرف الآخر

## أثر التغيير

- خفض الفشل الجزئي من 2.2% إلى قريب من الصفر يمنع قرارات مبنيّة على بيانات ناقصة
- التنبيه الفوري يحوّل عطلًا إلى ثقة: العميل يرى أنك تراقب نيابةً عنه
- مراقبة إصدارات الأطراف الأخرى تمنع أغلب الفشل قبل وقوعه

## احسبه في أداتك

### Excel

```excel
=(COUNTIFS(S[Status],"Failed")+COUNTIFS(S[Status],"Partial")) / COUNTA(S[RunID])
```

### Power BI (DAX)

```dax
Integration Failure % =
DIVIDE (
    CALCULATE ( COUNTROWS ( 'SyncRun' ), 'SyncRun'[Status] IN { "Failed", "Partial" } ),
    COUNTROWS ( 'SyncRun' )
)
```

### Tableau

```
SUM( IF [Status] <> 'Success' THEN 1 ELSE 0 END ) / COUNT([Run ID])
```

### SQL

```sql
SELECT integration_name,
       COUNT(*) FILTER (WHERE status = 'Failed')  * 100.0
         / NULLIF(COUNT(*), 0)                     AS full_failure_pct,
       COUNT(*) FILTER (WHERE status = 'Partial') * 100.0
         / NULLIF(COUNT(*), 0)                     AS partial_failure_pct,
       AVG(minutes_to_detect)                      AS detect_minutes
FROM   sync_run
WHERE  ran_at BETWEEN :from_date AND :to_date
GROUP  BY integration_name
ORDER  BY partial_failure_pct DESC;
```

---

المصدر: [KPIHub](https://kpihub.co/k/prod-integration-failure) · مرجع عربي مجاني لمؤشرات الأداء.