SLO 데이터는 시계열에 저장됩니다. filter 매개변수의 시계열 선택기를 timeSeries.list 메서드에 지정하거나 측정항목 탐색기의 직접 필터 모드를 사용하여 SLO 시계열을 검색할 수 있습니다.
SLO 기반 알림 정책
Cloud Monitoring API를 사용하여 알림 정책을 만드는 경우, 시계열 선택기를 정책의 임곗값 조건 필드로 사용하여 필터를 지정합니다. Monitoring API를 사용하여 SLO 기반 알림 정책을 만드는 방법에 대한 자세한 내용은 알림 정책 만들기를 참조하세요.
SLO에 사용 가능한 시계열 선택기의 하위 집합만 알림 정책에 사용할 수 있습니다.
또한 Google Cloud 콘솔에서 생성된 SLO 기반 알림 정책은 항상 select_slo_burn_rate 선택기를 사용합니다.
필터에 시계열 선택기 사용
SLO의 시계열 데이터를 가져오려면 필터에서 시계열 선택기를 지정해야 합니다. SLO 데이터는 측정항목 유형과 함께 저장되지 않으며, 측정항목 및 모니터링 리소스 유형의 쌍을 지정하는 필터로 검색할 수 없습니다.
이름 및 인수
시계열 선택기는 다음 형식 중 하나입니다.
SELECTOR_NAME(SLO_NAME) SELECTOR_NAME(SLO_NAME, LOOKBACK_PERIOD)
선택기의 이름은 select_slo_로 시작하고 하나 또는 두 개의 인수를 사용합니다.
선택기의 첫 번째 인수는 다음과 같이 SLO의 리소스 이름입니다.
projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID
앞의 표현식에는 3개의 변수가 포함됩니다.
- PROJECT_ID: Google Cloud 프로젝트의 이름 또는 번호입니다.
- SERVICE_ID: 서비스 이름입니다.
- SLO_ID: 서비스에 정의된 SLO의 식별자입니다.
Google Cloud 프로젝트의 SERVICE_ID 및 SLO_ID 필드 값을 찾는 방법은 API 작업을 참조하세요.
두 번째 인수는 전환 확인 기간입니다(지원되는 경우). 전환 확인 기간에 대한 자세한 내용은 오류 예산 알림 유형을 참조하세요. 유효한 시간 단위는 'ns', 'us' 'ms', 's', 'm', 'h'입니다.
예를 들어 select_slo_budget 선택기는 SLO_NAME 인수를 사용하므로 이 선택기를 사용하는 필터는 다음과 같습니다.
select_slo_budget("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID")
반면에 select_slo_burn_rate 선택기에 SLO_NAME 및 LOOKBACK_PERIOD 인수가 필요하므로 이 선택기를 사용하는 필터는 다음과 같습니다.
select_slo_burn_rate("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID", "3600s")
모든 선택기의 목록과 설명은 시계열 선택기를 참조하세요.
선택기를 사용하여 데이터 가져오기
시계열 데이터를 쿼리할 수 있는 한 가지 방법은 timeSeries.list 메서드의 참조 페이지에서 API 탐색기 도구를 사용하는 것입니다..
이 도구에 대한 자세한 내용은 API 탐색기를 참조하세요.
예를 들어 SLO 예산 정보를 검색하려면 API 탐색기 도구에서 다음 필드를 작성합니다.
- 이름:
projects/PROJECT_ID - 필터:
select_slo_budget("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID") - interval.startTime:
2021-10-07T13:00:20-04:00 - interval.endTime:
2021-10-08T13:00:20-04:00
한 시스템에 대해 PROJECT_ID와 같은 변수를 값으로 바꾸고 메서드를 실행한 후 다음 시계열 데이터가 반환됩니다.
시계열 선택기
이 섹션에서는 SLO에 사용할 수 있는 시계열 선택기를 나열하고 SLO에 대해 설명합니다. 모든 선택기는 timeSeries.list 메서드의 필터에서 시계열 데이터를 검색하는 데 사용할 수 있습니다. 일부 알림은 알림 정책에서 지원되지 않습니다.
select_slo_burn_rate
구문: select_slo_burn_rate(SLO_NAME, LOOKBACK_PERIOD)
'소진율' 시계열 선택기는 SLO의 지속 가능한 실패율에 대한 현재 실패율(전환 확인 간격의 잘못된 요청 비율)의 비율을 반환합니다. 지속 가능한 실패율은 SLO가 정확히 충족되는 비율입니다.
이 시계열의 값 범위는 0 ~ 무한대입니다.
- 값 1은 서비스가 너무 위험하지도 않고 너무 보수적이지도 않은 이상적인 실패율을 나타냄을 의미합니다.
- 1보다 큰 값은 실패율이 지속률을 초과한다는 의미입니다. 값이 클수록 SLO가 더 빨리 규정을 준수하지 않게 됩니다.
- 1보다 작은 값은 현재 실패율이 지속률보다 낮다는 의미입니다.
소진율을 모니터링하려면 두 개의 알림 정책을 사용하는 것이 좋습니다. 소진율이 급증할 때 알림을 주는 빠른 소진 정책과 소진율이 점진적으로 증가할 때 알림을 주는 느린 소진 정책이 있습니다.
API 또는 Google Cloud 콘솔을 사용하여 이 시계열 선택기를 기반으로 알림 정책을 만들고 수정할 수 있습니다.
Google Cloud 콘솔을 사용하여 생성된 모든 SLO 기반 알림 정책은 이 선택기를 사용하여 SLO 데이터를 검색합니다.
select_slo_health
구문: select_slo_health(SLO_NAME)
'SLO 상태' 시계열은 '특정 인수 기간 동안 총 요청 대비 좋은 요청의 비율은?'이라는 질문에 답변입니다. 좋은 요청으로 간주되는 항목은 서비스의 SLI에 의해 정의됩니다. SLI에 대한 자세한 내용은 개요를 참조하세요.
이 시계열은 서비스 성능을 측정합니다. 서비스에 대한 모든 요청이 올바르면 이 시계열의 데이터 포인트 값이 1입니다. 나쁜 요청 수가 증가하면 데이터 포인트의 값이 낮아집니다.
select_slo_compliance
구문: select_slo_compliance(SLO_NAME)
'SLO 규정 준수' 시계열은 '규정 준수 기간이 시작된 이후의 총 단위에 대한 좋은 단위의 비율은?'이라는 질문에 대한 답변입니다. 규정 준수 기간은 SLO에 따라 순환 기간 또는 캘린더 시간의 범위로 정의됩니다. 단위는 요청 또는 기간일 수 있습니다. 자세한 내용은 요청 및 Windows 기반 SLO의 규정 준수를 참조하세요.
이 시계열은 서비스가 SLO를 얼마나 잘 충족하는지에 대한 일반적인 개요를 제공합니다. 운영 상의 긴급 신호는 생성하지 않습니다.
알림 정책에는 이 시계열 선택기를 사용하지 않습니다.
select_slo_budget
구문: select_slo_budget(SLO_NAME)
'SLO 예산' 시계열은 '측정 시 기준으로 오류 예산은 얼마나 남아있나요?'라는 질문에 대한 답변입니다. 오류 예산은 요청 또는 분 단위로 측정될 수 있으며, 남은 오류 예산은 규정 준수 기간이 캘린더 시간대로 측정되는지 또는 롤링 윈도우로 측정되는지에 따라 계산됩니다. 자세한 내용은 오류 예산을 참조하세요.
이 시계열은 서비스의 신뢰성에 대한 위험을 측정합니다. 오류 예산이 0보다 작아지면 현재 기간에 SLO를 충족시키지 못할 수 있습니다. SLO를 충족하지 못하는 경우 조직의 신뢰성에 따라 조직의 프로덕션 환경에 실제로 영향을 미칠 수 있습니다.
알림 정책에는 이 시계열 선택기를 사용하지 않습니다.
select_slo_budget_fraction
구문: select_slo_budget_fraction(SLO_NAME)
'SLO 예산 비율' 시계열은 '현재 오류 예산은 음의 무한대에서 1사이의 비율로 표시하여 얼마나 남아있나요?'라는 질문에 대한 답변입니다.
알림 정책에는 이 시계열 선택기를 사용하지 않습니다.
select_slo_budget_total
구문: select_slo_budget_total(SLO_NAME)
'SLO 총 예산' 시계열은 '규정 준수 기간이 시작된 이후 서비스의 동작에 따라 현재 사용할 수 있는 총 오류 예산(요청 또는 분 단위)은 얼마인가?라는 질문에 대한 답변입니다. 규정 준수 기간은 SLO에 따라 순환 기간 또는 캘린더 시간의 범위로 정의됩니다.
알림 정책에는 이 시계열 선택기를 사용하지 않습니다.
select_slo_counts
구문: select_slo_counts(SLO_NAME)
'SLO 수' 시계열은 '특정 정렬 기간 동안 좋은 요청과 나쁜 요청의 수는?'이라는 질문에 대한 답변입니다. 이 선택기는 일반적인 상태를 기록하고 장기 저장소 시스템으로 수집하는 데 적합한 시계열을 제공합니다.
알림 정책에는 이 시계열 선택기를 사용하지 않습니다.