이 문서에서는 운영 에이전트를 자동으로 설치하는 Batch 작업을 만들고 실행하는 방법을 설명합니다. 운영 에이전트를 설치하여 Cloud Monitoring에서 작업 리소스의 성능에 대한 추가 측정항목을 제공합니다. 작업에 리소스 성능 측정항목을 사용하는 방법은 측정항목을 확인하여 작업 리소스를 모니터링하고 최적화를 참조하세요.
시작하기 전에
- Batch를 사용한 적이 없으면 Batch 시작하기를 검토하고 프로젝트 및 사용자 기본 요건을 완료하여 Batch를 사용 설정하세요.
- 프로젝트에 아직 Cloud Monitoring API와 Cloud Logging API를 사용 설정하지 않은 경우 사용 설정합니다.
-
작업을 만드는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.
-
작업 만들기:
-
프로젝트에 대한 Batch 작업 편집자(
roles/batch.jobsEditor
) -
기본적으로 기본 Compute Engine 서비스 계정인 작업의 서비스 계정에 대한 서비스 계정 사용자(
roles/iam.serviceAccountUser
)
-
프로젝트에 대한 Batch 작업 편집자(
- 로그 보기: 프로젝트에 대한 로그 뷰어(
roles/logging.viewer
)
역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.
-
작업 만들기:
작업의 서비스 계정에 대한 기본 구성을 사용하지 않는 경우 필요한 권한이 있는지 확인합니다.
작업의 서비스 계정에 운영 에이전트 측정항목을 Monitoring에 기록하는 데 필요한 권한이 있는지 확인하려면 관리자에게 작업의 서비스 계정에 다음 IAM 역할을 부여해 달라고 요청하세요.
-
프로젝트에 대한 Monitoring 측정항목 작성자(
roles/monitoring.metricWriter
) -
프로젝트에 대한 로그 작성자(
roles/logging.logWriter
)
-
프로젝트에 대한 Monitoring 측정항목 작성자(
- 계획된 작업 구성이 운영 에이전트 요구사항을 충족하는지 확인합니다.
운영 에이전트 요구사항
운영 에이전트를 사용하는 작업을 만들고 실행하려면 작업이 다음 요구사항을 모두 준수해야 합니다.
작업의 VM이 운영 에이전트가 지원하는 운영체제(OS)를 사용하는지 확인합니다. 작업의 VM OS 이미지에 대한 자세한 내용은 작업 VM의 OS 환경 개요를 참조하세요.
작업이 기본이 아닌 네트워킹 구성을 사용하거나 VPC 서비스 제어를 사용하는 경우 작업이 운영 에이전트의 액세스 요구사항을 충족하는지 확인합니다. 자세한 내용은 Google Cloud Observability 문서의 원격 패키지 액세스가 없는 VM을 참조하세요.
작업이 기존 Cloud Logging 에이전트 또는 Cloud Monitoring 에이전트를 설치하지 않는지 확인합니다(예: 커스텀 이미지 또는 인스턴스 템플릿).
운영 에이전트의 기능 및 요구사항에 대한 자세한 내용은 Google Cloud Observability 문서의 운영 에이전트 개요를 참조하세요.
운영 에이전트를 자동으로 설치하는 작업 만들기
Google Cloud CLI 또는 REST API를 사용하여 installOpsAgent
필드를 포함하는 작업을 만들고 JSON 파일의 본문에 있는 allocationPolicy.instances
필드에서 true
로 설정합니다.
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
예를 들어 운영 에이전트를 자동으로 설치하는 작업에는 다음과 비슷한 JSON 구성 파일이 있을 수 있습니다.
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
작업의 VM 실행이 시작되면 다른 리소스 측정항목과 마찬가지로 운영 에이전트 측정항목을 볼 수 있습니다. 자세한 내용은 측정항목을 확인하여 작업 리소스를 모니터링 및 최적화를 참조하세요.
다음 단계
- 작업을 만들거나 실행하는 데 문제가 있는 경우 문제 해결을 참조하세요.
- 작업 및 태스크 보기
- 작업 만들기 옵션 자세히 알아보기