Apigee Integration 로그

Apigee Integration은 각 통합 실행에 대한 실행 로그 메시지를 생성합니다. 로그 메시지에는 통합의 각 단계 상태를 확인하거나 실패한 통합, 태스크, 이벤트 문제를 해결하는 데 도움이 되는 정보가 포함됩니다. Apigee Integration의 로깅에 대한 자세한 내용은 로그 소개를 참조하세요.

통합 실행 로그 보기

실행 로그 페이지를 보려면 다음 옵션 중 하나를 선택합니다.

Console

  1. Application Integration에서 로그 페이지로 이동합니다.

    Application Integration 로그로 이동

  2. 탐색 메뉴에서 로그를 클릭합니다. 또는 탐색 메뉴에서 통합을 클릭하고 로그를 보려는 통합을 선택합니다. 그런 다음 실행 로그 아이콘을 보여주는 이미지이 통합의 실행 로그 보기를 클릭합니다. 실행 로그 페이지가 나타납니다.
  3. 리전 목록에서 리전을 선택하여 리전별 통합 실행 로그를 봅니다. 새로고침 로그 새로고침을 클릭하여 현재 로그 목록을 다시 로드할 수도 있습니다.

    다음 이미지는 샘플 Apigee Integration 실행 로그 페이지를 보여줍니다.

    Apigee Integration 실행 로그 페이지를 보여주는 이미지 Apigee Integration 실행 로그 페이지를 보여주는 이미지

    각 실행 로그 메시지에 다음 속성이 표시됩니다.

    • 통합 이름: 통합의 이름입니다.
    • 실행 ID: 통합을 실행할 때마다 생성되는 고유 식별자입니다.
    • 상태: 통합 실행 상태입니다.
      • 처리 중: 현재 통합이 실행 중임을 나타냅니다.
      • 성공: 통합이 성공적으로 실행되었음을 나타냅니다.
      • 실패: 통합을 실행할 수 없음을 나타냅니다.
      • 취소: 사용자가 통합 실행을 취소했음을 나타냅니다.
      • 보류 중: 통합 실행이 일시중지되었고 이벤트 또는 작업이 완료되기를 기다리고 있습니다.
      • 보류 중 재시도: 통합 실행이 실패하여 재시도 대기 중임을 나타냅니다.
      • 정지됨: 통합 실행이 일시중지되었고 통합을 재개하려면 수동 개입이 필요함을 나타냅니다.
    • 시작 시간: 통합 실행이 시작된 시점의 타임스탬프입니다.
    • 소요 시간: 통합 실행에 소요된 시간입니다.
    • 통합 버전: 실행된 통합 버전입니다.
    • 트리거 ID: 트리거의 ID 값입니다.
    • Cloud Logging: 통합이 Cloud Logging에 로깅하도록 구성되었는지 여부를 나타냅니다. Cloud Logging이 사용 설정되면 이 필드에는 Cloud Logging에서 로그를 볼 수 있는 링크가 제공됩니다. Cloud Logging이 사용 설정되지 않으면 이 필드는 사용 중지됨으로 설정됩니다.

  4. 필터 필드에서 필터를 추가합니다. 통합 이름, 실행 ID, 날짜 또는 시간 범위, 실행 상태, 변수 유형, 변수 이름 또는 값과 같은 기준에 로그를 필터링할 수 있습니다. 더욱 맞춤화된 검색을 위해서는 API 탭에 설명된 대로 projects.locations.integrations.executions.list 메서드를 사용합니다.

API

실행 로그 크기가 300MB를 초과하면 Apigee Integration에서 Response too large error 오류가 발생하고 로그가 실행 로그 페이지에 로드되지 않습니다. 이 경우 projects.locations.integrations.executions.list 메서드를 사용하여 로그를 가져와야 합니다. API 메서드를 사용하여 로그를 보려면 다음 단계를 따르세요.

  1. 실행 로그를 보려는 실행 ID를 가져오려면 snapshotMetadataWithoutParams 매개변수를 TRUE로 설정하고 projects.locations.integrations.executions.list 메서드를 사용하여 GET 요청을 생성합니다. 
    curl -v -X -G GET
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'snapshotMetadataWithoutParams=true'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'

    응답에 실행 ID가 반환됩니다. 로그를 보려는 실행 ID를 복사합니다.

  2. 실행 ID의 실행 로그를 가져오려면 이전 단계에서 복사한 실행 ID에 대한 필터와 함께 projects.locations.integrations.executions.list 메서드를 사용하여 POST 요청을 생성합니다. 
    curl -v -X -G GET 
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'filter=execution_id="EXECUTION_ID"'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'

    응답에서 ExecutionDetails 필드를 확인하여 로그 세부정보를 확인합니다.

    또는 Google Cloud 콘솔에서 실행 ID로 실행 로그를 필터링할 수 있습니다.

    3. 예시: 로그 필터링

    하나의 통합에 예상되는 모든 통합의 로그를 나열하도록 응답을 필터링하려면 다음 형식을 사용합니다.

    curl -v -X -G GET 
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'filter= workflowName!="INTEGRATION_NAME"'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions'

로그를 사용하여 문제 해결

다음 섹션에서는 Apigee Integration 실행 로그를 사용하여 오류를 문제 해결하는 방법을 설명합니다.

통합 실패 문제 해결

실행 로그 메시지는 통합 실행 실패 시 문제를 해결할 수 있는 중요한 리소스입니다.

예를 들어 특정 시간대에 통합을 실행할 수 없는 경우 다음 단계에 따라 로그에 액세스하고 필터링하여 오류를 해결합니다.

  1. 통합 목록에서 문제 해결을 위해 통합을 검색하거나 선택하고 통합 편집기를 클릭하여 엽니다.
  2. 통합 편집기의 툴바에서 로그를 클릭하여 로그 메시지를 확인합니다.
  3. 필터 추가를 클릭하여 사용 가능한 필터 목록을 표시합니다.
  4. 통합 이름을 선택합니다.
  5. 통합 이름을 입력한 다음 적용을 클릭합니다.
  6. 필터 추가를 클릭하여 사용 가능한 필터 목록을 표시합니다.
  7. 실행 상태를 선택하여 상태 목록을 표시합니다.
  8. 실패 체크박스를 선택한 다음 적용을 클릭하여 실패한 통합을 표시합니다.
  9. 필터 추가를 클릭하여 사용 가능한 필터 목록을 표시합니다.
  10. 날짜/시간 범위를 선택하고 원하는 시간 범위를 입력하여 실패를 확인합니다. 예를 들어 다음을 입력합니다.
    • 시작일: 2020-12-16을 선택합니다.
    • 시작 시간: 04:00:00 PM를 선택합니다.
    • 종료일: 2019-12-16을 선택합니다.
    • 종료 시간: 05:00:00 PM을 선택합니다.
      • 기본적으로 필터 여러 개가 AND 조건을 통해 결합됩니다.
    • 적용을 클릭합니다.

필터링된 시간 동안 통합이 실패하면 실행 로그 페이지에 로그 메시지 목록이 표시됩니다. 각 로그 메시지는 통합의 실패한 특정 실행에 해당합니다.

스택 트레이스 예외 보기

예외 목록을 보려면 로그 메시지를 클릭합니다. 각 예외 메시지의 링크를 클릭하여 예외의 전체 스택 트레이스를 확인하세요.

확장된 로그 예외 오류를 보여주는 이미지 확장된 로그 예외 오류를 보여주는 이미지

Trace 커넥터 오류

실행 로그 메시지를 사용하여 실패한 커넥터 태스크 실행 문제를 해결하고 추적할 수 있습니다. 실패한 커넥터 태스크의 로그 데이터는 Cloud Logging을 사용하여 저장되며 로그 탐색기에서 볼 수 있습니다.

Apigee Integration에서 실패한 커넥터 태스크의 로그 데이터에 액세스하려면 다음 단계를 수행합니다.

  1. 원하는 통합의 실행 로그 페이지로 이동합니다.
  2. 실패한 실행의 로그 메시지 및 스택 트레이스를 실패한 커넥터 태스크가 포함된 행까지 펼칩니다.
  3. 상태 열에서 실패를 클릭합니다.

    실패한 커넥터 태스크 로그를 보여주는 이미지 실패한 커넥터 태스크 로그를 보여주는 이미지

    4. Apigee Integration은 실패한 커넥터 태스크에 필요한 쿼리를 자동으로 실행하고 로그 탐색기 페이지를 열어 자세한 실행 로그 데이터를 표시합니다.

실패한 커넥터 태스크의 로그 데이터를 수동으로 검색하려면 로그 탐색기의 쿼리 페이지에서 다음 쿼리를 실행하세요. 로그 탐색기 사용 방법에 대한 자세한 내용은 로그 탐색기 인터페이스를 참조하세요.

쿼리 형식

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

예

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

제한사항

  • 통합에 로컬 로깅이 사용 중지되어 있으면 해당 통합에 대해 실행 로그가 생성되지 않습니다.

다음 단계

  • Apigee Integration의 로그에 대한 자세한 내용은 로그 소개를 참조하세요.