---
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/customizing/adding-information-code/add-counters-code
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/analysis/profiler/customizing/adding-information-code/add-counters-code.md
last_updated: 2026-10-30
generated_at: 2026-11-19T15:33:41.978Z
locale: ko-kr
---

# 코드에 프로파일러 카운터 추가

> 프로파일러 카운터를 사용하여 특정 통계를 수집합니다.

프로파일러 카운터를 추가하려면 다음을 수행하는 스크립트를 생성합니다.

* [새 카운터를 만들고 정의합니다.](#creating-and-defining-a-counter)
* 카운터 값을 [업데이트합니다](#updating-a-counters-value).

이 섹션의 코드 예제는 프로파일러 카운터를 추가하여 Unity 게임 오브젝트의 트레일 효과의 모든 인스턴스에 대해 생성한 총 파티클 수를 추적합니다. 이 예제에서 게임 오브젝트의 이름은 "Tank"입니다.

## 필수 조건##prerequisites

일부 예제에서는 시작하기 전에 설치해야 하는 [Profiling Core 패키지](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest)를 사용합니다. Unity 프로파일링 코어 패키지는 코어 패키지이므로 패키지 관리자 UI에서 검색할 수 없습니다. 패키지를 설치하려면 [이름을 추가합니다](/engine/6000.0/manual/packages-list/managing-packages-window/upm-ui-actions/upm-ui-quick.md), 즉 `com.unity.profiling.core`.

## 카운터 생성 및 정의##creating-and-defining-a-counter

새 카운터를 생성하려면:

1. 새 카운터의 값 타입을 정의하는 스크립트를 작성합니다.
2. 이름과 유닛을 이 타입에 할당합니다.

> **Important:**
>
> 카운터를 생성할 때 새로운 카운터가 속한 프로파일러 카테고리를 지정해야 합니다. 이렇게 하려면 [`ProfilerCategory`](/engine/6000.0/script-reference/unity/profiling/profilercategory.md) 클래스의 기존 Unity 카테고리를 사용합니다. 다음 예제의 스크립트는 기존의 `ProfilerCategory.Scripts` 카테고리를 사용합니다.

프로파일러 카운터 API 푸시 및 풀 작업을 지원합니다. 카운터의 값을 프로파일러로 푸시하거나, 프로파일러는 프레임 마지막에 값을 가져올 수 있습니다.

데이터가 자주 변경되지 않는 경우(예: 프레임당 한 번), [`ProfilerCounter`](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest?subfolder=/api/Unity.Profiling.ProfilerCounter-1.html) API를 사용하여 카운터 데이터를 프로파일러로 푸시합니다. 프레임당 데이터가 여러 번 변경되면 `ProfilerCounterValue` API를 사용합니다. 이렇게 하면 프로파일러가 프레임이 끝날 때 마지막 값을 자동으로 가져옵니다.

다음 예제 스크립트는 이름이 `Tank Trail Particles`이고 단위가 [`ProfilerMarkerDataUnit.Count`](/engine/6000.0/script-reference/unity/profiling/profilermarkerdataunit/count.md)인 [`ProfilerCounterValue`](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest?subfolder=/api/Unity.Profiling.ProfilerCounter-1.html) `TankTrailParticleCount`를 정의합니다.

```lang-cs
public static class GameStats
{
   public static readonly ProfilerCategory TanksCategory = ProfilerCategory.Scripts;

   public const string TankTrailParticleCountName = "Tank Trail Particles";
   public static readonly ProfilerCounterValue<int> TankTrailParticleCount =
       new ProfilerCounterValue<int>(TanksCategory, TankTrailParticleCountName, ProfilerMarkerDataUnit.Count,
           ProfilerCounterOptions.FlushOnEndOfFrame | ProfilerCounterOptions.ResetToZeroOnFlush);
}
```

옵션 `FlushOnEndOfFrame` 및 `ResetToZeroOnFlush`는 카운터를 프로파일러 데이터 스트림으로 자동으로 보내 프레임이 끝날 때 Count 값을 0으로 초기화합니다.

## 카운터 값 업데이트##updating-a-counter's-value

카운터의 값을 업데이트하려면 정의한 카운터의 값을 설정하는 MonoBehaviour 스크립트를 생성합니다.

다음 MonoBehaviour 스크립트는 Update 함수의 프레임마다 할당된 게임 오브젝트에 속하는 트레일 파티클의 수를 계산합니다. 이를 위해서는 `TankTrailParticleCount` 카운터를 사용합니다.

다음 예제 스크립트는 인스펙터에서 트레일 파티클 시스템(`m_TrailParticleSystem`)이라는 공용 프로퍼티도 생성합니다.

```lang-cs
 using UnityEngine;

 TankMovement 클래스: MonoBehaviour
 {
    public ParticleSystem m_TrailParticleSystem;

    void Update()
    {
        GameStats.TankTrailParticleCount.Value += m_TrailParticleSystem.particleCount;
    }
 }
```

### 커스텀 프로파일러 모듈에 프로파일러 카운터 추가##adding-profiler-counters-to-a-custom-profiler-module

코드를 통해 커스텀 프로파일러 모듈에 프로파일러 카운터를 표시하려면 새 `ProfilerModule` 스크립트를 생성하고 표시되는 카운터, 카운터 이름, 아이콘을 포함한 모듈의 프로퍼티를 정의해야 합니다. 이를 수행하는 방법에 대한 자세한 내용은 [코드에서 프로파일러 모듈 생성](/engine/6000.0/manual/analysis/profiler/customizing/creating-custom-modules/create-modules.md)을 참조하십시오.

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

* [코드 소개에 프로파일링 정보 추가](/engine/6000.0/manual/analysis/profiler/customizing/adding-information-code/intro.md)
* [코드에 프로파일러 마커 추가](/engine/6000.0/manual/analysis/profiler/customizing/adding-information-code/add-markers-code.md)
* [프로파일러 모듈 사용자 정의](/engine/6000.0/manual/analysis/profiler/customizing.md)
* [코어 패키지 프로파일링](https://docs.unity3d.com/Packages/com.unity.profiling.core@latest)
