자동 재시도로 플레이북 복원력 향상

다음에서 지원:

이 문서에서는 플레이북의 자동화된 작업이 네트워크 중단이나 API 비율 제한과 같은 일시적인 문제로 인해 실패하는 경우가 있다고 설명합니다. 플레이북의 복원력을 높이려면 이러한 오류가 발생할 경우 자동으로 재시도하도록 개별 작업을 구성하면 됩니다.

작업 재시도는 네트워크 문제, API 비율 제한, 서비스 사용 불가와 같은 일시적인 오류에서 플레이북이 복구하는 데 도움이 됩니다. 이러한 재시도는 보강, 차단, 알림과 같은 표준 플레이북 작업에 적용됩니다.

재시도 메커니즘은 표준 HTTP 오류 코드가 아닌 작업의 내부 실행 상태에 의해 트리거됩니다. 시간 제한이 발생한 작업이나 흐름 제어에 사용되는 작업 (예: 조건 또는 플레이북 블록)은 동일한 방식으로 실패하도록 설계되지 않았으므로 재시도가 시도되지 않습니다.

작업 재시도 메커니즘 조건

재시도 메커니즘은 일반적으로 일시적이거나 인프라 또는 처리되지 않은 실패를 나타내는 특정 조건에서 작업이 실패한 경우에만 트리거됩니다. 시간 초과 또는 흐름 제어 작업과 관련된 오류에는 활성화되지 않습니다.

재시도를 활성화하는 조건

재시도 메커니즘은 다음 상황에서 작업이 실패하는 경우에만 활성화됩니다.

  • 처리되지 않은 스크립트 오류: 스크립트에서 명시적으로 처리하지 않는 작업의 Python 스크립트 내에서 발생하는 오류 또는 예외입니다.
  • 명시적 실패 상태: 작업 스크립트가 실행 상태 EXECUTION_STATE_FAILED를 서버에 명시적으로 반환합니다.
  • 인프라 실패: 성공적인 결과를 방해하는 연결 문제 (예: Python 연결 오류)와 같은 기본 인프라에서 발생하는 실패입니다.

재시도를 우회하는 조건 (재시도 시도 없음)

제한 시간 또는 흐름 제어 작업과 관련된 실패 시나리오에서는 재시도가 우회됩니다.

  • 플레이북 실행 제한 시간: 작업이 완료되지 않고 특정 플레이북 단계에 대해 구성된 일반 제한 시간 내에 결과를 반환하지 않습니다.
  • 처리된 타임아웃 상태: 작업 스크립트가 상태 EXECUTION_STATE_TIMEOUT를 반환하여 내부 작업 타임아웃을 명시적으로 보고합니다. 서버는 이를 '처리된 시간 제한'으로 취급하므로 플레이북 실행이 재시도 없이 계속됩니다.

작업 재시도 구성

작업의 재시도를 구성하려면 다음 단계를 따르세요.

  1. 플레이북 디자이너에서 관련 작업을 더블클릭합니다.
  2. 사이드바에서 설정 탭을 클릭한 다음 실패 시 재시도 전환 버튼을 사용 설정으로 클릭합니다.
  3. 다음 매개변수를 지정합니다.
    • 재시도 횟수: 작업이 실패할 경우 다시 실행을 시도할 횟수를 입력합니다.
    • 재시도 간 지연 시간: 각 재시도 시도 간의 지연 시간을 초, 분 또는 시간 단위로 정의합니다.
  4. 단계가 실패하는 경우 섹션에서 모든 재시도 시도 후에도 작업이 최종적으로 실패하는 경우 다음 옵션 중 하나를 선택합니다.
    • 플레이북 중지: 플레이북 실행이 중지됩니다.
    • 단계 건너뛰기: 플레이북이 다음 단계로 계속됩니다.
  5. 저장을 클릭합니다.

플레이북 실행 중 재시도가 표시되는 방식

재시도가 있는 플레이북 단계가 실행되면 재시도 진행 상황을 나타내는 특정 상태와 메시지가 표시됩니다.

  • 재시도가 구성된 작업이 실패하면 다음 시도 전에 플레이북 탭의 상태가 일시적으로 다음 재시도 대기 중으로 변경됩니다.
  • 하나 이상의 재시도 후 작업이 성공하면 플레이북 탭의 최종 상태에 성공이 표시되고 재시도 횟수도 표시됩니다 (예: 2회 재시도 후 완료됨).
  • 모든 재시도 후에도 작업이 실패하면 최종 상태에 실패가 표시되고 재시도 횟수도 표시됩니다 (예: 3회 재시도 후 실패).
  • 재시도 시도에 관한 관련 정보도 케이스 월에 표시됩니다.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.