이 문서에서는 합성 모니터를 관리하는 방법을 설명합니다. 합성 모니터 목록을 보고 합성 모니터마다 구성을 보고 수정하고 실행 기록을 보며 각 실행의 세부정보를 볼 수 있습니다. Google Cloud 콘솔이나 Cloud Monitoring API를 사용하여 합성 모니터를 관리할 수 있습니다.
실행 결과를 확인하고 합성 모니터의 측정항목 및 로그를 살펴보는 방법에 대한 자세한 내용은 합성 모니터 결과 살펴보기를 참조하세요.
시작하기 전에
-
Google Cloud 콘솔을 사용하여 합성 모니터를 보고 수정하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
모니터링 편집자(
roles/monitoring.editor
) -
Cloud Functions 개발자(
roles/cloudfunctions.developer
)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
-
모니터링 편집자(
이 페이지의 API 안내는 API 탐색기에 대한 안내입니다. 하지만 curl 명령어를 실행할 수도 있습니다. API 탐색기는 curl 구문을 제공합니다.
합성 모니터 나열
Google Cloud 프로젝트에 합성 모니터를 나열하려면 다음 안내를 따르세요.
-
Google Cloud 콘솔에서 합성 모니터링 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
선택사항: 나열된 합성 모니터를 제한하려면 필터를 추가합니다.
각 필터는 이름과 값으로 구성됩니다. 이 값을 합성 모니터 이름과 정확히 일치하거나 부분적으로 일치하도록 설정할 수 있습니다. 일치는 대소문자를 구분하지 않습니다. 예를 들어 이름에
default
가 포함된 모든 합성 모니터를 나열하려면 다음 안내를 따르세요.- 테이블 필터링을 클릭하고 표시 이름을 선택합니다.
default
를 입력한 다음 Enter 키를 누릅니다.
필터가 여러 개인 경우
OR
필터를 삽입하지 않는 한 필터가 논리AND
에 의해 자동으로 조인됩니다. 이전 예시에서는OR
필터를 사용하여 이름이default
또는Testing check
과 일치하는 경우 업타임 체크가 나열되도록 합니다.
합성 모니터 페이지에 각 합성 모니터에 대해 다음이 표시됩니다.
- 최근 실행 상태
- 자세한 합성 모니터 정보에 대한 링크
- 성공률 및 평균 실행 시간
- 알림 정책 수
- 합성 모니터를 수정, 복사 또는 삭제하고 알림 정책을 만들려면 more_vert 추가 옵션 메뉴를 사용합니다.
업타임 체크 및 합성 모니터를 나열하려면 gcloud monitoring uptime list-configs
명령어를 실행합니다.
gcloud monitoring uptime list-configs
반환된 데이터에는 다음이 포함됩니다.
- 이름 및 표시 이름
- 체크 식별자
- 모니터링 리소스
- 체크 사이의 기간
Google Cloud CLI 명령어를 구성하여 결과를 필터링하고 정렬할 수 있습니다.
업타임 체크를 포함하여 Google Cloud 프로젝트의 합성 모니터를 나열하려면 projects.uptimeCheckConfigs.list
메서드를 호출합니다.
projects.uptimeCheckConfigs.list
을 클릭합니다.API 탐색기를 사용합니다.
메서드의 상위 요소를 프로젝트 이름으로 설정하고 다음 형식을 사용합니다.
projects/
PROJECT_ID 앞의 표현식에서
PROJECT_ID
는 Google Cloud 프로젝트 ID입니다.
합성 모니터의 경우 결과에 syntheticMonitor
라벨이 지정된 필드가 포함됩니다.
합성 모니터 세부정보 보기
Google Cloud 프로젝트에서 합성 모니터의 세부정보를 보려면 다음 안내를 따르세요.
-
Google Cloud 콘솔에서 합성 모니터링 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
합성 모니터 세부정보 페이지를 열려면 보려는 합성 모니터를 찾은 후 해당 이름을 클릭합니다.
Cloud Run 함수에서 제공하는 함수 세부정보 페이지에서 Cloud Run 함수를 보려면 코드 탭을 선택한 후 함수 이름을 클릭합니다. 새 창에 함수 세부정보 페이지가 열립니다. 이 페이지의 탭에서 측정항목과 로그, 구성 정보를 볼 수 있습니다.
업타임 체크 또는 합성 모니터의 세부정보를 나열하려면 gcloud monitoring uptime describe
명령어를 실행합니다.
gcloud monitoring uptime describe CHECK_ID
이전 명령어를 실행하기 전에 CHECK_ID를 업타임 체크 또는 합성 모니터의 식별자로 바꿉니다. gcloud monitoring uptime list-configs
명령어를 실행하고 이름 필드를 확인하면 식별자를 찾을 수 있습니다. 자세한 내용은 합성 모니터의 고유 식별자 찾기를 참고하세요.
업타임 체크에서 반환되는 데이터에는 다음이 포함됩니다.
- 이름 및 표시 이름
- 체크 식별자
- 모니터링 리소스
- 체크 사이의 기간
Google Cloud 프로젝트에서 특정 합성 모니터의 세부정보를 나열하려면 projects.uptimeCheckConfigs.get
메서드를 호출합니다.
projects.uptimeCheckConfigs.get
을 클릭합니다.API 탐색기를 사용합니다.
메서드의 상위 요소를 합성 모니터의 식별자로 설정하고 다음 형식을 사용합니다.
projects/
PROJECT_ID /uptimeCheckConfigs/CHECK_ID 앞의 표현식에서
PROJECT_ID
는 Google Cloud 프로젝트 ID이고CHECK_ID
는 합성 모니터 ID입니다.예를 들어 상위 필드 값은 다음과 같습니다.
projects/my-project/uptimeCheckConfigs/10863117100295372627
CHECK_ID 값을 찾으려면
projects.uptimeCheckConfigs.list
메서드를 실행하면 됩니다. 반환되는 결과의 수를 줄이려면 필터를 포함합니다. 예를 들어displayName="MySyntheticMonitor"
필터를 추가합니다.
합성 모니터 또는 Cloud Run 함수 수정
합성 모니터 세부정보 페이지를 사용하여 합성 모니터나 Cloud Run 함수를 수정하려면 다음 안내를 따르세요.
-
Google Cloud 콘솔에서 합성 모니터링 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- 수정하려는 합성 모니터를 찾고 more_vert 추가 옵션을 클릭한 후 수정을 선택합니다.
선택사항: Cloud Run 함수를 수정하려면 함수 수정을 클릭하고 변경을 수행한 후 함수 적용을 클릭합니다.
깨진 링크 검사기의 경우 원본 URI 또는 테스트할 링크를 정의하는 옵션을 수정하려면 Cloud Run 함수를 수정한 후
index.js
파일에서options
객체를 업데이트합니다. 이 객체의 필드와 구문은broken-links-ok/index.js
를 참조하세요.수정사항을 유지하려면 저장을 클릭합니다. 그렇지 않으면 취소를 클릭합니다.
업타임 체크 또는 합성 모니터를 수정하려면 gcloud monitoring uptime update
명령어를 실행합니다.
gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS
위 명령어를 실행하기 전에 다음을 수행합니다.
CHECK_ID를 업타임 체크 또는 합성 모니터의 식별자로 바꿉니다.
gcloud monitoring uptime list-configs
명령어를 실행하고 이름 필드를 확인하면 식별자를 찾을 수 있습니다. 자세한 내용은 업타임 체크의 고유 식별자 찾기를 참고하세요.수정할 필드를 정의합니다. 합성 모니터의 경우 다음 필드만 업데이트할 수 있습니다.
- 기간
- 표시 이름
- 제한 시간
- 사용자 라벨
예를 들어 합성 모니터의 기간을 10분으로 설정하려면 다음 명령어를 실행합니다.
gcloud monitoring uptime update CHECK_ID --period=10
알림 정책과 함수는 합성 모니터에 포함되지 않으므로 이 섹션에서 설명하는 절차에 따라 알림 정책과 함수를 수정할 수 없습니다.
알림 정책을 수정하려면 Google Cloud 콘솔을 사용하거나
alertPolicies.patch
메서드를 호출합니다. 자세한 내용은 API로 알림 정책 관리를 참조하세요.Cloud Run 함수를 수정하려면 함수 소스를 업데이트한 후 함수를 다시 배포해야 합니다. 자세한 내용은 Cloud Run 함수 배포를 참조하세요.
합성 모니터를 수정하려면 projects.uptimeCheckConfigs.patch
메서드를 호출합니다.
projects.uptimeCheckConfigs.patch
을 클릭합니다.API 탐색기를 사용합니다.
메서드의 상위 요소를 합성 모니터의 식별자로 설정하고 다음 형식을 사용합니다.
projects/
PROJECT_ID /uptimeCheckConfigs/CHECK_ID 앞의 표현식에서
PROJECT_ID
는 Google Cloud 프로젝트 ID이고CHECK_ID
는 합성 모니터 ID입니다.CHECK_ID 값을 찾으려면
projects.uptimeCheckConfigs.list
메서드를 실행하면 됩니다. 반환되는 결과의 수를 줄이려면 필터를 포함합니다. 예를 들어displayName="MySyntheticMonitor"
필터를 추가합니다.메서드의 쿼리 매개변수 updateMask를 설정하여 수정 중인 객체의 필드를 식별합니다. 예를 들어
displayName
값을 업데이트할 경우 쿼리 매개변수는 다음과 같습니다.updateMask=displayName
합성 모니터 복사
Google Cloud 프로젝트에서 합성 모니터를 복사하려면 다음 안내를 따르세요.
-
Google Cloud 콘솔에서 합성 모니터링 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
수정하려는 합성 모니터를 찾고 more_vert 추가 옵션을 클릭한 후 복사를 선택합니다.
Cloud Run 함수 복사본을 포함하여 미리 채워진 필드가 있는 합성 검사 복사 대화상자가 열립니다.
함수 만들기를 클릭하고 필요에 따라 함수를 업데이트한 후 함수 적용을 클릭합니다.
수정사항을 유지하려면 만들기를 클릭합니다. 그렇지 않으면 취소를 클릭합니다.
만들기를 클릭하면 Cloud Run 함수가 생성되고 배포된 후 합성 모니터가 생성됩니다.
합성 모니터를 복사할 수 있는 Google Cloud CLI 메서드는 없습니다.
합성 모니터를 복사할 수 있는 API 메서드는 없습니다. 그러나 다음 단계를 수행하여 복사본을 만들 수 있습니다.
projects.uptimeCheckConfigs.get
메서드를 호출하고 응답을 저장합니다. 자세한 내용은 합성 모니터의 세부정보 보기를 참조하세요.- 응답을 수정합니다.
projects.uptimeCheckConfigs.create
메서드를 호출하고 수정된 응답을 메서드에 전달합니다.
합성 모니터 삭제
합성 모니터와 관련 알림 정책을 삭제하려면 다음 안내를 따르세요.
-
Google Cloud 콘솔에서 합성 모니터링 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
삭제하려는 합성 모니터를 찾은 다음 이름을 클릭합니다.
선택사항: Cloud Run 함수를 삭제하려면 코드 탭을 선택한 후 함수 이름을 클릭합니다. 새 창에 함수 세부정보 페이지가 열립니다.
합성 모니터 세부정보 페이지에서
삭제를 클릭한 후 대화상자를 완료합니다.이제 합성 모니터가 삭제됩니다.
Cloud Run 함수를 삭제하려면 함수 세부정보 페이지로 이동하여
삭제를 클릭한 후 대화상자를 완료합니다.
업타임 체크 또는 합성 모니터를 삭제하려면 gcloud monitoring uptime delete
명령어를 실행합니다.
gcloud monitoring uptime delete CHECK_ID
이전 명령어를 실행하기 전에 CHECK_ID를 업타임 체크 또는 합성 모니터의 식별자로 바꿉니다. gcloud monitoring uptime list-configs
명령어를 실행하고 이름 필드를 확인하면 식별자를 찾을 수 있습니다. 자세한 내용은 합성 모니터의 고유 식별자 찾기를 참고하세요.
합성 모니터와 관련 알림 정책을 삭제하려면 projects.uptimeCheckConfigs.delete
메서드를 호출합니다.
projects.uptimeCheckConfigs.delete
을 클릭합니다.API 탐색기를 사용합니다.
메서드의 상위 요소를 합성 모니터의 식별자로 설정하고 다음 형식을 사용합니다.
projects/
PROJECT_ID /uptimeCheckConfigs/CHECK_ID 앞의 표현식에서
PROJECT_ID
는 Google Cloud 프로젝트 ID이고CHECK_ID
는 합성 모니터 ID입니다.CHECK_ID 값을 찾으려면
projects.uptimeCheckConfigs.list
메서드를 실행하면 됩니다. 반환되는 결과의 수를 줄이려면 필터를 포함합니다. 예를 들어displayName="MySyntheticMonitor"
필터를 추가합니다.
합성 모니터의 고유 식별자 찾기
합성 모니터가 생성되면 Monitoring에서 식별자를 할당합니다. 이 식별자는 합성 모니터의 리소스 이름에 삽입되며 형식은 다음과 같습니다.
projects/PROJECT_ID /uptimeCheckConfigs/CHECK_ID
CHECK_ID는 합성 모니터를 만들거나 나열하는 Google Cloud CLI 및 Cloud Monitoring API 메서드의 응답에 포함됩니다.