# File Access Profiler 모듈 레퍼런스

> Reference for the File Access module, which collects data about file activity in your application.

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

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

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

## 차트 카테고리

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

| **차트**                | **설명**                                                                       |
| --------------------- | ---------------------------------------------------------------------------- |
| **Files Opened**      | 해당 프레임에서 성공적으로 열린 로컬 파일 시스템의 전체 파일 수입니다.                                     |
| **Files Closed**      | 해당 프레임에서 성공적으로 닫힌 로컬 파일 시스템의 전체 파일 수입니다.                                     |
| **File Seeks**        | 해당 프레임에서 로컬 파일 시스템에서 수행된 파일 검색 작업 수입니다. 파일 검색 작업에는 파일의 콘텐츠를 검색하는 작업이 포함됩니다.  |
| **Reads in Flight**   | 해당 프레임 동안 진행 중인 전체 읽기 작업 수입니다.                                               |
| **File Handles open** | 해당 프레임 동안 열린 상태로 유지된 전체 파일 핸들 수입니다. 여기에는 Unity가 동일한 프레임 내에서 열고 닫는 파일이 포함됩니다. |

## 모듈 세부 정보 창 툴바

File Access Profiler 모듈에서 프레임을 선택하면 모듈 세부 정보 창에 Unity가 캡처 중에 액세스했던 파일에 대한 세부 정보가 표시됩니다. 툴바를 통해 다음 기능을 사용할 수 있습니다.

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

## File Summary 뷰

File Summary 뷰에는 캡처하는 동안 각 파일에 발생한 모든 파일 액세스 작업의 요약이 표시됩니다. 테이블의 항목 한 개는 단일 파일에 대한 전체 요약을 나타냅니다.

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

| **값**                      | **설명**                                                     |
| -------------------------- | ---------------------------------------------------------- |
| **Filename**               | 액세스한 파일의 이름입니다.                                            |
| **Total Bytes Read**       | 선택한 프레임 동안 해당 파일에서 Unity가 읽은 정보의 총 바이트 수입니다.               |
| **Read Access Time (ms)**  | 선택한 프레임 동안 해당 파일에서 Unity가 읽기를 수행하는 데 소요한 총 시간입니다.          |
| **Access Count**           | 선택한 프레임 동안 해당 파일에 대한 모든 유형의 총 액세스 수입니다.                    |
| **First Frame**            | Unity가 이 파일에 액세스한 첫 번째 프레임입니다.                             |
| **Number of Frames**       | Unity가 해당 파일에 액세스한 총 프레임 수입니다.                             |
| **ID**                     | 파일 액세스 마커의 실행 순서를 나타내는 인덱스입니다.                             |
| **Read Bandwidth (MBps)**  | 선택한 프레임에서 이 파일에 대한 읽기 작업의 평균 대역폭(MB/s)입니다.                 |
| **Open Count**             | 선택한 프레임 동안 이 파일에 대한 전체 열기 작업 수입니다.                         |
| **Close Count**            | 선택한 프레임 동안 이 파일에 대한 전체 닫기 작업 수입니다.                         |
| **Read Count**             | 선택한 프레임 동안 이 파일에 대한 전체 읽기 작업 수입니다.                         |
| **Write Count**            | 선택한 프레임 동안 이 파일에 대한 전체 쓰기 작업 수입니다.                         |
| **Seek Count**             | 선택한 프레임 동안 이 파일에 대한 전체 파일 검색 작업 수입니다.                      |
| **Total Bytes Written**    | 선택한 프레임 동안 Unity가 이 파일에 쓴 전체 바이트 수입니다.                     |
| **Write Bandwidth (MBps)** | 선택한 프레임에서 이 파일에 대한 쓰기 작업의 평균 대역폭(MB/s)입니다.                 |
| **Open Access Time (ms)**  | 선택한 프레임 동안 Unity가 이 파일에 대한 열기 작업을 수행하는 데 소요한 전체 시간(ms)입니다. |
| **Close Access Time (ms)** | 선택한 프레임 동안 Unity가 이 파일에 대한 닫기 작업을 수행하는 데 소요한 전체 시간(ms)입니다. |
| **Write Access Time (ms)** | 선택한 프레임 동안 Unity가 이 파일에 쓰기 작업을 수행하는 데 소요한 전체 시간(ms)입니다.    |
| **Total Access Time (ms)** | 선택한 프레임 동안 Unity가 이 파일에 액세스하는 데 소요한 전체 시간(ms)입니다.          |

## Accesses 뷰

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

| **값**                        | **설명**                                                        |
| ---------------------------- | ------------------------------------------------------------- |
| **Index**                    | Unity가 액세스 작업을 수행한 순서를 나타내는 ID 번호입니다.                         |
| **Filename**                 | 해당 작업 중 액세스한 파일의 이름입니다. 전체 파일 경로를 보려면 파일 이름 항목 위에 커서를 올립니다.   |
| **Type**                     | 수행된 액세스 작업의 유형입니다. Open, Close, Seek, Read, Write 중 하나입니다.    |
| **Access Size**              | 읽기 또는 쓰기 액세스 중에 전송된 바이트 수입니다. 액세스가 파일 검색이었던 경우 크기는 대상 오프셋입니다. |
| **Offset**                   | 파일 액세스의 (시작) 오프셋입니다.                                          |
| **Duration (ms)**            | 이 액세스를 수행하는 데 걸린 시간(ms)입니다.                                   |
| **Average Bandwidth (MBps)** | 액세스 유형이 읽기인 액세스의 평균 대역폭입니다.                                   |
| **First Frame Index**        | 이 액세스가 시작된 프레임의 ID입니다.                                        |
| **Frames**                   | 이 액세스가 발생한 전체 프레임 수입니다.                                       |
| **Thread**                   | 액세스가 발생한 스레드입니다.                                              |
| **Timestamp (ms)**           | 프로파일러 캡처 시작을 기준으로 이 액세스가 시작된 시간입니다.                           |

## 컨텍스트 메뉴

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

| **값**                                    | **설명**                                                                                                                 |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Show marker in timeline view**         | [CPU Usage Profiler](/engine/6000.0/manual/analysis/profiler/collect-data/visualizing-data/cpu/cpu.md) 모듈에서 이 마커를 엽니다. |
| **Go to the first frame of this marker** | 차트에 마커가 처음 나타나는 프레임을 선택합니다. 이 옵션은 마커가 한 프레임에만 나타나는 경우 비활성화됩니다.                                                         |
| **Go to the last frame of this marker**  | 차트에 이 마커가 마지막으로 나타나는 프레임을 선택합니다. 이 옵션은 마커가 한 프레임에만 나타나는 경우 비활성화됩니다.                                                    |
| **Filter the view to this file path**    | 결과를 필터링하기 위해 **Filename** 열의 콘텐츠로 검색 바를 채웁니다.                                                                          |

## 추가 리소스

* [프로파일러 모듈 소개](/engine/6000.0/manual/analysis/profiler/collect-data/visualizing-data/modules-introduction.md)
* [프로파일러 창 레퍼런스](/engine/6000.0/manual/analysis/profiler/window-reference.md)
* [수집 성능 데이터 소개](/engine/6000.0/manual/analysis/profiler/collect-data/profiling-collect-data-introduction.md)
