Hizmet bulma dayanıklılığı

Azure Container Apps dayanıklılığıyla, basit dayanıklılık ilkelerini kullanarak hizmet isteği hatalarını proaktif olarak önleyebilir, algılayabilir ve kurtarabilirsiniz. Bu makalede, Azure Container Apps hizmet bulma kullanarak istekleri başlatırken Azure Container Apps dayanıklılık ilkelerini yapılandırmayı öğreneceksiniz.

İlkeler, bir kapsayıcı uygulamasına yapılan her istek için geçerli olur. Kapsayıcı uygulamasına, aşağıdaki gibi yapılandırmalarla istekleri kabul eden ilkeleri uyarlayabilirsiniz:

• Yeniden deneme sayısı
• Yeniden deneme ve zaman aşımı süresi
• Yeniden deneme eşleşmeleri
• Devre kesici ardışık hataları ve diğerleri

Aşağıdaki ekran görüntüsünde, uygulamanın başarısız isteklerden kurtarmayı denemek için yeniden deneme ilkesini nasıl kullandığı gösterilmektedir.

Desteklenen dayanıklılık ilkeleri

• Zaman aşımı
• Yeniden denemeler (HTTP ve TCP)
• Devre kesiciler
• Bağlantı havuzları (HTTP ve TCP)

Dayanıklılık ilkelerini yapılandırma

Dayanıklılık ilkelerini Bicep, CLI veya Azure portalı kullanarak yapılandırırsanız kapsayıcı uygulaması başına yalnızca bir ilke uygulayabilirsiniz.

Bir kapsayıcı uygulamasına ilke uyguladığınızda, kurallar bu kapsayıcı uygulamasından yapılan isteklere değil, bu kapsayıcı uygulamasına yapılan tüm isteklere uygulanır. Örneğin, adlı App Bbir kapsayıcı uygulamasına yeniden deneme ilkesi uygulanır. Uygulama B'ye yapılan tüm gelen istekler hata durumunda otomatik olarak yeniden denenecek. Ancak, Uygulama B tarafından gönderilen giden isteklerin hata durumunda yeniden denemesi garanti edilmemektedir.

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

İlke belirtimleri

Zaman aşımları

Zaman aşımları, uzun süre çalışan işlemleri erken sonlandırmak için kullanılır. Zaman aşımı ilkesi aşağıdaki özellikleri içerir.

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

Yeniden deneme sayısı

Başarısız işlemler için bir tcpRetryPolicy httpRetryPolicy veya stratejisi tanımlayın. Yeniden deneme ilkesi aşağıdaki yapılandırmaları içerir.

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'
            ]
        }
    } 
}

Üst bilgi eşleşmeleri

Hatayı belirttiyseniz retriable-headers , yanıt belirli bir üst bilgi içerdiğinde yeniden denemek için aşağıdaki üst bilgi eşleştirme özelliklerini kullanabilirsiniz.

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

Hatalar

Aşağıdaki hatalardan herhangi birinde yeniden denemeler gerçekleştirebilirsiniz:

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

tcpRetryPolicy

properties: {
    tcpRetryPolicy: {
        maxConnectAttempts: 3
    }
}

Devre kesiciler

Devre kesici ilkeleri, ardışık hata sayısı gibi tetikleyicilere bağlı olarak bir kapsayıcı uygulaması çoğaltmasının yük dengeleme havuzundan geçici olarak kaldırılıp kaldırılmayacağını belirtir.

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

Bağlantı havuzları

Azure Container App'in bağlantı havuzu, kapsayıcı uygulamalarına kurulan ve yeniden kullanılabilir bağlantılardan oluşan bir havuz tutar. Bu bağlantı havuzu, her istek için tek tek bağlantıları oluşturma ve kaldırma yükünü azaltır.

Bağlantı havuzları, bir hizmet için izin verilen en fazla istek veya bağlantı sayısını belirtmenize olanak sağlar. Bu sınırlar, her hizmet için toplam eşzamanlı bağlantı sayısını denetler. Bu sınıra ulaşıldığında, mevcut bağlantılar serbest bırakılana veya kapatılana kadar bu hizmete yeni bağlantılar kurulamaz. Bağlantıları yönetme işlemi, kaynakların istekler tarafından aşırı yüklenmesini önler ve verimli bağlantı yönetimi sağlar.

httpConnectionPool

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

tcpConnectionPool

properties: {
    tcpConnectionPool: {
        maxConnections: 100
    }
}

Dayanıklılık gözlemlenebilirliği

Kapsayıcı uygulamanızın ölçümleri ve sistem günlükleri aracılığıyla dayanıklılık gözlemlenebilirliği gerçekleştirebilirsiniz.

Dayanıklılık günlükleri

Kapsayıcı uygulamanızın İzleme bölümünde Günlükler'i seçin.

Günlükler bölmesinde, kapsayıcı uygulama sistemi günlükleriniz aracılığıyla dayanıklılığı bulmak için bir sorgu yazın ve çalıştırın. Örneğin, dayanıklılık olaylarını aramak ve bunların durumunu göstermek için aşağıdakine benzer bir sorgu çalıştırın:

• Zaman damgası
• Ortam adı
• Kapsayıcı uygulama adı
• Dayanıklılık türü ve nedeni
• İletileri günlüğe kaydetme

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

Sorguyu çalıştırmak ve sonuçları görüntülemek için Çalıştır'a tıklayın.

Dayanıklılık ölçümleri

Kapsayıcı uygulamanızın İzleme menüsünde Ölçümler'i seçin. Ölçümler bölmesinde aşağıdaki filtreleri seçin:

• Kapsayıcı uygulamanızın adının kapsamı.
• Standart ölçüm ölçümleri ad alanı.
• Açılan menüden dayanıklılık ölçümleri.
• Verilerin sonuçlarda nasıl toplanmış (ortalama, maksimum vb.) nasıl toplanmış olacağınız.
• Süre (son 30 dakika, son 24 saat vb.).

Örneğin, Test-uygulama kapsamındaKi Dayanıklılık İsteği Yeniden Denemeleri ölçümünü Ortalama toplama ile 30 dakikalık bir zaman çerçevesi içinde arama yapmak üzere ayarlarsanız, sonuçlar aşağıdaki gibi görünür:

İlgili içerik

Azure Container Apps'teki Dapr bileşenleri için dayanıklılığın nasıl çalıştığını görün.