합성 모니터 결과 살펴보기

이 문서에서는 합성 모니터의 실행 기록을 살펴보는 방법과 수집된 측정항목 및 로그를 보는 방법을 설명합니다.

이 기능은 Google Cloud 프로젝트에서만 지원됩니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.

시작하기 전에

합성 모니터를 저장하는 Google Cloud 프로젝트에서 다음을 완료합니다.

합성 모니터 실행 기록 보기

실행 통과 및 실패 기록을 이해하려면 합성 모니터의 합성 모니터 세부정보 페이지를 참조하세요.

  1. Google Cloud 콘솔에서 합성 모니터링 페이지로 이동합니다.

    합성 모니터링으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.
  3. 합성 모니터 세부정보 페이지를 열려면 보려는 합성 모니터를 찾은 후 해당 이름을 클릭합니다.

합성 모니터 세부정보 페이지에는 성공률 및 기간, 최근 상태와 같은 요약 정보가 나열됩니다. 또한 이 페이지에는 기록된 실행 기간이 차트로 표시되며 실행마다 행 하나를 표시하는 테이블이 포함되어 있습니다.

테이블의 각 행에는 상태, 날짜, 기간이 나열되어 있으며 해당 실행과 관련된 현재 코드 및 로그가 표시된 페이지로 연결됩니다.

실행 로그 및 trace 보기

실행의 로그, trace, 요약 정보를 보려면 합성 모니터 세부정보 페이지에서 실행 링크를 클릭합니다. 이 페이지에서 다음을 수행할 수 있습니다.

  • 로그 데이터 보기
  • trace 데이터 보기

  • 현재 코드를 봅니다.

  • Cloud Run 함수에 액세스합니다.

  • Mocha 테스트의 경우 각 테스트의 결과를 봅니다. 예를 들어 합성 모니터에 Mocha 테스트 4개가 포함되어 있으면 테스트 결과 창에 항목 4개가 포함됩니다. 목록의 각 항목은 통과 또는 실패로 주석 처리됩니다.

    실패로 표시된 항목을 선택하면 실패한 코드가 표시 및 강조표시됩니다.

로그 데이터 보기

로그는 Cloud Monitoring에서 자동으로 수집됩니다. 이러한 로그에는 테스트 및 실패 세부정보에 대한 정보가 포함됩니다. 사용 가능한 로그는 Cloud Run 함수에 따라 다릅니다. 예를 들어 Mocha를 사용하는 경우 로그에 테스트 통과 또는 실패 여부, 테스트 기간, 실패한 경우, 전체 스택 트레이스에 대한 정보가 포함됩니다. 스택 트레이스에는 실패한 코드 줄, 오류 유형, 오류 메시지가 포함됩니다.

관련 로그의 세부정보를 보려면 실행 로그 창에서 로그 항목을 펼칩니다.

로그 항목이 JSON 형식으로 표시됩니다. 로그 탐색기로 로그를 보려면 로그 탐색기에서 열기를 클릭합니다. 로그 탐색기가 열리고 쿼리가 사전 구성됩니다.

trace 데이터 보기

Trace 데이터는 Cloud Run 함수가 실행될 때 수집됩니다. trace 데이터를 보려면 Google Cloud 콘솔 또는 Cloud Trace API를 사용하여 trace 데이터를 확인합니다.

콘솔

trace 데이터를 보려면 다음 중 하나를 수행합니다.

  • trace의 요약 정보를 보려면 실행 세부정보 페이지의 툴바에서 trace 세부정보 보기를 클릭합니다.

    세부정보 패널이 열리고 trace에 작업 레코드인 각 스팬에 대한 정보가 포함된 Gantt 차트가 표시됩니다. trace 및 스팬에 대한 자세한 내용은 Cloud Trace에서 보기를 클릭하여 Trace 탐색기 페이지를 여세요.

  • Cloud Trace에서 trace를 확인합니다.

    1. Google Cloud 콘솔에서 Trace 탐색기 페이지로 이동합니다.

      Trace 탐색기로 이동

      검색창을 사용하여 이 페이지를 찾을 수도 있습니다.

    2. Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.
    3. 히트 맵 차트 또는 테이블에서 trace를 선택합니다.

Trace 및 스팬에는 실행 중에 발생한 로그 항목이나 이벤트를 나타내는 타임라인의 원이 포함될 수 있습니다. 원을 클릭하면 로그 항목 또는 이벤트에 관한 정보를 표시합니다. 로그 항목에서 Cloud Run 함수를 식별하려면 resource.labels.service_name 필드를 확인하세요.

trace 데이터 탐색에 대한 자세한 내용은 trace 찾기 및 탐색을 참조하세요.

API

Google Cloud 콘솔을 사용하여 trace 데이터를 보는 것이 좋습니다. 하지만 Cloud Trace API를 사용하려면 traces.list 메서드를 사용하여 사용 가능한 trace를 나열한 후 traces.get 메서드를 사용하여 trace의 세부정보를 가져옵니다.

Cloud Run 함수의 로그 및 측정항목 보기

로그 및 측정항목은 Cloud Run 함수가 수행하는 작업에 대한 정보를 제공합니다. 예를 들어 값이 GoogleStackdriverMonitoring-UptimeChecks인 userAgent 필드가 포함된 로그는 서비스가 업타임 체크 서비스에서 요청을 수신했음을 나타냅니다.

이 섹션의 나머지 부분에서는 Cloud Run 함수에서 수집한 로그와 측정항목을 보는 방법을 설명합니다.

함수 로그 보기

콘솔

Cloud Run 함수 로그를 보려면 다음을 수행합니다.

  1. 합성 모니터 이름이 있는 창에서 Cloud Run 함수 이름을 클릭합니다.
  2. 함수 세부정보 페이지에서 로그 탭을 선택합니다.

차트의 로그 데이터를 자세히 살펴보려면 로그 항목을 펼친 후 로그 탐색기에서 열기를 선택합니다. 로그 탐색기에서 쿼리를 상세검색하거나 로그 기반 측정항목을 만들거나 로그 기반 알림을 만들 수 있습니다.

API

프로그래매틱 방식으로 Cloud Run 함수 로그를 읽고 쓰는 방법에 대한 자세한 내용은 로그 쓰기, 보기, 응답을 참조하세요.

함수 측정항목 보기

합성 모니터의 경우 Cloud Monitoring 및 Cloud Run Functions 모두에서 측정항목을 수집합니다.

  • Cloud Monitoring은 합성 모니터의 각 실행에 대한 측정항목을 수집합니다. 이러한 측정항목에는 코드 실행 지연 시간과 성공 기록이 포함됩니다. 이러한 측정항목을 보는 방법에 대한 자세한 내용은 합성 모니터의 실행 기록 보기를 참조하세요.

  • Cloud Run Functions는 각 Cloud Run Functions에 대한 측정항목을 수집합니다. 이러한 측정항목은 실행 시간, 메모리 사용률, 인스턴스 수, 섹션당 호출 수를 기록합니다. 이 섹션의 나머지 부분에서는 이러한 측정항목을 보는 방법을 설명합니다.

콘솔

Cloud Run 함수 측정항목을 보려면 다음을 수행합니다.

  1. 합성 모니터 이름이 있는 창에서 Cloud Run 함수 이름을 클릭합니다.
  2. 함수 세부정보 페이지에서 측정항목 탭을 선택합니다.

특정 기간을 확대하려면 다음 안내를 따르세요.

  1. 차트에서 기간의 한쪽 끝에 마우스 포인터를 놓고 포인터를 마우스 왼쪽 버튼으로 클릭합니다.
  2. 포인터를 가로로 기간의 다른 쪽 끝으로 드래그한 후 포인터 버튼을 놓습니다.

차트에 표시된 데이터를 자세히 살펴보려면 차트 툴바에서 차트 옵션 더보기를 선택한 후 선택합니다. 다음과 같은 옵션이 있습니다.

  • 차트를 PNG 또는 CSV로 다운로드
  • 차트를 커스텀 대시보드에 저장
  • 측정항목 탐색기 열기
  • 차트 범례 펼치기 또는 접기
  • 확대/축소 재설정