재시도 정책

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 3분

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

    기능

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

    재시도 정책 만들기

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

    시작하기 전에

    • 필요한 역할: connection_admin 또는 credential_admin

    프로시저

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

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

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

    다음에 수행할 작업

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