AI를 사용하여 실패한 실행 로그 문제 해결

Application Integration은 실패한 실행에 대한 AI 기반 문제 해결을 제공합니다. 이 기능은 Google Gemini를 사용하여 실행 로그를 분석하고, 근본 원인을 파악하고, 실행 가능한 추천을 생성합니다. Application Integration 내의 실행 로그 페이지에서 이 기능에 액세스할 수 있습니다.

참고: 사용자 데이터는 Gemini AI에 저장되지 않습니다.

주요 이점

Gemini AI 기반 문제 해결 기능을 사용하면 다음 작업을 할 수 있습니다.

• 복잡한 오류 메시지를 명확하게 이해할 수 있습니다. AI가 기술 로그를 명확하고 실행 가능한 통계로 변환합니다.
• 고유한 통합 로직과 발생한 특정 오류에 맞게 맞춤설정된 정확한 해결 단계를 제공받습니다.
• 수정사항의 근본 원인과 해결 단계를 파악하여 디버깅 시간을 줄입니다.

시작하기 전에

Gemini AI 문제 해결 기능을 사용하려면 다음 요건을 충족해야 합니다.

• 통합을 배포할 특정 Google Cloud 리전에 AI 기능을 사용 설정합니다. 새 리전 또는 기존 리전에서 AI 기능을 사용 설정하는 방법에 대한 자세한 내용은 문제 해결을 위한 AI 기능 사용 설정을 참고하세요.

문제 해결을 위한 AI 기능 사용 설정

실패한 실행을 문제 해결하기 위해 Gemini AI를 사용하려면 통합을 배포하는 특정 Google Cloud 리전의 AI 기능을 사용 설정하세요.

새 리전에서 AI 사용 설정

Application Integration에서 새 리전에 AI를 사용 설정하려면 다음 단계를 수행하세요.

1. Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.

   Application Integration으로 이동

2. 탐색 메뉴에서 리전을 클릭합니다. 프로젝트에 프로비저닝된 모든 리전이 나열된 리전 페이지가 표시됩니다.
3. 새 리전 프로비저닝을 클릭합니다.
4. 고급 설정을 펼칩니다.
5. AI 기능에서 AI 기능 사용 설정 전환 버튼을 클릭합니다.

기존 리전에서 AI 사용 설정

Application Integration에서 기존 리전에 AI를 사용 설정하려면 다음 단계를 수행하세요.

1. Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.

   Application Integration으로 이동

2. 탐색 메뉴에서 리전을 클릭합니다. 프로젝트에 프로비저닝된 모든 리전이 나열된 리전 페이지가 표시됩니다.
3. 수정하려는 기존 리전의 작업 열에서 리전 작업을 클릭하고 수정을 선택합니다.

   리전 수정 창이 나타납니다.

4. 고급 설정 섹션을 확장합니다.
5. AI 기능에서 AI 기능 사용 설정 전환 버튼을 클릭합니다.

AI를 사용하여 실패한 실행 문제 해결

참고: 이 기능을 사용하면 게시된 통합의 실패한 실행만 문제 해결할 수 있습니다.

Gemini AI를 사용하여 실패한 실행 로그를 문제 해결하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.

   Application Integration으로 이동

2. 탐색 메뉴에서 로그를 클릭합니다.

   기본 리전의 통합에 대해 생성된 실행 로그가 나열된 실행 로그 페이지가 표시됩니다.

3. 실행 로그 페이지에서 오류 실패 상태가 표시된 항목을 찾습니다.
4. 실패한 로그 항목 옆에 있는 chat_spark 아이콘을 클릭합니다.
   • 또는 특정 행을 펼치고 이 로그 항목 설명을 클릭합니다.

   그러면 다음 섹션이 포함된 Gemini 생성 오류 요약이 표시되는 오류 요약 페이지가 열립니다.

   • 오류 메시지: 기술 오류 설명을 표시하고 코드에서 오류가 발생하는 위치를 가리킵니다.
   • 근본 원인: 오류가 발생한 이유를 설명합니다.
   • 세부 분석: (이 섹션 펼치기) 오류의 영향, 관련 특정 코드 영역, 수정 방법에 관한 자세한 내용을 제공합니다.
   • 오류 수정 단계: 식별된 근본 원인에 맞는 해결 안내를 제공합니다.
   참고: REST 호출자 작업, 커넥터 작업, JavaScript 작업, 데이터 매핑 작업, Cloud 함수 작업, 데이터 변환기 작업 작업 유형에서 실패한 로그에 대한 자세한 디버깅 응답을 받을 수 있습니다. 이는 이러한 특정 작업 유형에 대해 Gemini 모델에 추가 안내가 제공되기 때문입니다.
   참고: Gemini 모델에서 대답을 생성하므로 문제 해결을 다시 시도하면 다른 대답이 표시될 수 있습니다.
   참고: AI 기능이 사용 중지된 경우 오류 요약 페이지에 처음 액세스하려고 하면 AI 기능 사용 설정 버튼이 표시됩니다.
   로드 시간: AI 분석으로 인해 오류 요약 페이지가 처음 액세스할 때 로드하는 데 최대 20초가 걸릴 수 있습니다.
5. 오류 요약을 검토하고 문제를 이해한 후 닫기를 클릭하여 실행 로그 페이지로 돌아갑니다.

AI 추천을 사용하여 문제 해결하기

오류 요약을 검토한 후 다음 단계를 완료하여 문제를 해결합니다.

1. 권장사항 따르기: 오류 요약 페이지의 오류 해결 단계 섹션에 설명된 권장 단계를 구현하고 통합 로직 또는 커넥터 구성을 필요한 대로 모두 변경합니다.
2. 테스트 및 재게시: 수정이 완료되면 업데이트된 통합을 테스트하고 재게시하여 문제가 완전히 해결되었는지 확인합니다.

오류 요약 예시

다음 예에서는 실패한 실행의 AI 생성 오류 요약을 설명합니다.

• 오류 메시지:

  RUNTIME ERROR: Index 0 out of bounds, not within [0, 0)
  template:16:2-59 function
  template:17:40-78 function
  :259:50-62 function
  :259:55-61 thunk from>
  template:20:39-40 thunk from>
  :1613:20-21 thunk from>
  :32:25-26 thunk from>
  :32:16-27 function
  :1613:8-22 function

• 근본 원인: Index 0 out of bounds, not within [0, 0) 오류는 빈 배열의 첫 번째 요소 (색인 0)에 액세스하려고 시도했음을 나타냅니다. 이 문제는 코드의 16번째 줄, 특히 스크립트의 다음 부분에서 발생합니다.
  • getMergedObject(orderId) 함수: ordersSalesforce에서 일치하는 주문을 찾을 수 없는 경우 이 함수는 빈 배열 []을 반환합니다.
  • local orders = std.map(...); 줄: 결과가 빈 배열 []이므로 getMergedObject(orderId)에서 반환된 결과의 첫 번째 요소에 액세스하려고 하면 index 0 out of bounds 오류가 발생합니다.
• 세부 분석:
  • getMergedObject(orderId) 함수: 이 함수는 ordersSalesforce 배열에서 일치하는 주문을 찾습니다. 일치하는 항목이 없으면 빈 배열 []를 반환합니다. 이는 ordersSalesforce 배열에서 orderId를 찾을 수 없는 경우 예상되는 동작입니다.
  • local orders = std.map (...); 줄: 이 줄은 std.map 함수를 사용하여 데이터를 처리합니다. 하지만 배열이 비어 있는지 확인하지 않고 getMergedObject(orderId)에서 반환된 배열의 첫 번째 요소에 직접 액세스하려고 합니다. 배열이 비어 있으면 index 0 out of bounds 오류가 발생합니다.
  오류 수정 단계:
  • Salesforce 연결의 인증 섹션으로 이동합니다.
  • 액세스 토큰과 보안 비밀 버전을 확인합니다.
  • 액세스 토큰과 보안 비밀 버전에 유효한 값을 제공합니다.
  • 통합을 테스트하고 다시 게시하여 변경사항을 적용합니다.