---
title: 버킷 할당자 예시
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/analysis/performance-memory/native-memory/allocator-examples/bucket-allocator
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/analysis/performance-memory/native-memory/allocator-examples/bucket-allocator.md
last_updated: 2026-10-30
generated_at: 2026-11-19T18:58:48.395Z
locale: ko-kr
---

# 버킷 할당자 예시

> 버킷 할당자의 사용량 리포트를 검사합니다.

## 필수 조건##prerequisites

이 예제에서는 플레이어 또는 Unity 에디터 닫을 때 로그에 기록되는 메모리 사용량 리포트를 사용합니다. 이러한 리포트를 만들려면 `-log-memory-performance-stats` 커맨드 라인 인자를 사용합니다. 프로젝트의 로그 파일을 찾으려면 [로그 파일 페이지](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)의 지침을 따르십시오.

## 예제 구성##example-configuration

버킷 할당자는 할당을 위해 메모리 블록을 예약합니다. 각 블록은 16KB의 하위 섹션으로 구성됩니다. 다음 예제 구성은 할당을 위한 블록 예약 프로세스를 보여 줍니다.


**Shared Bucket Allocator for Windows, macOS, and Linux Player:**
![](/api/media?file=/engine/6000.0/media/images/Shared_Bucket.png)

이 설정에서 총 블록 크기(**버킷 할당자 블록 크기**)는 4MB이고 할당 세분화(**버킷 할당자 세분화**)는 16바이트입니다. 버킷을 생성하는 첫 번째 할당 크기는 16바이트이고 두 번째는 32바이트(2\*16)이며, 그 다음 총 8개의 버킷(**버킷 할당자 BucketCount**)에 대해 48바이트, 64바이트, 80바이트, 96바이트, 112바이트 및 128바이트입니다.

각 하위 섹션에는 다른 수의 버킷이 포함되어 있습니다. 하위 섹션의 버킷 수를 계산하려면 하위 섹션 크기(16KB)를 세분화 크기로 나눈다. 예제는 아래와 같습니다.

* 할당 세분화가 64바이트이면 256버킷이 하위 섹션에 들어갑니다.
* 할당 세분화가 16바이트이면 1,024개 버킷이 하위 섹션에 저장됩니다.

## 개발 및 릴리스 빌드 비교##development-and-release-build-comparison

버킷 할당자는 개발 빌드에서 각 할당에 추가 40바이트 헤더가 있기 때문에 [개발 빌드와 릴리스 빌드](/engine/6000.0/manual/building-and-publishing/building-introduction.md)에 대해 서로 다른 사용량 보고서를 생성합니다. 다음 다이어그램은 16바이트 할당과 64바이트 할당을 위한 개발 빌드와 릴리스 빌드의 차이점을 보여 줍니다.


**Development and Release builds comparison:**
![](/api/media?file=/engine/6000.0/media/images/memory_allocation.png)

헤더는 4MB 중 2MB만 할당한 후 할당자가 채워진 상태로 리포트하는 이유입니다.

```lang-plain
[ALLOC_BUCKET]
      대규모 블록 크기 4.0MB
      사용된 블록 수 1
      피크 할당 바이트 2.0MB
      할당에 실패했습니다. 버킷 레이아웃:
        16B: 64 하위 섹션 = 18724개 버킷. 카운트 실패: 3889
        32B: 17 하위 섹션 = 3868개 버킷. 카운트 실패: 169583
        48B: 31 하위 섹션 = 5771개 버킷. 카운트 실패: 39674
        64B: 28 하위 섹션 = 4411개 버킷 카운트 실패: 9981
        80B: 17 Subsections = 2321개 버킷. 카운트 실패: 14299
        96B: 6 하위 섹션 = 722개 버킷. 카운트 실패: 9384
        112B: 44 하위 섹션 = 4742개 버킷. 카운트 실패: 5909
        128B: 49 하위 섹션 = 4778개 버킷. 카운트 실패: 8715
```

동일한 프로젝트의 릴리스 빌드에서 할당자 블록 크기는 충분합니다.

```lang-plain
[ALLOC_BUCKET]
      대규모 블록 크기 4.0MB
      사용된 블록 수 1
      피크 할당 바이트 3.3MB
```

버킷 할당자가 가득 차면 할당이 다른 할당자로 폴백됩니다. 사용량 보고서는 할당 실패 횟수를 비롯한 사용량 통계를 표시합니다. 리포트에 선형적으로 증가하는 실패 횟수가 표시되면 로드가 아닌 프레임을 계산할 때 할당 실패가 발생할 가능성이 높습니다. 폴백 할당은 씬 로드에 문제가 되지 않지만 프레임 계산 시 발생하면 성능에 영향을 미칠 수 있습니다.

이러한 폴백 할당을 방지하려면 블록 크기를 늘리고 새 블록 크기를 씬 로드 피크 사용 대신 프레임의 피크 사용량과 일치하도록 제한합니다. 이렇게 하면 블록이 너무 커서 런타임 시 사용할 수 없는 많은 메모리를 예약하지 못하게 됩니다.

> **Tip:**
>
> [프로파일러](/engine/6000.0/manual/analysis/profiler.md) 할당자는 버킷 할당자의 인스턴스를 공유합니다. [프로파일러 공유 버킷 할당자 설정](/engine/6000.0/manual/analysis/performance-memory/native-memory/memory-allocator-customization.md)에서 이 공유 인스턴스를 커스터마이즈할 수 있습니다.

## 추가 리소스##additional-resources

* [네이티브 메모리 할당자](/engine/6000.0/manual/analysis/performance-memory/native-memory/allocators.md)
* [네이티브 메모리 할당자 예제](/engine/6000.0/manual/analysis/performance-memory/native-memory/allocator-examples.md)
