Google Cloud Observability는 모니터링, 로깅, 진단 도구를 제공합니다. 이러한 도구를 사용하면 Cloud Tasks 활동 및 성장을 모니터링하고 분석하며 애플리케이션의 동작, 상태, 성능을 파악할 수 있습니다.
기본적으로 Cloud Tasks는 다음을 수행하도록 구성됩니다.
- 데이터 및 시스템 감사 로그를 Cloud Logging으로 전송합니다. 수집된 로그를 사용하여 애플리케이션을 디버깅하고, 문제를 해결하고, 유용한 정보를 얻을 수 있습니다.
- 시스템 및 리소스 측정항목을 Cloud Monitoring으로 전송합니다. 수집된 측정항목을 사용하여 상태와 성능을 모니터링하고, 트렌드와 문제를 식별하고, 동작의 변화에 대해 알림을 받을 수 있습니다.
Cloud Logging으로 감사 로그 전송
Cloud Tasks는 다음 유형의 감사 로그 데이터를 Cloud Logging으로 전송합니다.
데이터 액세스 감사 로그는 매우 클 수 있으므로 기본적으로 사용 중지되어 있습니다.
자세한 내용은 Cloud Tasks 감사 로깅을 참고하세요.
큐에 Cloud Logging 사용
Cloud Logging을 Cloud Tasks 큐와 함께 사용할 수 있습니다. 다음 작업이 로깅됩니다.
- 태스크 작업:
CreateTaskDeleteTask
- 시도 작업:
AttemptDispatchAttemptResponse
로깅 사용 설정
Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 로깅을 사용 설정할 수 있습니다.
콘솔
Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.
로깅을 사용 설정할 큐의 이름을 클릭합니다.
대기열 세부정보 페이지에서 로그 탭을 클릭합니다.
로그 사용 설정을 클릭하고 확인하려면 사용 설정을 클릭합니다.
gcloud
로깅을 사용 설정하려면 gcloud tasks queues create 또는 gcloud tasks queues update 명령어를 사용하면 됩니다.
gcloud tasks queues create QUEUE_ID \ --log-sampling-ratio=LOG_SAMPLING_RATION
또는
gcloud tasks queues update QUEUE_ID \ --log-sampling-ratio=LOG_SAMPLING_RATIO
다음을 바꿉니다.
QUEUE_ID: 큐의 ID입니다.LOG_SAMPLING_RATIO: 로깅된 작업의 비율입니다.1.0과0.0사이의 모든 값은 해당 작업의 비율을 로깅합니다. 모든 작업을 로깅하려면1.0으로 설정합니다. 작업을 로깅하지 않으려면0.0(기본값)으로 설정합니다.
로깅 중지
Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 로깅을 사용 중지할 수 있습니다.
콘솔
Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.
로깅을 사용 중지하려는 큐의 이름을 클릭합니다.
대기열 세부정보 페이지에서 로그 탭을 클릭합니다.
말줄임표 아이콘 > 로그 사용 중지를 클릭합니다. 사용 중지를 클릭하여 확인합니다.
gcloud
로깅을 사용 중지하려면 gcloud tasks queues update 명령어를 사용하고 log-sampling-ratio 플래그를 0.0로 설정합니다.
gcloud tasks queues update QUEUE_ID \ --log-sampling-ratio=0.0
QUEUE_ID를 큐의 ID로 바꿉니다.
로그 쿼리 및 보기
다음 도구를 사용하여 로그를 보고 분석할 수 있습니다.
- 로그 탐색기는 서비스와 애플리케이션의 문제를 해결하고 성능을 분석하는 데 도움이 되도록 설계되었습니다. 로그 탐색기에서 로그를 보는 방법을 알아보려면 로그 탐색기를 사용하여 로그 보기의 안내를 따르세요.
- 로그 애널리틱스는 쿼리를 실행하여 로그를 분석한 후 결과를 보거나 차트로 표시하도록 설계되었습니다. 로그 애널리틱스 사용 방법을 알아보려면 로그 애널리틱스로 로그 쿼리 및 분석의 안내를 따르세요.
로그 탐색기의 검색창에서 cloudtasks를 검색하여 Cloud Tasks 로그를 필터링할 수 있습니다.
로그를 쿼리하고 분석하는 방법에 대한 자세한 내용은 로그 쿼리 및 보기 개요를 참조하세요.
Cloud Monitoring에 측정항목 전송
Cloud Tasks는 모니터링 리소스의 측정항목 데이터를 Google Cloud Observability로 전송합니다. Monitoring의 모니터링 리소스는 가상 머신, 데이터베이스, 애플리케이션과 같은 논리적 또는 실제 항목을 나타냅니다. 모니터링 리소스에는 탐색하거나, 대시보드를 통해 보고하거나, 알림을 만드는 데 사용할 수 있는 고유한 측정항목 집합이 포함되어 있습니다.
Cloud Tasks는 다음 모니터링 리소스의 측정항목 데이터를 Google Cloud Observability로 전송합니다.
각 리소스에는 리소스에 관한 추가 정보를 보유하는 키-값 쌍인 리소스 라벨 집합도 있습니다. 리소스 라벨은 리소스와 연결된 모든 측정항목에 사용할 수 있으며 다음 표에 자세히 설명되어 있습니다.
리소스 측정항목 및 라벨
이 표의 '측정항목 유형' 문자열 앞에 cloudtasks.googleapis.com/가 포함된 프리픽스를 붙여야 합니다. 표의 항목에서는 이 프리픽스가 생략되었습니다.
라벨을 쿼리할 때 metric.labels. 프리픽스를 사용합니다(예: metric.labels.LABEL="VALUE").
| 측정항목 유형 실행 단계(리소스 계층 구조 수준) 표시 이름 |
|
|---|---|
| 종류, 유형, 단위 모니터링 리소스 |
설명 라벨 |
api/request_count
GA
(프로젝트)
API 요청 |
|
DELTA, INT64, 1
cloud_tasks_queue |
Cloud Tasks API 호출 수입니다. 60초마다 샘플링됩니다. 샘플링되면 데이터는 최대 240초 동안 표시되지 않습니다.
api_method:
호출되는 API 메서드입니다 (예: CreateTask).
response_code: 문자열로 된 표준 응답 코드입니다 (예: 'ok').
|
queue/depth
GA
(프로젝트)
대기열 깊이 |
|
GAUGE, INT64, 1
cloud_tasks_queue |
큐에 있는 태스크 수입니다. 60초마다 샘플링됩니다. 샘플링되면 데이터는 최대 120초 동안 표시되지 않습니다. |
queue/task_attempt_count
GA
(프로젝트)
작업 시도 수 |
|
DELTA, INT64, 1
cloud_tasks_queue |
응답 코드별로 분류된 작업 시도 횟수입니다. 60초마다 샘플링됩니다. 샘플링되면 데이터는 최대 180초 동안 표시되지 않습니다.
response_code: 문자열로 된 표준 응답 코드입니다 (예: 'ok').
|
queue/task_attempt_delays
GA
(프로젝트)
작업 시도 지연 |
|
DELTA, DISTRIBUTION, ms
cloud_tasks_queue |
예정된 각 시도 시간과 실제 시도 시간 간의 지연 시간입니다. 60초마다 샘플링됩니다. 샘플링되면 데이터는 최대 120초 동안 표시되지 않습니다. |
2025년 4월 18일 18:21:49(UTC)에 생성된 표입니다.
모든 리소스 유형을 보려면 모니터링 리소스 유형을 참조하세요. 모든 측정항목 유형을 보려면 Google Cloud 측정항목을 참조하세요.
측정항목 데이터 읽기
Cloud Monitoring API의 timeSeries.list 메서드를 사용하여 시계열 데이터라고도 하는 측정항목 데이터를 읽을 수 있습니다. 언어별 클라이언트 라이브러리를 사용하거나 측정항목 탐색기로 차트를 만드는 등 메서드를 호출하는 방법에는 여러 가지가 있습니다. 측정항목 및 시계열에 대한 소개는 측정항목, 시계열, 리소스를 참조하세요. 측정항목 데이터를 읽는 방법을 알아보려면 시계열 데이터 검색을 참조하세요.
Monitoring 대시보드 및 알림 사용
Monitoring 대시보드 및 관련 차트를 사용하여 Cloud Tasks 측정항목에 대한 데이터를 시각화할 수 있습니다.
Monitoring에서 이러한 측정항목을 모니터링하려면 커스텀 대시보드를 만듭니다. 이러한 측정항목을 기반으로 알림을 추가할 수도 있습니다.