مرونة اكتشاف الخدمة (معاينة)

باستخدام مرونة Azure Container Apps، يمكنك منع فشل طلب الخدمة واكتشافه واسترداده بشكل استباقي باستخدام نهج المرونة البسيطة. في هذه المقالة، ستتعلم كيفية تكوين نهج مرونة Azure Container Apps عند بدء الطلبات باستخدام اكتشاف خدمة Azure Container Apps.

النهج سارية المفعول لكل طلب إلى تطبيق حاوية. يمكنك تخصيص النهج لتطبيق الحاوية الذي يقبل الطلبات بتكوينات مثل:

• عدد مرات إعادة المحاولة
• إعادة المحاولة ومدة المهلة
• إعادة محاولة التطابق
• أخطاء متتالية في قاطع الدائرة وغيرها

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

نهج المرونة المدعومة

• مهلات
• إعادة المحاولة (HTTP وTCP)
• قاطعات الدوائر
• تجمعات الاتصال (HTTP وTCP)

تكوين نهج المرونة

سواء قمت بتكوين نهج المرونة باستخدام Bicep أو CLI أو مدخل Microsoft Azure، يمكنك تطبيق نهج واحد فقط لكل تطبيق حاوية.

عند تطبيق نهج على تطبيق حاوية، يتم تطبيق القواعد على جميع الطلبات المقدمة إلى تطبيق الحاوية هذا، وليس على الطلبات المقدمة من تطبيق الحاوية هذا. على سبيل المثال، يتم تطبيق نهج إعادة المحاولة على تطبيق حاوية يسمى App B. تتم إعادة محاولة جميع الطلبات الواردة إلى التطبيق B تلقائيا عند الفشل. ومع ذلك، فإن الطلبات الصادرة المرسلة من قبل التطبيق B غير مضمونة لإعادة المحاولة في الفشل.

resource myPolicyDoc 'Microsoft.App/containerApps/resiliencyPolicies@2023-11-02-preview' = {
  name: 'my-app-resiliency-policies'
  parent: '${appName}'
  properties: {
    timeoutPolicy: {
        responseTimeoutInSeconds: 15
        connectionTimeoutInSeconds: 5
    }
    httpRetryPolicy: {
        maxRetries: 5
        retryBackOff: {
          initialDelayInMilliseconds: 1000
          maxIntervalInMilliseconds: 10000
        }
        matches: {
            headers: [
                {
                    header: 'x-ms-retriable'
                    match: { 
                        exactMatch: 'true'
                    }
                }
            ]
            httpStatusCodes: [
                502
                503
            ]
            errors: [
                'retriable-status-codes'
                '5xx'
                'reset'
                'connect-failure'
                'retriable-4xx'
            ]
        }
    } 
    tcpRetryPolicy: {
        maxConnectAttempts: 3
    }
    circuitBreakerPolicy: {
        consecutiveErrors: 5
        intervalInSeconds: 10
        maxEjectionPercent: 50
    }
    tcpConnectionPool: {
        maxConnections: 100
    }
    httpConnectionPool: {
        http1MaxPendingRequests: 1024
        http2MaxRequests: 1024
    }
  }
}

az login

az extension show --name containerapp
az extension update --name containerapp

az containerapp resiliency create --group MyResourceGroup --name MyResiliencyName --container-app-name MyContainerApp --recommended

httpRetryPolicy:
  matches:
    errors:
    - 5xx
  maxRetries: 3
  retryBackOff:
    initialDelayInMilliseconds: 1000
    maxIntervalInMilliseconds: 10000
tcpRetryPolicy:
  maxConnectAttempts: 3
timeoutPolicy:
  connectionTimeoutInSeconds: 5
  responseTimeoutInSeconds: 60
circuitBreakerPolicy:
  consecutiveErrors: 5
  intervalInSeconds: 10
  maxEjectionPercent: 100

az containerapp resiliency update --group MyResourceGroup --name MyResiliency --container-app-name MyContainerApp --timeout 20 --timeout-connect 5

az containerapp resiliency create --group MyResourceGroup –n MyResiliency --container-app-name MyContainerApp –yaml <MY_YAML_FILE>

timeoutPolicy:
  responseTimeoutInSeconds: 30
  connectionTimeoutInSeconds: 5
httpRetryPolicy:
  maxRetries: 5
  retryBackOff:
    initialDelayInMilliseconds: 1000
    maxIntervalInMilliseconds: 10000
  matches:
    errors:
      - retriable-headers
      - retriable-status-codes
tcpRetryPolicy:
  maxConnectAttempts: 3
circuitBreakerPolicy:
  consecutiveErrors: 5
  intervalInSeconds: 10
  maxEjectionPercent: 50
tcpConnectionPool:
  maxConnections: 100
httpConnectionPool:
  http1MaxPendingRequests: 1024
  http2MaxRequests: 1024

az containerapp resiliency update --group MyResourceGroup --name MyResiliency --container-app-name MyContainerApp --timeout 20

az containerapp resiliency update --name MyResiliency --group MyResourceGroup --container-app-name MyContainerApp --yaml <MY_YAML_FILE>

az containerapp resiliency list --group MyResourceGroup --container-app-name MyContainerApp​

az containerapp resiliency show --group MyResourceGroup --name MyResiliency --container-app-name ​MyContainerApp

az containerapp resiliency delete --group MyResourceGroup --name MyResiliency --container-app-name ​MyContainerApp

مواصفات النهج

المهلات

يتم استخدام المهلات لإنهاء العمليات طويلة الأمد مبكرا. يتضمن نهج المهلة الخصائص التالية.

properties: {
  timeoutPolicy: {
      responseTimeoutInSeconds: 15
      connectionTimeoutInSeconds: 5
  }
}

إعادة المحاولات

تحديد أو tcpRetryPolicy httpRetryPolicy استراتيجية للعمليات الفاشلة. يتضمن نهج إعادة المحاولة التكوينات التالية.

httpRetryPolicy

properties: {
    httpRetryPolicy: {
        maxRetries: 5
        retryBackOff: {
          initialDelayInMilliseconds: 1000
          maxIntervalInMilliseconds: 10000
        }
        matches: {
            headers: [
                {
                    header: 'x-ms-retriable'
                    match: { 
                       exactMatch: 'true'
                    }
                }
            ]
            httpStatusCodes: [
                502
                503
            ]
            errors: [
                'retriable-headers'
                'retriable-status-codes'
            ]
        }
    } 
}

تطابقات الرأس

إذا حددت retriable-headers الخطأ، يمكنك استخدام خصائص مطابقة العنوان التالية لإعادة المحاولة عندما تتضمن الاستجابة عنوانا معينا.

matches: {
  headers: [
    { 
      header: 'x-ms-retriable'
      match: {
        exactMatch: 'true'
      }
    }
  ]
}

Errors

يمكنك إجراء عمليات إعادة المحاولة على أي من الأخطاء التالية:

matches: {
  errors: [
    'retriable-headers'
    'retriable-status-codes'
    '5xx'
    'reset'
    'connect-failure'
    'retriable-4xx'
  ]
}

tcpRetryPolicy

properties: {
    tcpRetryPolicy: {
        maxConnectAttempts: 3
    }
}

قاطعات الدوائر

تحدد نهج قاطع الدائرة ما إذا كانت النسخة المتماثلة لتطبيق الحاوية تتم إزالتها مؤقتا من تجمع موازنة التحميل، استنادا إلى مشغلات مثل عدد الأخطاء المتتالية.

properties: {
    circuitBreakerPolicy: {
        consecutiveErrors: 5
        intervalInSeconds: 10
        maxEjectionPercent: 50
    }
}

تجمعات الاتصال

يحتفظ تجميع اتصال Azure Container App بمجموعة من الاتصالات المنشأة والقابلة لإعادة الاستخدام لتطبيقات الحاوية. يقلل تجمع الاتصال هذا من النفقات العامة لإنشاء اتصالات فردية وتفكيلها لكل طلب.

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

httpConnectionPool

properties: {
    httpConnectionPool: {
        http1MaxPendingRequests: 1024
        http2MaxRequests: 1024
    }
}

tcpConnectionPool

properties: {
    tcpConnectionPool: {
        maxConnections: 100
    }
}

إمكانية مراقبة المرونة

يمكنك تنفيذ إمكانية مراقبة المرونة عبر مقاييس تطبيق الحاوية وسجلات النظام.

سجلات المرونة

من قسم Monitoring في تطبيق الحاوية، حدد Logs.

في جزء Logs، اكتب استعلاما وقم بتشغيله للعثور على المرونة عبر سجلات نظام تطبيق الحاوية. على سبيل المثال، قم بتشغيل استعلام مشابه لما يلي للبحث عن أحداث المرونة وإظهار:

• طابع زمني
• اسم البيئة
• اسم تَطبيق الحاوية
• نوع المرونة والسبب
• تسجيل الرسائل

ContainerAppSystemLogs_CL
| where EventSource_s == "Resiliency"
| project TimeStamp_s, EnvironmentName_s, ContainerAppName_s, Type_s, EventSource_s, Reason_s, Log_s

انقر فوق تشغيل لتشغيل الاستعلام وعرض النتائج.

مقاييس المرونة

من قائمة Monitoring لتطبيق الحاوية، حدد Metrics. في جزء Metrics، حدد عوامل التصفية التالية:

• نطاق اسم تطبيق الحاوية.
• مساحة اسم مقاييس القياسات القياسية.
• مقاييس المرونة من القائمة المنسدلة.
• كيف تريد البيانات المجمعة في النتائج (حسب المتوسط، حسب الحد الأقصى، وما إلى ذلك).
• المدة الزمنية (آخر 30 دقيقة، آخر 24 ساعة، وما إلى ذلك).

على سبيل المثال، إذا قمت بتعيين مقياس Resiliency Request Retries في نطاق تطبيق الاختبار مع متوسط التجميع للبحث ضمن إطار زمني مدته 30 دقيقة، فستبدو النتائج كما يلي:

المحتوى ذو الصلة

راجع كيفية عمل المرونة لمكونات Dapr في Azure Container Apps.