메뉴 바에서 View > Tool Windows > App Inspection을 선택합니다.
Background Task Inspector 탭을 선택합니다.
실행 중인 앱 프로세스를 메뉴에서 선택합니다.
현재 실행 중인 앱의 작업자가 Background Task Inspector 창에 표시됩니다. 추가로 검사하려는 작업자를 클릭합니다.
작업자 확인 및 검사
API 수준 26 이상을 실행하는 기기에 WorkManager 2.5.0 이상을 사용하여 앱을 배포하면 Background Task Inspector 탭에 활성 작업자가 표시됩니다. Background Task Inspector는 실행 중이거나 실패했거나 완료된 모든 작업의 클래스 이름, 현재 상태, 시작 시간, 재시도를 나열합니다(이후 섹션의 그림 3에 나온 설명).
작업 세부정보
목록에서 작업을 클릭하여 그림 1과 같이 작업자에 관한 자세한 정보를 표시하는 Work Details 패널을 엽니다.
그림 1.작업 세부정보 패널
Description: 이 섹션에는 정규화된 패키지가 있는 작업자 클래스 이름과 할당된 태그, 작업자의 UUID가 나열됩니다.
Execution: 이 섹션에는 작업자의 제약 조건(있는 경우)과 실행 빈도, 상태, 작업자를 만들고 대기열에 추가한 클래스가 표시됩니다.
WorkContuniation: 이 섹션에는 작업자가 작업 체인에서 어디에 있는지 표시됩니다. 작업 체인에 있는 다른 작업자의 세부정보를 확인하려면 UUID를 클릭하세요.
Results: 이 섹션에는 선택한 작업자의 시작 시간과 재시도 횟수, 출력 데이터가 표시됩니다.
작업자 취소
현재 실행 중이거나 대기열에 추가된 작업자를 중지하려면 작업자를 선택하고 툴바에서 Cancel Selected Worker를 클릭합니다.
그래프 뷰 보기
작업자는 함께 체인될 수 있으므로 작업자 종속 항목을 그래프로 시각화하는 것이 유용할 수도 있습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Debug your WorkManager workers with Background Task Inspector\n\nThe Background Task Inspector helps\nyou visualize, monitor, and debug your app's background workers when using\n[WorkManager library](/jetpack/androidx/releases/work) 2.5.0 or higher.\n\nGet started\n-----------\n\nTo list workers in the Background Task Inspector, do the following:\n\n1. [Run your app](/studio/run) on an emulator or connected device running API\n level 26 or higher.\n\n2. Select **View \\\u003e Tool Windows \\\u003e App Inspection** from the menu bar.\n\n3. Select the **Background Task Inspector** tab.\n\n4. Select the running app process from the menu.\n\n5. The workers in the currently running app appear in the **Background Task\n Inspector** pane. Click on the worker that you want to inspect further.\n\nView and inspect workers\n------------------------\n\nWhen you deploy an app using WorkManager 2.5.0 or higher on a device running\nAPI level 26 or higher, the **Background Task Inspector** tab shows active\nworkers. The **Background Task Inspector** (shown in a\n[later section](/studio/inspect/task#inspect-jobs-alarms-wakelocks) as figure 3)\nlists the class name, current status, start time, and retries of all jobs,\nwhether they are running, failed, or completed.\n\n### Work Details\n\nClick a job from the list to open the **Work Details** panel,\nwhich displays detailed information about the worker, as shown in figure 1.\n**Figure 1.** **Work Details** panel.\n\n- **Description**: This section lists the worker class name, with the fully qualified package, as well as the assigned tag and the UUID of the worker.\n- **Execution**: This section shows the worker's constraints (if any), running frequency, and state, as well as which class created and queued the worker.\n- **WorkContinuation**: This section displays where the worker is in the work chain. To check the details of another worker in the work chain, click its UUID.\n- **Results**: This section displays the start time, retry count, and the output data of the selected worker.\n\n### Cancel workers\n\nTo stop a currently running or enqueued worker, select the worker and click\n**Cancel Selected Worker**\nfrom the toolbar.\n\n### View Graph View\n\nBecause workers can be chained together, it's sometimes useful to visualize\nworker dependencies as a graph.\n\nTo see a visual representation of a worker\nchain, select a worker from the table and click **Show Graph View** from the toolbar. Only workers are drawn in the graph.\n**Figure 2.** Graph View.\n\nThe graph lets you quickly see relationships between workers and monitor\ntheir progress in complex chaining relationships.\n\nTo return to the list view, click **Show List View** .\n\nView and inspect Jobs, Alarms, and Wakelocks\n--------------------------------------------\n\nThe Background Task Inspector also lets you inspect your app's Jobs, Alarms,\nand Wakelocks. Each type of asynchronous task appears under the appropriate\nheading in the inspector tab, letting you easily monitor its status and\nprogress.\n\nSimilar to workers, you can select a Job, Alarm, or Wakelock to\ninspect its detailed information in the Task Details panel.\n\nTo view detailed information for a Worker, Job, Alarm, or Wakelock,\nselect it in the **Task Details** panel on the right.\n**Figure 3.** The Background Task Inspector window. **Note:** This functionality has been migrated from the **Energy profiler** . Use the **Background Task Inspector** to inspect all of your app's asynchronous tasks.\n\nAdditional resources\n--------------------\n\nTo learn more about the Background Task Inspector, see the following additional\nresources:\n\n### Documentation\n\n- [Schedule tasks with WorkManager](/topic/libraries/architecture/workmanager)\n\n### Codelabs\n\n- [Background work with WorkManager](https://developer.android.com/codelabs/android-workmanager)\n- [Advanced WorkManager](https://developer.android.com/codelabs/android-adv-workmanager)\n\n### Blog posts\n\n- [Background Task Inspector](https://medium.com/androiddevelopers/background-task-inspector-30c8706f0380)"]]