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

Cloud Logging에서 로그 보기

이 페이지에서는 통합에 Cloud Logging을 사용 설정하고 Cloud Logging에서 로그를 확인하는 방법과 Cloud Logging에서 통합 로그를 보는 몇 가지 샘플 쿼리를 설명합니다.

개요

Cloud Logging에서 상태, 성능, 통합 버전, 요청 및 응답 매개변수, 트리거 및 태스크 구성과 같은 통합 세부정보가 포함된 통합 실행 로그를 볼 수 있습니다. Cloud Logging의 실행 로그에 대한 자세한 내용은 Cloud Logging의 통합 실행 로그를 참조하세요. 제한사항과 가격 책정에 대한 자세한 내용은 제한사항 및 가격 책정을 참조하세요.

기본적으로 Cloud Logging은 통합에 대해 사용 중지되어 있습니다. 통합의 게시되지 않은 버전을 수정하여 통합에 로깅을 사용 설정할 수 있습니다.

Cloud Logging 사용 설정

Cloud Logging에 통합 실행 로그를 저장하려면 먼저 통합에 Cloud Logging을 사용 설정해야 합니다. 단계는 다음과 같습니다.

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

    Application Integration으로 이동

  2. 탐색 메뉴에서 통합을 클릭합니다.

    Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 페이지가 나타납니다.

  3. Cloud Logging을 사용 설정할 기존 통합을 선택하거나 새 통합을 만듭니다.

    통합 편집기 페이지에서 통합이 열립니다.

  4. 통합의 DRAFT 버전을 선택합니다. 초안 모드에 있지 않은 게시된 버전 또는 게시되지 않은 버전의 설정은 수정할 수 없습니다. 통합 버전 목록은 버전을 참조하세요.
  5. 디자이너 툴바에서 (통합 요약)를 클릭합니다. 통합 요약 페이지가 나타납니다.
    1. 로그 설정에서 Cloud Logging 사용 설정 전환 버튼을 클릭한 후 심각도 목록에서 Cloud Logging에 저장할 로그의 심각도 유형을 선택합니다.
      • 정보: 모든 실행 상태(SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED, RETRY_ON_HOLD, CANCELLED)를 캡처하려면 이 옵션을 선택합니다.
      • 오류: 다음 FAILED 및 CANCELLED 실행 상태를 캡처하려면 이 옵션을 선택합니다.
      • 경고: FAILED 및 CANCELLED 실행 상태를 캡처하려면 이 옵션을 선택합니다.

        • 통합 실행 상태 목록은 실행 상태를 참조하세요.

    2. 저장을 클릭합니다.

로그 보기

Cloud Logging에서 로그를 보려면 먼저 Cloud Logging을 사용 설정한 후 다음 단계를 따라야 합니다.

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

    Application Integration으로 이동

  2. Cloud Logging에서 통합 실행 로그를 보려면 다음 방법 중 하나를 사용합니다.
    • 탐색 메뉴에서 로그를 클릭한 다음 Cloud 로그 보기를 클릭합니다.
    • 통합 편집기에서 통합 테스트 후 통합 테스트 창에서 Cloud 로그 보기를 클릭합니다.

    로그 탐색기 페이지가 나타납니다. 다음 기본 쿼리에 대해 지난 3시간 동안의 로그가 표시됩니다. 

    resource.type=integrations.googleapis.com/IntegrationVersion

    3. Application Integration 로그의 로그 형식을 이해하려면 log_entries 페이로드를 참조하세요.

샘플 쿼리

다음 쿼리를 사용하여 Cloud Logging에서 로그를 볼 수 있습니다.

  • 모든 통합 실행 로그를 보려면 다음 쿼리를 사용합니다.

        resource.type="integrations.googleapis.com/IntegrationVersion"

  • 특정 실행 ID의 통합 실행 로그를 볼 수 있습니다.

    • 지정된 실행 ID가 있는 상위 실행만 검색합니다. 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • 지정된 실행 ID에서 실행된 상위 및 하위 실행을 모두 검색합니다. 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • 특정 통합의 통합 실행 로그를 보려면 다음 쿼리를 사용합니다.

        resource.type="integrations.googleapis.com/IntegrationVersion" 
    "INTEGRATION_NAME"
    또는 
        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integration="INTEGRATION_NAME"

  • 특정 통합의 실패한 통합 실행을 보려면 다음 쿼리를 사용합니다.

        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
    jsonPayload.integration="INTEGRATION_NAME"

  • 특정 요청 매개변수 이름이 있는 로그를 보려면 다음 쿼리를 사용합니다. 예를 들어 다음 쿼리는 requestUrl 매개변수의 로그를 요청합니다.

        resource.type="integrations.googleapis.com/IntegrationVersion"
    "requestUrl"

    • 더 많은 샘플 쿼리는 Cloud Logging 샘플 쿼리를 참조하세요.

제한사항

Cloud Logging의 통합 로그에는 다음과 같은 제한사항이 적용됩니다.

  • Cloud Logging은 크기가 최대 256KiB인 로그 항목만 지원합니다. 로그가 이 한도를 초과하면 요청 및 응답 매개변수가 로깅 세부정보에 표시되지 않습니다. Cloud Logging 할당량 및 한도에 대한 자세한 내용은 할당량 및 한도를 참조하세요. 이 오류를 해결하려면 값이 한도를 초과하지 않도록 통합 변수를 업데이트합니다. 또는 Application Integration에서 이러한 로그를 확인할 수도 있습니다.
  • 로컬 로깅이 사용 중지된 경우 Cloud Logging이 사용 설정되어 있어도 실행 로그가 Cloud Logging으로 전송되지 않습니다.

가격 책정

Cloud Logging 가격 책정에 대한 자세한 내용은 Cloud Logging 가격 책정을 참조하세요.

다음 단계