Application Integration에 지원되는 커넥터를 참조하세요.

실행 로그 보기

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

참고: Application Integration은 최대 32일 동안 통합 실행 로그를 보존합니다.

통합 실행 로그 보기

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

Console

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

   Application Integration 로그로 이동

2. 탐색 메뉴에서 로그를 클릭합니다. 또는 탐색 메뉴에서 통합을 클릭하고 로그를 보려는 통합을 선택합니다. 그런 다음 이 통합의 실행 로그 보기를 클릭합니다. 실행 로그 페이지가 나타납니다.
   참고: 실행 로그 크기가 300MB를 초과하면 Application Integration에서 Response size too large 오류가 발생하고 로그가 실행 로그 페이지에 로드되지 않습니다. 이 경우 API 탭에 설명된 대로 projects.locations.integrations.executions.list 메서드를 사용합니다.
3. 리전 목록에서 리전을 선택하여 리전별 통합 실행 로그를 봅니다. 로그 새로고침을 클릭하여 현재의 로그 목록을 다시 불러옵니다.

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

   

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

   • 통합 이름: 통합의 이름입니다.
   • 실행 ID: 통합을 실행할 때마다 생성되는 고유 식별자입니다.
   • 상태: 통합 실행 상태입니다.
     • 처리 중: 현재 통합이 실행 중임을 나타냅니다.
     • 성공: 통합이 성공적으로 실행되었음을 나타냅니다.
     • 실패: 통합을 실행할 수 없음을 나타냅니다.
     • 취소: 사용자가 통합 실행을 취소했음을 나타냅니다.
     • 보류 중: 통합 실행이 일시중지되었고 이벤트 또는 작업이 완료되기를 기다리고 있습니다.
     • 보류 중 재시도: 통합 실행이 실패하여 재시도 대기 중임을 나타냅니다.
     • 정지됨: 통합 실행이 일시중지되었고 통합을 재개하려면 수동 개입이 필요함을 나타냅니다.
   • 시작 시간: 통합 실행이 시작된 시점의 타임스탬프입니다.
   • 소요 시간: 통합 실행에 소요된 시간입니다.
     참고: 통합의 엔드 투 엔드 실행 지연 시간을 계산할 때는 소요 시간 값을 사용하지 마세요. 소요 시간 열에 표시된 시간은 실행 전후의 통합에 소요된 추가 시간을 고려하지 않으므로 통합의 총 실행 시간을 반영하지 않습니다. 예를 들어 할당량 적용 또는 인증에 걸린 시간은 소요 시간 값에 반영되지 않습니다.
   • 통합 버전: 실행된 통합 버전입니다.
   • 트리거 ID: 트리거의 ID 값입니다.
   • Cloud Logging: 통합이 Cloud Logging에 로깅하도록 구성되었는지 여부를 나타냅니다. Cloud Logging이 사용 설정되면 이 필드에는 Cloud Logging에서 로그를 볼 수 있는 링크가 제공됩니다. Cloud Logging이 사용 설정되지 않으면 이 필드는 사용 중지됨으로 설정됩니다.
   • 재수행 대상: 통합 실행이 재수행되면 이 필드에 재수행된 실행의 실행 ID가 제공됩니다. 이전 실행과 동일한 매개변수를 사용하여 통합을 다시 실행하려면 게시된 통합 실행을 재수행할 수 있습니다. 예를 들어 제한 시간 오류로 인해 통합이 실패했거나 통합의 출력이 예상과 다를 경우 실행을 재수행할 수 있습니다. 실행을 재수행하는 방법은 실행 재수행을 참고하세요.

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

   테스트 사례 실행에 필터를 추가하려면 다음 형식을 사용하세요.

   Integration name:INTEGRATION_NAME:TEST_CASE_NAME

   다음을 바꿉니다.

   • INTEGRATION_NAME: 기능 테스트가 포함된 통합 이름입니다.
   • TEST_CASE_NAME: 테스트 실행을 나열할 테스트 사례의 이름입니다.

   예를 들면 Integration name:example-integration-name:example-test-case입니다.

API

실행 로그 크기가 300MB를 초과하면 Application 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로 실행 로그를 필터링할 수 있습니다.

예시: 로그 필터링

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

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'

로그를 사용하여 문제 해결

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

통합 실패 문제 해결

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

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

1. 통합 목록에서 문제 해결을 위해 통합을 검색하거나 선택하고 통합 편집기를 클릭하여 엽니다.
2. 통합 편집기의 툴바에서 로그를 클릭하여 로그 메시지를 확인합니다.
3. 실행 로그 필터 필드에서 통합 이름을 선택하고 로그를 보려는 통합의 이름을 입력합니다.
4. 입력을 클릭합니다.
5. 실패한 통합을 표시하려면 실행 로그 필터 필드에서 실행 상태를 선택하여 상태 목록을 표시한 다음 실패함을 선택합니다.
6. 특정 기간 간의 실패한 통합을 표시하려면 실행 로그 필터 필드에서 시작일 이후를 선택하고 원하는 시간을 유효한 형식으로 입력합니다. 그런 다음 종료일 이전을 선택하고 원하는 시간을 입력합니다. 여러 필터는 기본적으로 AND 조건을 사용하여 결합됩니다.

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

스택 트레이스 예외 보기

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

참고: 실행 로그 메시지 이벤트 매개변수(문자열 또는 JSON)는 2,000자 이내여야 합니다.

Trace 커넥터 오류

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

참고: 실패한 커넥터 작업의 로그 데이터는 Integration Connectors의 각 연결에 Cloud Logging이 사용 설정된 경우에만 로그 탐색기에서 사용할 수 있습니다. 자세한 내용은 커넥터 로그 보기를 참조하세요.

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

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

   

Application 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"

제한사항

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

다음 단계

• Application Integration의 로그에 대한 자세한 내용은 로그 소개를 참조하세요.
• 테스트 사례에 대해 알아보기