재시도 정책

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분

    • 단계에서 네트워크 장애 또는 요청 속도 제한과 같은 간헐적인 문제가 발생하면 실패한 요청을 자동으로 재시도합니다. 단계를 수동으로 다시 트리거할 필요가 없도록 재시도 정책을 설정합니다.

    기능

    재시도 정책은 다음과 같습니다.
    • 헤더, 상태, 응답 본문, 오류 및 HTTP 메서드를 기반으로 연결 시간 제한 또는 실패한 요청을 지원하기 위해 만들어졌습니다.
    • 지정된 연결 별칭을 사용하는 모든 작업에 적용됩니다.
    • 작업 단계에 직접 적용됩니다.
    재시도 정책을 사용하여 다음을 정의합니다.
    • 단계를 다시 시도하기 위해 충족해야 하는 조건입니다.
    • 단계를 재시도하기 전에 대기할 시간 간격입니다.
    • 중지하기 전에 단계에서 시도할 수 있는 최대 재시도 횟수입니다.
    기본 재시도 정책을 연결 및 자격 증명 별칭에 연결하고 모든 HTTP 연결에 재시도 정책을 적용합니다.
    주:
    JDBC, REST 및 SOAP 단계에 대해서만 재시도 정책을 만들 수 있습니다.

    재시도 정책 만들기

    단계에서 네트워크 장애 또는 요청 속도 제한과 같은 간헐적인 문제가 발생하면 실패한 요청을 자동으로 재시도합니다. 단계를 수동으로 다시 트리거할 필요가 없도록 재시도 정책을 설정합니다.

    시작하기 전에

    • 필요한 역할: connection_admin 또는 credential_admin

    프로시저

    1. 다음으로 이동 모두 > 통합 허브 > 재시도 정책 > 새로 작성.
    2. 양식의 필드에 내용을 입력합니다.
      표 1. 재시도 정책 양식
      필드 설명
      이름 재시도 정책을 고유하게 식별하기 위한 이름입니다.
      연결 유형 HTTP (영문)
      조건 재시도 정책을 트리거하기 위해 충족해야 하는 조건입니다. 재시도 정책을 트리거하는 조건에는 is, is not, contains 및 contains not 연산자가 포함됩니다.
      재시도 전략
      • 지수 백오프: 후속 재시도 시 시간 간격을 기하급수적으로 늘리는 옵션입니다. 승수는 2입니다.
      • 고정 간격: 재시도를 수행해야 하는 고정 시간 간격을 지정하는 옵션입니다.
      • Honor "Retry-After" 헤더: HTTP 요청의 Retry After 헤더 값에 반환된 날짜 및 시간 값에 따라 다시 시도를 지정하는 옵션입니다. 헤더에 대한 자세한 내용은 RFC 7231, 섹션 7.1.3: Retry-After를 참조하십시오.
        주:
        "Retry-After" 헤더 적용은 REST 및 SOAP 단계만 지원합니다.
      시간 간격(초) 재시도를 수행해야 하는 시간 간격(초)입니다. 이 필드는 지수 백오프 및 고정 간격 재시도 전략에만 적용됩니다.
      주:
      재시도 전략이 지수 백오프인 경우 최대 시도 횟수에 도달할 때까지 모든 재시도 후에 시간 간격이 기하급수적으로 증가합니다.
      개수 최대 재시도 횟수입니다. 이 필드는 지수 백오프 및 고정 간격 재시도 전략에만 적용됩니다. 값을 지정하지 않으면 최대 재시도 횟수는 시스템 속성에 제공된 glide.fdih.retry.max_count 값을 기준으로 합니다. glide.fdih.retry.max_count 시스템 속성의 기본값은 0입니다. 시스템 속성에 대한 자세한 내용은 사용 가능한 시스템 속성을 참조하십시오.
      최대 경과 시간 (초) 재시도가 중지되기까지의 최대 누적 시간(초)입니다. 이 필드는 재시도 전략에서 Honor "Retry-After" 헤더를 선택한 경우에만 나타납니다.
      주:
      속성에 최대 재시도 시간이 지정 glide.fdih.retry.max_time_in_seconds 되어 있으면 시스템 속성 값이 이 필드 값보다 우선합니다. 또한 최대 경과 시간이 시스템 속성 값 이상인지 확인합니다.
    3. 옵션: 다음 속성을 사용하여 전역 시스템 속성을 생성합니다.
      속성을 만드는 방법에 대한 자세한 내용은 시스템 속성 추가 항목을 참조하십시오. 이 시스템 속성을 사용하여 재시도 정책의 최대 시간(초)을 지정할 수 있습니다.
      필드 값
      이름 glide.fdih.retry.max_time_in_seconds
      유형 정수
      값 기본값: 86400 (초) 최대 지원 시간: 604800 (초)
    4. 제출을 클릭합니다.

    재시도 전략을 지수 백오프로 사용하는 재시도 정책

    그림 1. 샘플 재시도 정책
    재시도 전략이 지수 백오프인 경우 샘플 재시도 정책
    이 예시에서는 다음 조건 중 하나가 충족될 때 재시도를 시도하도록 정책이 정의됩니다.
    • HTTP 메서드는 GET이고 오류는 연결 시간 제한입니다
    • HTTP 메서드가 GET이고 상태 코드가 429임
    조건이 충족되면 최대 3회까지 재시도가 수행됩니다. 재시도 사이의 시간 간격이 기하급수적으로 증가합니다. 이 예제의 시간 간격은 10초, 20초, 40초입니다.

    다음에 수행할 작업

    • 필요한 별칭이 없는 경우 연결 및 자격 증명 별칭을 생성합니다.
    • 재시도 정책을 필요한 연결 및 자격 증명 별칭에 기본 재시도 정책 으로 할당합니다.
      주:
      기본 재시도 정책이 제공되며 기본 재시도 정책으로 선택됩니다. 재시도 정책을 생성한 경우 필요한 정책을 기본 재시도 정책으로 선택할 수 있습니다.
    • 연결 및 자격 증명 별칭에 대한 연결 관련 목록에서 HTTP 연결을 작성합니다. 자세한 내용은 연결 및 자격 증명을 참조하십시오.
    • 다음으로 이동하여 재시도 시도의 상세 정보를 확인하고 확인합니다. 시스템 로그 > 아웃바운드 HTTP 요청.