이 문서에서는 합성 모니터의 실행 기록을 살펴보는 방법과 수집된 측정항목 및 로그를 보는 방법을 설명합니다.
시작하기 전에
Google Cloud 콘솔을 사용하여 합성 모니터 실행 결과를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
모니터링 뷰어(
roles/monitoring.viewer) -
Cloud Functions 개발자(
roles/cloudfunctions.developer) -
로그 뷰어(
roles/logging.viewer)
역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
합성 모니터 실행 기록 보기
실행 통과 및 실패 기록을 이해하려면 합성 모니터의 합성 모니터 세부정보 페이지를 참조하세요.
-
Google Cloud 콘솔에서
합성 모니터링 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- 합성 모니터 세부정보 페이지를 열려면 보려는 합성 모니터를 찾은 후 해당 이름을 클릭합니다.
합성 모니터 세부정보 페이지에는 성공률 및 기간, 최근 상태와 같은 요약 정보가 나열됩니다. 또한 이 페이지에는 기록된 실행 기간이 차트로 표시되며 실행마다 행 하나를 표시하는 테이블이 포함되어 있습니다.
테이블의 각 행에는 상태, 날짜, 기간이 나열되어 있으며 해당 실행과 관련된 현재 코드 및 로그가 표시된 페이지로 연결됩니다.
실행 로그 및 trace 보기
실행의 로그, trace, 요약 정보를 보려면 합성 모니터 세부정보 페이지에서 실행 링크를 클릭합니다. 이 페이지에서 다음을 수행할 수 있습니다.
- 로그 데이터 보기
- trace 데이터 보기
현재 코드를 봅니다.
Cloud Run 함수에 액세스합니다.
Mocha 테스트의 경우 각 테스트의 결과를 봅니다. 예를 들어 합성 모니터에 Mocha 테스트 4개가 포함되어 있으면 테스트 결과 창에 항목 4개가 포함됩니다. 목록의 각 항목은 통과 또는 실패로 주석 처리됩니다.
실패로 표시된 항목을 선택하면 실패한 코드가 표시 및 강조표시됩니다.
로그 데이터 보기
로그는 Cloud Monitoring에서 자동으로 수집됩니다. 이러한 로그에는 테스트 및 실패 세부정보에 대한 정보가 포함됩니다. 사용 가능한 로그는 Cloud Run 함수에 따라 다릅니다. 예를 들어 Mocha를 사용하는 경우 로그에 테스트 통과 또는 실패 여부, 테스트 기간, 실패한 경우, 전체 스택 트레이스에 대한 정보가 포함됩니다. 스택 트레이스에는 실패한 코드 줄, 오류 유형, 오류 메시지가 포함됩니다.
관련 로그의 세부정보를 보려면 실행 로그 창에서 로그 항목을 펼칩니다.
로그 항목이 JSON 형식으로 표시됩니다. 로그 탐색기로 로그를 보려면 로그 탐색기에서 열기를 클릭합니다. 로그 탐색기가 열리고 쿼리가 사전 구성됩니다.
trace 데이터 보기
Trace 데이터는 Cloud Run 함수가 실행될 때 자동으로 수집됩니다. 다음 스크린샷은 일반 템플릿을 사용할 때 trace가 캡처하는 데이터 종류를 보여줍니다.
이전 스크린샷에서 gantt 차트의 첫 번째 행에는 Cloud Monitoring에서 시작된 HTTP 요청이 표시됩니다. trace 데이터에는 winston 로거에 전달된 텍스트가 표시되고, axios get 호출에서 실행된 아웃바운드 HTTP 요청이 표시됩니다.
trace 플라이아웃에서 trace에서 보기를 클릭하면 Cloud Trace 탐색기를 사용하여 trace 데이터를 볼 수 있습니다. trace가 이미 펼쳐져 세부정보를 표시합니다. trace 또는 스팬에 원이 표시되면 원을 클릭하여 로그 항목을 표시할 수 있습니다. Cloud Run 함수는 resource.labels.service_name 필드를 보고 식별할 수 있습니다.
콘솔
trace 데이터를 보려면 다음 중 하나를 수행합니다.
trace의 요약 정보를 보려면 실행 세부정보 페이지의 툴바에서 trace 세부정보 보기를 클릭합니다.
지연 시간 데이터 요약을 표시하는 플라이아웃이 열립니다. trace 및 스팬에 대한 자세한 내용은 Cloud Trace의 데이터를 참조하세요. Cloud Trace를 열려면 trace에서 보기를 클릭합니다.
Cloud Trace에서 trace를 확인합니다.
-
Google Cloud 콘솔에서 Trace 탐색기 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾을 수도 있습니다.
- 분산형 차트 또는 테이블에서 trace를 선택합니다.
- 스팬과 연결된 각 로그 또는 이벤트에 대해 스팬이 원으로 주석 처리됩니다. 이벤트 또는 로그에 대한 세부정보를 보려면 원을 선택합니다.
-
trace 데이터 탐색에 대한 자세한 내용은 trace 찾기 및 탐색을 참조하세요.
API
trace 데이터를 보려면 Google Cloud 콘솔을 사용하는 것이 좋습니다.
하지만 Cloud Trace API를 사용하려면 traces.list 메서드를 사용하여 사용 가능한 trace를 나열한 후 traces.get 메서드를 사용하여 trace의 세부정보를 가져옵니다.
Cloud Run 함수의 로그 및 측정항목 보기
로그 및 측정항목은 Cloud Run 함수가 수행하는 작업에 대한 정보를 제공합니다. 예를 들어 값이 GoogleStackdriverMonitoring-UptimeChecks인 userAgent 필드가 포함된 로그는 서비스가 업타임 체크 서비스에서 요청을 수신했음을 나타냅니다.
이 섹션의 나머지 부분에서는 Cloud Run 함수에서 수집한 로그와 측정항목을 보는 방법을 설명합니다.
함수 로그 보기
콘솔
Cloud Run 함수 로그를 보려면 다음을 수행합니다.
- 합성 모니터 이름이 있는 창에서 Cloud Run 함수 이름을 클릭합니다.
- 함수 세부정보 페이지에서 로그 탭을 선택합니다.
차트의 로그 데이터를 자세히 살펴보려면 로그 항목을 펼친 후 로그 탐색기에서 열기를 선택합니다. 로그 탐색기에서 쿼리를 상세검색하거나 로그 기반 측정항목을 만들거나 로그 기반 알림을 만들 수 있습니다.
API
프로그래매틱 방식으로 Cloud Run 함수 로그를 읽고 쓰는 방법에 대한 자세한 내용은 로그 쓰기, 보기, 응답을 참조하세요.
함수 측정항목 보기
합성 모니터의 경우 Cloud Monitoring 및 Cloud Run 함수 모두에서 측정항목을 수집합니다.
Cloud Monitoring은 합성 모니터의 각 실행에 대한 측정항목을 수집합니다. 이러한 측정항목에는 코드 실행 지연 시간과 성공 기록이 포함됩니다. 이러한 측정항목을 보는 방법에 대한 자세한 내용은 합성 모니터의 실행 기록 보기를 참조하세요.
Cloud Run 함수는 각 Cloud Run 함수에 대한 측정항목을 수집합니다. 이러한 측정항목은 실행 시간, 메모리 사용률, 인스턴스 수, 섹션당 호출 수를 기록합니다. 이 섹션의 나머지 부분에서는 이러한 측정항목을 보는 방법을 설명합니다.
콘솔
Cloud Run 함수 측정항목을 보려면 다음을 수행합니다.
- 합성 모니터 이름이 있는 창에서 Cloud Run 함수 이름을 클릭합니다.
- 함수 세부정보 페이지에서 측정항목 탭을 선택합니다.
특정 시간 범위를 확대하려면 다음 안내를 따르세요.
- 차트에서 시간 범위의 한쪽 끝에 마우스 포인터를 놓고 포인터를 마우스 왼쪽 버튼으로 클릭합니다.
- 포인터를 가로로 시간 범위의 다른 쪽 끝으로 드래그한 후 포인터 버튼을 놓습니다.
차트에 표시된 데이터를 자세히 살펴보려면 차트 툴바에서 more_vert 차트 옵션 더보기를 선택한 후 선택합니다. 다음과 같은 옵션이 있습니다.
- 차트를 PNG 또는 CSV로 다운로드
- 차트를 커스텀 대시보드에 저장
- 측정항목 탐색기 열기
- 차트 범례 펼치기 또는 접기
- 확대/축소 재설정
API
프로그래매틱 방식으로 Cloud Run 함수 측정항목을 읽는 방법에 대한 자세한 내용은 모니터링 측정항목 보기를 참조하세요.