---
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/profiler/visualizing-data/file-access-module
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/analysis/profiler/visualizing-data/file-access-module.md
last_updated: 2026-09-14
generated_at: 2026-11-19T17:10:31.292Z
locale: ko-kr
---

# 파일 액세스 프로파일러 모듈 레퍼런스

> 애플리케이션의 파일 활동에 대한 데이터를 수집하는 File Access 모듈에 대한 레퍼런스입니다.

파일 액세스 프로파일러 모듈은 Unity 수행하는 읽기 또는 쓰기 작업 수 또는 열려 있는 파일 핸들 수 등 애플리케이션의 파일 활동에 대한 정보를 표시합니다. 모듈은 특정 프레임 또는 캡처의 모든 프레임에 대해 이 정보를 표시할 수 있습니다. 이 정보를 사용하여 애플리케이션이 파일 작업을 얼마나 효율적으로 수행하는지 판단할 수 있습니다.

파일 액세스 모듈은 빌드된 애플리케이션의 폴더 구조 내 또는 Unity 에디터더 내의 파일 작업에 대한 정보를 캡처할 수 있습니다. 이 모듈은 실패한 파일 작업에 대한 정보를 수집하지 않습니다. 파일 작업 시도에 실패하면 Unity 오류가 표시됩니다.

이 모듈은 기본적으로 활성화되어 있지 않습니다. 파일 액세스 프로파일러 모듈을 활성화하려면 [프로파일러 모듈 활성화](/engine/6000.0/manual/analysis/profiler/visualizing-data/modules-activate.md)를 참조하십시오.

## 차트 카테고리##chart-categories

프로파일러 창 상단에는 다음 카테고리가 있는 파일 액세스 차트가 표시됩니다.

| **차트**       | **설명**                                                                     |
| ------------ | -------------------------------------------------------------------------- |
| **파일 열기**    | 이 프레임에서 성공적으로 열려 있는 로컬 파일 시스템의 전체 파일 수입니다.                                 |
| **폐쇄된 파일**   | 이 프레임에서 성공적으로 닫힌 로컬 파일 시스템의 전체 파일 수입니다.                                    |
| **파일 검색**    | 이 프레임에서 로컬 파일 시스템에서 수행된 파일 검색 작업 수입니다. 파일 검색 작업에는 파일의 콘텐츠를 검색하는 작업이 포함됩니다. |
| **행중 읽기**    | 이 프레임 동안 진행 중인 전체 읽기 작업 수입니다.                                              |
| **파일 핸들 열기** | 이 프레임 동안 열린 상태로 유지된 전체 파일 핸들 수입니다. 여기에는 Unity 같은 프레임 내에서 열고 닫는 파일이 포함됩니다.  |

## 모듈 세부 정보 창 툴바##module-details-pane-toolbar

파일 액세스 프로파일러 모듈에서 프레임을 선택하면 모듈 세부 정보 창에 Unity 캡처 중에 액세스한 파일에 대한 상세 정보가 표시됩니다. 툴바 사용하여 다음 기능에 액세스합니다.

| **프로퍼티**     | **설명**                                                                                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **드롭다운 보기**  | 드롭다운을 사용하여 데이터 뷰를 변경합니다.**파일 요약**: 선택한 프레임 동안 Unity 액세스한 각 파일의 모든 파일 활동 요약을 표시합니다.**액세스**: 각 파일 액세스 작업이 발생한 순서대로 데이터 세트에 표시됩니다. |
| **프레임 드롭다운** | 드롭다운을 사용하여 파일 정보를 표시할 프레임 수를 선택합니다.**이 프레임**: 선택한 프레임의 파일 활동 요약을 표시합니다.**모든 프레임**: 프로파일러 캡처의 모든 프레임에 대한 파일 활동 요약을 표시합니다.        |
| **마커 분석**    | 이 모듈은 세부 정보 창을 자동으로 채우지 않습니다. Analyze Markers 버튼을 선택하여 세부 정보 창을 데이터로 채웁니다.                                                      |

## 파일 요약 뷰##file-summary-view

File Summary 뷰는 캡처 중에 각 파일에 발생한 모든 파일 액세스 작업의 요약을 표시합니다. 표의 항목 하나는 단일 파일의 전체 요약을 나타냅니다.

다음 표에는 File Summary 뷰에 표시할 수 있는 가능한 모든 통계가 나와 있습니다. 기본적으로 모든 통계 열이 활성화된 것은 아닙니다. 열을 활성화하거나 비활성화하려면 열 헤더가 포함된 행의 아무 곳이나 마우스 오른쪽 버튼으로 클릭 수 메뉴를 엽니다. 이 메뉴를 사용하여 각 열의 뷰를 활성화하거나 비활성화합니다.

| **값**              | **설명**                                                    |
| ------------------ | --------------------------------------------------------- |
| **파일명**            | 액세스한 파일의 이름입니다.                                           |
| **총 바이트 읽음**       | 선택한 프레임 동안 Unity 이 파일에서 읽은 전체 바이트 수입니다.                   |
| **읽기 액세스 시간(ms)**  | 선택한 프레임 동안 Unity 이 파일에서 읽기를 수행하는 데 소비한 총 시간입니다.           |
| **액세스 수**          | 선택한 프레임 동안 이 파일에 대한 모든 타입의 전체 액세스 횟수입니다.                  |
| **첫 번째 프레임**       | Unity 이 파일에 액세스한 첫 번째 프레임입니다.                             |
| **프레임 수**          | Unity 이 파일에 액세스한 총 프레임 수입니다.                              |
| **ID**             | 파일 액세스 마커 실행 순서를 나타내는 인덱스입니다.                             |
| **읽기 대역폭(MBps)**   | 선택한 프레임에서 이 파일에 대한 읽기 작업의 평균 대역폭(단위: 초당 메가바이트)입니다.        |
| **Open Count**     | 선택한 프레임 동안 이 파일에 대한 총 열기 작업 수입니다.                         |
| **클로즈 카운트**        | 선택한 프레임 동안 이 파일에 대한 전체 닫기 작업 수입니다.                        |
| **읽기 횟수**          | 선택한 프레임 동안 이 파일에 대한 전체 읽기 작업 수입니다.                        |
| **쓰기 횟수**          | 선택한 프레임 동안 이 파일에 대한 총 쓰기 작업 수입니다.                         |
| **검색 수**           | 선택한 프레임 동안 이 파일에 대한 전체 파일 검색 작업 수입니다.                     |
| **작성된 총 바이트** 수    | 선택한 프레임 동안 Unity 이 파일에 작성한 총 바이트 수입니다.                    |
| **쓰기 대역폭(MBps)**   | 선택한 프레임에서 이 파일에 대한 쓰기 작업의 평균 대역폭(단위: 초당 메가바이트)입니다.        |
| **오픈 액세스 시간(ms)**  | 선택한 프레임 동안 Unity 이 파일에 대한 열기 작업을 수행하는 데 소비한 총 시간(밀리초)입니다. |
| **클로즈 액세스 시간(ms)** | 선택한 프레임 동안 Unity 이 파일에 대한 근접 작업을 수행하는 데 소비한 총 시간(밀리초)입니다. |
| **쓰기 액세스 시간(ms)**  | 선택한 프레임 동안 Unity 이 파일에 대한 쓰기 작업을 수행하는 데 소비한 총 시간(밀리초)입니다. |
| **총 액세스 시간(ms)**   | 선택한 프레임 동안 Unity 이 파일에 액세스하는 데 소비한 총 시간(밀리초)입니다.          |

## 보기 액세스##accesses-view

Accesses 뷰는 캡처의 모든 파일 액세스 작업에 대한 자세한 정보를 제공합니다. 프로파일러의 세부 정보 창에 있는 표의 각 항목은 단일 파일에 대한 단일 파일 액세스 작업을 나타냅니다. 다음 표에는 액세스 뷰에서 표시할 수 있는 가능한 모든 열이 나와 있습니다.

| **값**              | **설명**                                                                 |
| ------------------ | ---------------------------------------------------------------------- |
| **Index**          | Unity 액세스 작업을 수행한 순서를 나타내는 ID 번호입니다.                                   |
| **파일명**            | 이 작업 중 액세스한 파일의 이름입니다. 전체 파일 경로를 보려면 파일 이름 엔트리 위에 커서를 올립니다.            |
| **Type**           | 수행된 액세스 작업의 유형입니다. Open, Close, Seek, Read, Write 중 하나입니다.             |
| **액세스 크기**         | 액세스 중에 전송된 바이트 수이며, 액세스가 읽기 또는 쓰기였습니다. 액세스가 파일 검색이었던 경우 크기는 대상 오프셋입니다. |
| **오프셋**            | 파일 액세스의 (시작) 오프셋입니다.                                                   |
| **Duration (ms)**  | 이 액세스를 수행하는 데 걸리는 시간(밀리초)입니다.                                          |
| **평균 대역폭(MBps)**   | 액세스 유형이 읽기인 경우 이 액세스의 평균 대역폭입니다.                                       |
| **첫 번째 프레임 인덱스**   | 이 액세스가 시작된 프레임의 ID입니다.                                                 |
| **프레임**            | 이 액세스가 발생한 총 프레임 수입니다.                                                 |
| **Thread**         | 액세스가 발생한 스레드입니다.                                                       |
| **TimeStamp (ms)** | 프로파일러 캡처 시작을 기준으로 이 액세스가 시작된 시간입니다.                                    |

## 컨텍스트 메뉴##context-menu

파일 액세스 마커를 마우스 오른쪽 버튼으로 클릭하여 데이터를 탐색할 수 있는 추가 옵션이 있는 하위 메뉴를 엽니다. 사용 가능한 옵션은 다음과 같습니다.

| **값**                   | **설명**                                                                                              |
| ----------------------- | --------------------------------------------------------------------------------------------------- |
| **Timeline 뷰에서 마커 표시**  | [CPU 사용 프로파일러](/engine/6000.0/manual/analysis/profiler/visualizing-data/cpu/cpu.md) 모듈에서 이 마커를 엽니다. |
| **이 마커의 첫 번째 프레임으로 이동** | 차트에 마커가 처음 나타나는 프레임을 선택합니다. 이 옵션은 마커가 한 프레임에만 나타나는 경우 비활성화됩니다.                                      |
| **이 마커의 마지막 프레임으로 이동**  | 이 마커가 차트에 마지막으로 나타나는 프레임을 선택합니다. 이 옵션은 마커가 한 프레임에만 나타나는 경우 비활성화됩니다.                                 |
| **뷰를 이 파일 경로로 필터링**     | 결과를 필터링하기 위해 **Filename** 열의 콘텐츠로 검색창을 채웁니다.                                                        |

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

* [프로파일러 모듈 소개](/engine/6000.0/manual/analysis/profiler/visualizing-data/modules-introduction.md)
* [프로파일러 창 참조](/engine/6000.0/manual/analysis/profiler/window.md)
* [수집 퍼포먼스 데이터 소개](/engine/6000.0/manual/analysis/profiler/profiling-applications/profiling-collect-data-introduction.md)
