> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# الصحة والجاهزية

> مراقبة صحة API، ونقاط نهاية الجاهزية، وصفحة الحالة.

راقب صحة Truthlocks API، وتحقق من جاهزية التبعيات، وادمج مع مكدس المراقبة الخاص بك.

## نقاط نهاية الصحة

### فحص النشاط

تحقق مما إذا كانت واجهة برمجة التطبيقات قيد التشغيل. استخدمها لفحوصات حيوية Kubernetes:

```http theme={null}
GET https://api.truthlocks.com/health/live

# Response (200 OK)
{
  "status": "ok",
  "timestamp": "2026-01-13T12:00:00Z"
}
```

### فحص الجاهزية

تحقق مما إذا كانت واجهة برمجة التطبيقات جاهزة لخدمة حركة المرور (جميع التبعيات سليمة):

```http theme={null}
GET https://api.truthlocks.com/health/ready

# Response (200 OK - All systems operational)
{
  "status": "ok",
  "timestamp": "2026-01-13T12:00:00Z",
  "checks": {
    "database": "ok",
    "redis": "ok",
    "signing_service": "ok",
    "transparency_log": "ok"
  }
}
```

```http theme={null}
# Response (503 Service Unavailable - Degraded)
{
  "status": "degraded",
  "timestamp": "2026-01-13T12:00:00Z",
  "checks": {
    "database": "ok",
    "redis": "timeout",
    "signing_service": "ok",
    "transparency_log": "ok"
  }
}
```

## تكوين Kubernetes

إذا كنت تقوم بإنشاء تطبيقات تعتمد على Truthlocks، فقم بتكوين مجساتك للتحقق من تطبيقك وواجهة برمجة تطبيقات Truthlocks:

```yaml theme={null}
apiVersion: v1
kind: Deployment
metadata:
  name: my-app
spec:
  template:
    spec:
      containers:
        - name: app
          livenessProbe:
            httpGet:
              path: /health/live
              port: 8080
            initialDelaySeconds: 5
            periodSeconds: 10
          readinessProbe:
            httpGet:
              path: /health/ready
              port: 8080
            initialDelaySeconds: 10
            periodSeconds: 5
            failureThreshold: 3
```

### مثال على فحص الجاهزية (التطبيق)

```javascript theme={null}
// Include Truthlocks health in your app's readiness
app.get('/health/ready', async (req, res) => {
  const checks = {
    database: await checkDatabase(),
    truthlock: await checkTruthlock(),
  };

  const allHealthy = Object.values(checks).every(c => c === 'ok');

  res.status(allHealthy ? 200 : 503).json({
    status: allHealthy ? 'ok' : 'degraded',
    checks,
  });
});

async function checkTruthlock(): Promise<string> {
  try {
    const res = await fetch('https://api.truthlocks.com/health/ready', {
      timeout: 5000,
    });
    return res.ok ? 'ok' : 'degraded';
  } catch {
    return 'unreachable';
  }
}
```

## صفحة الحالة

تحقق من صحة الخدمة ووقت التشغيل في الوقت الفعلي على [status.truthlocks.com](https://status.truthlocks.com). يتم تحديث صفحة الحالة تلقائيًا كل 60 ثانية ولا تتطلب أي مصادقة.

### الخدمات المراقبة

تتبع صفحة الحالة صحة كل خدمة أساسية بشكل مستقل:

| الخدمة | الوصف |
| - | - |
| بوابة API | نقطة نهاية API الرئيسية لجميع الطلبات |
| سجل الثقة | إدارة المصدر والحوكمة |
| الفوترة | معالجة الاشتراكات والمدفوعات |
| التوقيع | عمليات التوقيع التشفيري |
| التصديقات | سك التصديقات وإدارتها |
| سجلات التدقيق | تسجيل النشاط والامتثال |
| سجل الشفافية | سجل تشفير إلحاقي فقط |
| التحقق | التحقق من حزمة الإثبات |
| هوية الجهاز | تسجيل الوكيل، الجلسات، وتسجيل نقاط الثقة |
| AI CMO | الإشراف على محتوى الذكاء الاصطناعي والتنسيق |

تُبلغ كل خدمة عن إحدى الحالات الأربع: **قيد التشغيل**، **متدهورة**، **متوقفة**، أو **غير معروفة**. تعرض الصفحة وقت استجابة لكل خدمة ولافتة صحة النظام بشكل عام.

### سجل وقت التشغيل

يعرض شريط وقت التشغيل لمدة 90 يومًا التوفر اليومي لكل خدمة. مرر مؤشر الماوس فوق أي يوم لرؤية التاريخ ونسبة وقت التشغيل. يتم عرض نسبة وقت التشغيل الإجمالية بجانب كل خدمة.

### سجل الحوادث

تفضل بزيارة صفحة **سجل الحوادث** للاطلاع على الحوادث السابقة بتنسيق زمني. يتضمن كل إدخال مستوى الخطورة والخدمات المتأثرة والتحديثات الموقوتة من التحقيق حتى الحل.

### الاشتراك في الإشعارات

أدخل بريدك الإلكتروني في أسفل صفحة الحالة لتلقي إشعارات الحوادث. سيتم إعلامك عند إنشاء الحوادث أو تحديثها أو حلها.

يمكن لعملاء المؤسسات أيضًا تكوين استدعاءات webhook لتلقي أحداث تغيير الحالة تلقائيًا.

### واجهة برمجة تطبيقات الحالة البرمجية

استعلام عن واجهة برمجة تطبيقات الحالة للحصول على صحة الخدمة القابلة للقراءة آليًا. استخدم هذا لدمج توفر Truthlocks في لوحات المعلومات الخاصة بك، أو مسارات التنبيه، أو فحوصات ما قبل التشغيل. لا يلزم المصادقة.

```http theme={null}
GET https://status.truthlocks.com/api/health
```

يعيد نقطة النهاية حالة النظام العامة، وطابعًا زمنيًا، ومصفوفة من فحوصات السلامة لكل خدمة:

```json theme={null}
{
  "status": "operational",
  "timestamp": "2026-03-26T14:30:00Z",
  "services": [
    {
      "id": "api-gateway",
      "name": "API Gateway",
      "status": "operational",
      "responseTime": 42
    },
    {
      "id": "signing-service",
      "name": "Signing",
      "status": "degraded",
      "responseTime": 1200,
      "error": "HTTP 503"
    }
  ]
}
```

**حقول الاستجابة:**

| الحقل | النوع | الوصف |
| - | - | - |
| `status` | string | الصحة العامة للنظام: `operational`، `degraded`، أو `outage`. |
| `timestamp` | string | طابع زمني بتنسيق ISO 8601 للتحقق. |
| `services` | array | نتائج صحة كل خدمة. |
| `services[].id` | string | معرّف الخدمة القابل للقراءة آليًا (مثل `api-gateway`، `signing-service`). |
| `services[].name` | string | اسم الخدمة المقروء بشريًا. |
| `services[].status` | string | صحة الخدمة: `operational`، `degraded`، أو `outage`. |
| `services[].responseTime` | number or null | وقت الاستجابة بالمللي ثانية، أو `null` إذا كان غير قابل للوصول. |
| `services[].error` | string | موجود فقط عندما تكون الخدمة غير عاملة. |

تكون الحالة العامة `outage` إذا كانت أي خدمة معطلة، و`degraded` إذا كانت أي خدمة بطيئة أو تُرجع أخطاء، و`operational` عندما تكون جميع الخدمات سليمة.

**مثال: استقصاء الحالة من تطبيقك**

```javascript theme={null}
async function checkTruthlockStatus() {
  const res = await fetch("https://status.truthlocks.com/api/health");
  const data = await res.json();

  if (data.status !== "operational") {
    console.warn(`Truthlocks is ${data.status}`);
    const issues = data.services.filter((s) => s.status !== "operational");
    issues.forEach((s) => console.warn(`  ${s.name}: ${s.status} — ${s.error}`));
  }

  return data;
}
```

**مثال: فحص ما قبل الإصدار قبل السك**

تحقق من أن خدمات التوقيع والتصديق سليمة قبل محاولة عملية سك. هذا يتجنب عمليات إعادة المحاولة غير الضرورية عندما تعلم بالفعل أن الخدمات المطلوبة معطلة.

```javascript theme={null}
async function mintWithStatusCheck(attestation) {
  const status = await fetch("https://status.truthlocks.com/api/health");
  const health = await status.json();

  const signing = health.services.find((s) => s.id === "signing-service");
  const attestations = health.services.find(
    (s) => s.id === "attestation-service"
  );

  if (
    signing?.status !== "operational" ||
    attestations?.status !== "operational"
  ) {
    throw new Error("Required services are not operational — retry later");
  }

  return client.attestations.mint(attestation);
}
```

> [!NOTE]
>
> تخضع واجهة برمجة تطبيقات الحالة لقيود المعدل لمنع إساءة الاستخدام. للمراقبة المستمرة،
> الاستقصاء ليس أكثر تكرارًا من مرة واحدة كل 30 ثانية.

للاطلاع على مخطط الاستجابة الكامل، ومعرفات الخدمة المراقبة، وأمثلة إضافية، راجع [مرجع واجهة برمجة تطبيقات الحالة](https://docs.truthlocks.com/ar/api-reference/health/status.md).

> [card] [صفحة الحالة](https://status.truthlocks.com)
>
> صحة الخدمة في الوقت الفعلي وسجل الحوادث.

> [card] إشعارات الويب هوك
>
> يمكن لعملاء المؤسسات تكوين استدعاءات webhook لتغييرات الحالة.

> [card] [مرجع واجهة برمجة تطبيقات الحالة](https://docs.truthlocks.com/api-reference/health/status.md)
>
> مرجع API كامل لنقطة نهاية الحالة البرمجية.

> [card] تنبيهات البريد الإلكتروني
>
> اشترك في صفحة الحالة لتلقي إشعارات الحوادث.

## التزامات مستوى الخدمة

تنطبق أهداف التوفر، وتغطية الدعم، وأوقات الاستجابة، وأرصدة الخدمة فقط عند الاتفاق عليها صراحةً في العقد المعمول به. تُبلغ فحوصات الصحة العامة عن حالة الخدمة المرصودة؛ وهي لا تحدد نسبة وقت تشغيل مضمونة، أو قدرة استرداد شاملة، أو جدول دعم مأهول. تأكد من النشر الحالي وأدلة الاسترداد قبل الاعتماد على التزام.

## تكامل المراقبة

دمج فحوصات صحة Truthlocks مع أدوات المراقبة الخاصة بك:

```yaml Prometheus theme={null}
# prometheus.yml
scrape_configs:
  - job_name: "truthlock-health"
    scrape_interval: 30s
    metrics_path: /metrics
    static_configs:
      - targets: ["api.truthlocks.com"]
```

```yaml Datadog theme={null}
# datadog.yaml
init_config:

instances:
  - name: truthlock_api
    url: https://api.truthlocks.com/health/ready
    timeout: 5
    content_match: '"status":"ok"'
    http_response_status_code: 200
    tags:
      - service:truthlock
      - env:production
```

```javascript Custom Dashboard Metrics theme={null}
// Export key metrics for dashboards
const metrics = {
  "truthlock.availability": isHealthy ? 1 : 0,
  "truthlock.latency_ms": responseTime,
  "truthlock.ratelimit_remaining": rateLimitRemaining,
  "truthlock.attestations_today": dailyCount,
};
```

## مرونة البوابة

تتضمن بوابة API استعادة تلقائية من الأعطال ودعم النشر بدون توقف:

* **استعادة من الذعر** — إذا واجهت البوابة خطأ داخليًا غير متوقع، فإنها تتعافى تلقائيًا وتعيد استجابة خطأ منظمة بدلاً من قطع اتصالك. لا تحتاج إلى التعامل مع الاتصالات المقطوعة الناتجة عن حالات الذعر على مستوى البوابة.
* **إيقاف التشغيل السلس** - أثناء عمليات النشر، تقوم خدمة البوابة والتوقيع بتصريف الطلبات الجارية على مدار 15 ثانية بدلاً من إنهائها فورًا. إذا كنت قد واجهت سابقًا فشلًا عرضيًا في الطلبات أثناء فترات الصيانة، فيجب ألا يحدث ذلك بعد الآن.

تعمل هذه الحماية تلقائيًا ولا تتطلب أي تغييرات على تكاملك.

## الاستجابة للحوادث

إذا كانت Truthlocks تواجه مشكلات:

1. **تحقق من صفحة الحالة:** [status.truthlocks.com](https://status.truthlocks.com)
2. **تمكين قاطع الدائرة:** افشل بأمان في تطبيقك
3. **عمليات قائمة الانتظار:** أعد محاولة سك الشهادة لاحقًا
4. **اتصل بالدعم:** لتصعيد اتفاقية مستوى الخدمة للمؤسسات

### نمط قاطع الدائرة

```javascript theme={null}
import CircuitBreaker from "opossum";

const breaker = new CircuitBreaker(
  async (attestation) => client.attestations.mint(attestation),
  {
    timeout: 5000, // Fail if no response in 5s
    errorThresholdPercentage: 50, // Open if 50% fail
    resetTimeout: 30000, // Try again after 30s
  },
);

breaker.fallback(() => {
  // Queue for retry later
  queue.add("retry-attestation", attestation);
  return { queued: true };
});
```

## الخطوات التالية

> [card] [لوحة تحكم قابلية المراقبة](https://docs.truthlocks.com/guides/observability.md)
>
> مراقبة صحة الخدمة، وزمن الوصول، والاستخدام من وحدة التحكم.

> [card] [مرجع الخطأ](https://docs.truthlocks.com/ops/errors.md)
>
> قائمة كاملة برموز الأخطاء ومعالجتها.

> [card] [حدود المعدل](https://docs.truthlocks.com/ops/limits.md)
>
> تعامل مع تحديد المعدل بأناقة.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.