AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

자동 확장 작업 및 경고

이 페이지에서는 자동 확장 작업 검토, 자동 확장 자동 확장 경고 구성, 효과적인 필드로 자동 확장 개선, 자동 확장 지원 받기 등 자동 확장 에 대해 설명합니다.

활동 피드를 확인하여 각 Atlas 프로젝트 의 이벤트를 검토 할 수 있습니다. 자동 확장 이벤트 발생하면 Atlas Activity Feed 프로젝트 에 이벤트 기록합니다.

Atlas는 다음과 같은 감사 자동 확장 이벤트를 사용합니다.

활동 피드의 각 자동 확장 이벤트 다음을 포함하여 확장 조치 트리거한 원인에 대한 자세한 정보가 포함되어 있습니다.

  • 자동 확장 이벤트 트리거한 특정 지표(예: CPU 사용률, 메모리 사용량 또는 디스크 공간)입니다.

  • 임계값이 초과되었습니다.

  • 확장 이 반응형 자동 확장 (현재 리소스 사용량에 따른)에 의해 트리거되었는지, 아니면 예측 자동 확장 (예상 수요를 예측하여)에 의해 트리거되었는지 여부.

자동 스케일링 이벤트만 보거나 다운로드하려면 다음을 수행합니다.

Atlas에서 Project Activity Feed 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 사이드바에서 Security 헤더 아래의 Activity Feed 을 클릭합니다.

    프로젝트 활동 피드 페이지가 표시됩니다.

1

Activity Feed 에서 Filter by event(s) 메뉴를 클릭하고 Atlas를 선택합니다.

2

목록 위의 검색 상자에 auto-scaling을 입력합니다.

메뉴의 오른쪽에는 모든 자동 확장 이벤트가 표시됩니다. 보고 싶지 않은 항목은 선택 해제하세요. 피드 목록은 변경할 때마다 자동으로 업데이트됩니다.

중요

2024년 8월 초, Atlas는 기존 자동 크기 조정 알림 이메일을 구성 가능한 자동 크기 조정 이벤트로 대체했습니다. 기본적으로 Atlas는 모든 알림을 프로젝트 소유자에게 계속 보냅니다. 알림 수신자나 배포 방법을 변경하기 위해 자동 크기 조정 알림 배포를 사용자 정의할 수 있습니다.

자동 확장 활동은 Atlas 경고의 하위 집합입니다. Atlas 자동 확장 이벤트를 트리거할 때마다 기본값 Atlas 경고를 받게 됩니다.

프로젝트 수준에서 일부 또는 모든 자동 스케일링 이벤트에 대한 알림 구성을 선택 해제하거나 변경할 수 있습니다.

중요

자동 확장 경고는 프로젝트 의 모든 클러스터에 적용 . 특정 클러스터로 경고 범위를 지정할 수 없습니다. 경고 알림 클러스터 이름과 ID 별로 이벤트 트리거한 클러스터 식별합니다.

경고 구성을 수정하려면 Category 섹션에서 Atlas Auto Scaling을 선택한 후 목록에서 Condition/Metric을 선택합니다. 그런 다음, 경고 수신자의 역할을 수정하고, 이메일 또는 SMS와 같은 알림 방법을 변경하고, Slack과 같은 알림 도구를 추가할 수 있습니다. 자세히 알아보려면 자동 확장 경고 구성을 참조하세요.

참고

이 기능 M10 계층 이상의 전용 클러스터에만 적용되며, Flex 클러스터에서는 지원되지 않습니다.

클러스터 에서 자동 확장 활성화되면 Atlas 워크로드 에 따라 인스턴스 크기와 저장 용량 자동으로 조정합니다.

클러스터 인스턴스 크기 조정 및 저장 구성에 MongoDB & HashiCorp Terraform 을 사용하는 경우, 클러스터 크기 조정 값의 하위 집합에 유효한 필드를 지정할 수 있습니다. 다음과 같은 방식으로 이 접근 방식을 권장합니다.

  • 사양 속성은 Terraform 구성에서 정의한 그대로 유지됩니다.

  • 기본값과 자동 확장된 값은 유효 사양( 예시 : effectiveElectableSpecs)에서 별도로 사용할 수 있으며, Atlas 클러스터 를 자동 확장할 때 리소스 드리프트가 발생하지 않습니다.

  • 구성은 깔끔하게 유지되고 의도를 나타내며, 효과적인 사양은 Atlas 프로비저닝한 내용의 현실을 보여줍니다.

유효 필드는 특정 유형의 자동 확장 으로 managed 필드에 대한 변경 사항만 무시합니다. 다음 표에는 유효 필드와 특정 유형의 자동 확장 활성화된 경우 무시되는 필드가 자세히 설명되어 있습니다.

자동 확장 유형 활성화
사양
무시된 필드
노드 유형

컴퓨팅 또는 저장

electableSpecs

instanceSize, diskSizeGB, diskIOPS

컴퓨팅 또는 저장

readOnlySpecs

instanceSize, diskSizeGB, diskIOPS

분석

analyticsSpecs

instanceSize

검색 노드에는유효 필드를 사용할 수 없습니다.

유효 필드를 활성화 하려면 API 요청 에 다음 헤더를 포함하세요.

--header "Use-Effective-Instance-Fields: true"

다음 예시 와 같이 클러스터 에 대한 리소스 정의에서 use_effective_fields 인수를 true 로 설정합니다.

resource "mongodbatlas_advanced_cluster" "this" {
project_id = mongodbatlas_project.this.id
name = var.cluster_name
cluster_type = var.cluster_type
use_effective_fields = true
replication_specs = var.replication_specs
tags = var.tags
}

자세한 내용은 효과적인 필드 모듈 예시를 참조하세요.

중요

유효 필드를 활성화 하지 않는 경우 자동 확장 발생 시 리소스 드리프트를 방지하기 위해 lifecycle.ignore_changes 차단 수동으로 구성해야 합니다. 이 방법은 권장하지 않습니다 . 자세한 학습 은 Terraform 문서에서 자동 확장 을 참조하세요.

전반적으로 효과적인 필드 동작은 세 가지 시나리오 중 하나로 분류됩니다.

사양 필드는 마지막 노드 구성을 저장 유효 필드는 최신 자동 확장 이벤트 이후의 값을 표시합니다. 이 시나리오의 코드 예시 보려면 클릭하세요.

참고

효과적인 필드를 활성화하는 것을 권장합니다.

{
"replicationSpecs": [
{
"regionConfigs": [
{
"analyticsAutoScaling": {
"compute": {
"maxInstanceSize": "M30",
"minInstanceSize": "M10",
"enabled": true,
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"autoScaling": {
"compute": {
"maxInstanceSize": "M30",
"minInstanceSize": "M10",
"enabled": true,
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"effectiveAnalyticsSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"effectiveElectableSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 3
},
"effectiveReadOnlySpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"electableSpecs": {
"instanceSize": "M20",
"diskSizeGB": 50.0,
"nodeCount": 3
},
"priority": 7,
"providerName": "AWS",
"regionName": "US_EAST_1"
}
],
"zoneId": "6924a70c67695449ba5625ce",
"zoneName": "Zone 1"
}
]
}

사양 필드에는 마지막 노드 구성이 저장 , 유효 필드에는 Atlas 내부적으로 저장하는 값이 표시됩니다. 이 시나리오의 코드 예시 보려면 클릭하세요.

참고

효과적인 필드를 활성화하는 것을 권장합니다.

{
"replicationSpecs": [
{
"regionConfigs": [
{
"effectiveAnalyticsSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"effectiveElectableSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 3
},
"effectiveReadOnlySpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"electableSpecs": {
"instanceSize": "M30",
"diskSizeGB": 100.0,
"nodeCount": 3
},
"priority": 7,
"providerName": "AWS",
"regionName": "US_EAST_1"
}
],
"zoneId": "6924a70c67695449ba5625ce",
"zoneName": "Zone 1"
}
]
}

유효 필드 값은 항상 해당 사양에 설정하다 값과 정확히 일치합니다. 이 시나리오의 코드 예시 보려면 클릭하세요.

중요

유효 필드를 활성화 하지 않는 경우 자동 확장 발생 시 리소스 드리프트를 방지하기 위해 lifecycle.ignore_changes 차단 수동으로 구성해야 합니다. 이 방법은 권장하지 않습니다 . 자세한 학습 은 Terraform 문서에서 자동 확장 을 참조하세요.

{
"replicationSpecs": [
{
"regionConfigs": [
{
"analyticsAutoScaling": {
"compute": {
"maxInstanceSize": "M30",
"minInstanceSize": "M10",
"enabled": true,
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"autoScaling": {
"compute": {
"maxInstanceSize": "M30",
"minInstanceSize": "M10",
"enabled": true,
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"effectiveAnalyticsSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"effectiveElectableSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 3
},
"effectiveReadOnlySpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"analyticsSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"electableSpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 3
},
"readOnlySpecs": {
"instanceSize": "M30",
"diskIOPS": 3000,
"diskSizeGB": 100.0,
"ebsVolumeType": "STANDARD",
"nodeCount": 0
},
"priority": 7,
"providerName": "AWS",
"regionName": "US_EAST_1"
}
],
"zoneId": "6924a70c67695449ba5625ce",
"zoneName": "Zone 1"
}
]
}

유효 필드를 활성화 Atlas 클러스터의 현재 유효 인스턴스 크기를 기준으로 새로운 자동 확장 범위 유효성을 검사합니다. Atlas 현재 유효 인스턴스 크기를 포함하지 않는 범위 설정하는 요청 거부합니다. 이 동작은 자동 확장 사용하는 운영 노드 및 분석 노드에 적용됩니다.

이 두 가지 경우 모두 유효성 검사 오류로 요청이 실패합니다.

  • 새 최소 인스턴스 크기가 유효 인스턴스 크기보다 큽니다.

  • 새 최대 인스턴스 크기가 유효 인스턴스 크기보다 작습니다.

새 범위에 여전히 현재 유효한 인스턴스 크기가 포함되어 있는 경우 단일 요청으로 범위를 변경할 수 있습니다.

현재 유효 인스턴스 크기가 새 범위 밖에 있는 경우 범위를 변경하기 전에 다음 절차에 따라 새 범위로 이동하세요. 범위 변경과 동일한 요청에서 인스턴스 크기를 업데이트하는 경우 Atlas는 유효 필드로 자동 확장이 활성화된 동안 새 인스턴스 크기를 적용하지 않으므로 요청이 여전히 실패합니다.

1

compute.enabled을 false로 설정합니다.

2

instanceSize을 대상 값으로 설정한 다음 요청을 보냅니다.

3

compute.enabled을 true로 설정합니다.

4

minInstanceSize과 maxInstanceSize을 새 범위로 설정한 다음 요청을 보냅니다.

Terraform으로 자동 확장 범위 조정하려면 Terraform 제공자 설명서에서 use_Effective_fields를 사용한 자동 확장 범위 조정을 참조하세요.

질문이나 우려 사항이 있는 경우 지원 문의.