Grafana v13.0의 새로운 기능
Grafana v13.0의 새로운 기능
Grafana 13.0에 오신 걸 환영해요! 이번 릴리스에서는 "깜빡이는 커서" 문제를 해결해서 팀이 그 어느 때보다 빨리 온보딩하고 데이터에서 인사이트를 얻도록 도와줘요. 데이터 소스와 번들된 대시보드나 커뮤니티 제공 대시보드를 쉽게 활용하고, 템플릿으로 더 빠르고 일관되게 만들고, 팀 간에 쿼리를 저장·공유하고, 추천 제안으로 패널 선택의 추측을 없앨 수 있어요.
차세대 대시보드 방식인 다이내믹 대시보드(Dynamic dashboards)가 일반 공개(GA)에 도달했어요. 유연성과 적응성이 커져 대시보드를 만드는 것이 즐거워지고, 팀이 단일 진실 원천을 통합·공유하도록 도와줘요. 또한 Git Sync도 일반 공개에 도달해 강력한 양방향 GitOps를 지원해서 Grafana 리소스를 대규모에서 안정적으로 관리하게 해줘요.
그게 전부가 아니에요. Grafana 13에는 새로운 Gauge 시각화, 새 데이터 소스, 개선된 주석 등 발견할 것이 훨씬 많아요. 계속 읽어 더 알아보고 직접 시도해 보세요!
이 릴리스의 모든 변경 사항에 대한 더 자세한 내용은 changelog를 참고하세요. v13.0으로 업그레이드할 때 권장하는 구체적인 단계는 Upgrade Guide를 확인하세요.
출처: 문서
본문
Grafana v13.0의 breaking changes
Grafana v13.0에는 더욱 자신 있게 업그레이드하도록 breaking changes 목록도 제공했어요.
Git Sync
Grafana 대시보드·폴더용 Git Sync 일반 공개
Grafana Cloud / 일반 공개 · Open Source / 일반 공개 · 대시보드와 시각화
Git Sync가 이제 모든 Grafana Cloud 및 자체 관리 Grafana 사용자에게 일반 공개됐어요.
Grafana 인스턴스를 GitHub, GitLab, Bitbucket 또는 어떤 Git 저장소에든 연결해 대시보드를 코드로 관리할 수 있어요. Grafana에서 대시보드를 직접 편집한 다음 UI를 벗어나지 않고 저장, 커밋, 풀 리퀘스트 열기가 가능해요.
대시보드와 시각화
다이내믹 대시보드 일반 공개
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 대시보드와 시각화
다이내믹 대시보드가 이제 모든 Grafana Cloud 사용자와 자체 관리 Grafana 인스턴스에서 기본으로 켜져 있어요. 모든 새・기존 대시보드가 새 레이아웃 엔진, 편집 경험, 대시보드 구조를 자동으로 사용해요. 기존 대시보드는 열 때 새 스키마로 마이그레이션돼요. 수동 단계가 필요 없어요.
Grafana Assistant로 대시보드 템플릿 커스터마이즈하기
Grafana Cloud / 공개 프리뷰 · Open Source / Enterprise / 공개 프리뷰 · 대시보드와 시각화
Grafana Assistant를 대시보드 템플릿에 통합해서, 이제 프로세스를 도와달라고 Assistant에게 요청할 수 있어요.
템플릿은 대시보드를 빠르게 만드는 강력한 방법이지만 실제 세계의 메트릭 이름이나 데이터 소스와 항상 일치하지는 않아요. Assistant가 그 격차를 메워줘요.
저장된 쿼리에서 템플릿 변수 대체하기
Grafana Cloud / 공개 프리뷰 · Enterprise / 공개 프리뷰 · 대시보드와 시각화
이제 저장된 쿼리를 선택할 때 원본 쿼리를 수정하지 않고 변수를 대체할 수 있어요.
이전에는 저장된 쿼리에 대시보드에 없는 변수가 있으면 Grafana가 호환성 경고를 표시하고 쿼리를 재사용 가능한 방식을 제한했어요. 이 업데이트로 경고 대신 변수(예: ${job})를 인라인으로 매핑해 업데이트할 수 있는 섹션이 생겼어요.
빠른 필터·그룹화로 더 빠른 대시보드 탐색
Grafana Cloud / 공개 프리뷰 · Open Source / Enterprise / 공개 프리뷰 · 대시보드와 시각화
대시보드 전체에 걸쳐 데이터를 드릴다운하는 것은 전통적으로 기본 필터 컨트롤을 다루고, 어제 썼던 같은 필터를 다시 입력하고, 필터가 많이 적용되면 어떤 것이 활성인지 잃어버리는 것을 의미했어요. 새 Filter and Group by 대시보드 컨트롤을 소개해 이런 마찰점을 모두 해결하고 대시보드 탐색을 더 빠르고 직관적으로 만듭니다.
삭제된 대시보드 복원 일반 공개
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 대시보드와 시각화
대시보드 복원 기능이 일반 공개됐어요! 피드백을 환영하니 여기서 공유할 수 있어요.
지원 티켓 없이도 삭제한 대시보드를 복원할 수 있어요. 새 Recently deleted 뷰 덕분에 실수로 대시보드를 지워도 작업을 잃거나 패널을 처음부터 다시 만들 필요가 없어졌어요.
개편된 gauge 시각화 일반 공개
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 대시보드와 시각화
2026년 1월에 개편된 gauge 시각화를 공개 프리뷰로 출시했어요. 이 새 경험이 이제 일반 공개됐어요. 변경 사항의 전체 설명은 공개 프리뷰 공지를 참고하세요.
Ad hoc 필터를 Filters로 이름 변경
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 대시보드와 시각화
Ad hoc filters 변수를 단순히 Filters로 이름을 바꿨어요. 다만 대시보드 스키마에서는 여전히 "kind": "AdhocVariable"로 불려요.
범례 한계로 성능·명확성 개선
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 대시보드와 시각화
수백·수천 개의 시리즈를 표시하는 패널은 범례를 렌더링할 때 성능 병목이 생길 수 있어요. 각 범례 항목은 페이지에 DOM 노드를 추가하는데, 시각화가 수천 개의 시리즈를 표시하면 누적될 수 있어요. 사용자가 범례에 적극적으로 상호작용하지 않으면 시각적으로도 산만할 수 있어요.
패널 스타일로 시각화 더 빠르게 구성하기
Grafana Cloud / 공개 프리뷰 · Open Source / Enterprise / 공개 프리뷰 · 대시보드와 시각화
이제 Panel styles를 적용해 여러 옵션을 수동으로 조정하지 않고 패널을 빠르게 업데이트할 수 있어요. 패널 스타일은 색상·임계값·표시 옵션 같은 큐레이션된 구성 집합을 제공해서, 한 번의 클릭으로 더 세련된 시각화에 빠르게 도달할 수 있어요. 패널 스타일은 현재 time series, gauge, bar gauge, stat, bar chart 시각화에서 지원돼요.
주석 개선 — 제어와 명확성
Grafana Cloud / 공개 프리뷰 · Open Source / Enterprise / 공개 프리뷰 · 대시보드와 시각화
주석을 대규모에서 더 쉽게 탐색·이동·관리하도록 여러 개선을 도입했어요.
주석 클러스터링
Annotation clustering 스위치로 인접한 포인트 주석을 단일 결합 영역으로 그룹화해요. 클러스터링된 주석은 내용을 하나의 스크롤 가능한 툴팁으로 모아서, 패널을 압도하지 않고 밀도 높은 주석 데이터를 탐색할 수 있어요.
패널 스타일 복사·붙여넣기
Grafana Cloud / 실험적 · Open Source / Enterprise / 실험적 · 대시보드와 시각화
Grafana에서 패널 스타일링은 예전에 수많은 수동 작업이 필요했어요. 각 패널을 개별 편집하거나, 하나를 복제해 그 모양을 재사용하고 쿼리를 바꾸는 식이었죠. 새 복사·붙여넣기 스타일 기능으로 한 패널의 스타일을 복사해 몇 번의 클릭만으로 다른 패널에 적용할 수 있어요.
행·탭용 섹션 레벨 변수로 대시보드 관리 단순화
Grafana Cloud / 공개 프리뷰 · Open Source / Enterprise / 공개 프리뷰 · 대시보드와 시각화
대시보드에 API 게이트웨이와 데이터베이스가 모두 있고 $instance 같은 변수를 바꾸면 모든 패널에 한 번에 영향이 가요. 이를 피하려면 서비스를 별도 대시보드로 나눠야 하는데, 통합 뷰라는 목표를 무너뜨리죠.
Grafana Assistant + 기능 개선으로 추천 대시보드 커스터마이즈하기
Grafana Cloud / 공개 프리뷰 · Open Source / Enterprise / 공개 프리뷰 · 대시보드와 시각화
이제 Grafana Assistant로 추천 대시보드를 직접 커스터마이즈해서, 환경에 맞춘 대시보드로 추천을 전환하기 쉬워졌어요.
데이터 소스에서 대시보드를 만들 때 추천 위에 커서를 올리면 Customize with Assistant 옵션이 보여요. 이것이 사전 구성된 프롬프트로 Grafana Assistant를 실행해서 선택한 대시보드를 적응시키는 과정을 안내해요.
저장된 쿼리·시각화 추천에서 즉시 패널 만들기
Grafana Cloud / 공개 프리뷰 · Enterprise / 공개 프리뷰 · 대시보드와 시각화
패널 구성 경험을 재설계해 저장된 쿼리를 사용하는 옵션을 포함시켰어요.
대시보드에 패널을 추가할 때 이제 세 가지 시작점이 있어요: 빈 패널, 라이브러리 패널, 저장된 쿼리. Use saved query를 선택해 Saved queries 대화 상자를 열고 쿼리를 고르면, Grafana가 추천 시각화를 포함한 바로 편집 가능한 패널을 생성해요. 패널 편집 모드에 들어가지 않고도 유용한 패널을 대시보드에 추가할 수 있죠.
저장된 쿼리: 새 인터페이스와 개선된 필터링 경험
Grafana Cloud / 공개 프리뷰 · Enterprise / 공개 프리뷰 · 대시보드와 시각화
저장된 쿼리 경험을 사용성 향상을 위해 업데이트했어요.
Saved queries 서랍이 대화 상자로 교체되어 쿼리 제목, 데이터 소스 이름, 기타 쿼리 세부 정보를 위한 공간이 늘었어요. 개별 쿼리 카드도 새로 디자인되어 가독성이 좋아졌어요.
업데이트된 시각화 추천 일반 공개
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 대시보드와 시각화
2026년 1월에 시각화 추천 개선을 공개 프리뷰로 발표했어요. 이 변경은 데이터 소스가 제공하는 정보를 활용한 더 높은 품질의 추천과 사소한 UI 업데이트를 포함했어요. 이 개선이 이제 일반 공개됐어요.
새 패널: Graphviz
Grafana Cloud / 비공개 프리뷰 · Open Source / Enterprise / 비공개 프리뷰 · 대시보드와 시각화
새 Graphviz 패널 플러그인으로 Graphviz DOT 언어로 대화형 다이어그램을 정의하고, 어떤 데이터 소스에서든 라이브 데이터를 매핑할 수 있어요.
개편된 쿼리 편집기 경험
Grafana Cloud / 비공개 프리뷰 · Open Source / Enterprise / 비공개 프리뷰 · 대시보드와 시각화
복잡한 패널을 더 쉽게 만들고 관리하도록 쿼리 편집기를 재설계했어요. 새 경험은 쿼리·식·변환·관련 알림 등 전체 데이터 파이프라인의 통합 뷰를 제공하고, 더 명확한 시각 피드백과 중요한 설정에 대한 더 빠른 접근을 제공해요.
AI
Grafana Assistant 온프렘 사용 가능
Grafana Cloud / 공개 프리뷰 · Open Source / Enterprise / 공개 프리뷰 · AI
오늘 Assistant 접근이 Grafana Enterprise와 Grafana OSS 사용자로 확장된다는 것을 발표해요. 이로써 Grafana Assistant가 자체 관리 환경에서도 텔레메트리 데이터와 코드를 실시간 분석하고, 대시보드를 만들고, 질문하는 데 사용할 수 있어요. 자체 관리 Grafana 사용자는 Grafana Cloud 계정을 만들어 원클릭 설정으로 Grafana 설치에 연결할 수 있어요.
Grafana Assistant의 SQL Expressions 지원
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 공개 프리뷰 · AI · 대시보드와 시각화
SQL Expressions를 사용하면 익숙한 SQL로 여러 쿼리 전반의 데이터를 결합·변환할 수 있어요. 결과 조인, 비율 계산, 집계 전 필터링이 가능하죠. 하지만 사용하려면 기능이 존재한다는 것을 알고, 쿼리 이름이 테이블 이름이 된다는 것을 배우고, MySQL 방언 구문을 스스로 맞춰야 했어요.
데이터 소스
DSL과 ES|QL로 탄력적으로 Elasticsearch 데이터 쿼리하기
Grafana Cloud / 실험적 · Open Source / Enterprise / 일반 공개 · 데이터 소스 · Explore
Elasticsearch의 시각적 쿼리 빌더를 넘어 새 raw 쿼리 편집기와 두 가지 쿼리 언어(Elasticsearch Query DSL, ES|QL)를 지원해요.
Grafana에서 IBM DB2 데이터 직접 탐색하기
Grafana Cloud / 공개 프리뷰 · Enterprise / 공개 프리뷰 · 데이터 소스
Grafana에서는 모든 데이터가 가시성을 받을 자격이 있다고 믿어요. 이것이 Big Tent 철학의 핵심이죠. 데이터가 클라우드 네이티브 시스템, 현대 SaaS 도구, IBM DB2 같은 오랜 엔터프라이즈 데이터베이스에서 오든, 한 곳에서 쉽게 탐색·시각화할 수 있어야 해요. 많은 조직에서 DB2가 가장 중요한 시스템 중 일부를 구동해요. 이제 그 데이터를 Grafana로 직접 가져와 나머지 텔레메트리와 나란히 볼 수 있어요.
플러그인
Grafana Advisor 일반 공개 — 순조롭게 유지하기 위한 인스턴스 헬스 체크
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 플러그인 · 데이터 소스 · 보안
Grafana Advisor가 Grafana v13.0에서 일반 공개됐어요.
Advisor로 Grafana 인스턴스의 상태에 영향을 주는 문제를 발견할 수 있어요. 예를 들면:
- 헬스 체크가 실패해 쿼리 실패를 초래할 데이터 소스
- 최신 수정·기능이 없어 보안에 취약할 수 있는 구식 플러그인
- 잘못 구성된 SSO 설정
검사는 기본적으로 주 1회 실행되고 Advisor 홈페이지에서 수동으로 트리거할 수 있어요. 새 문제가 생기면 알릴 알림도 구성할 수 있어요.
알림(Alerting)
알림 알림 앱 플랫폼 API에 provenance 지원 추가
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · 알림
알림 알림 리소스의 grafana.com/provenance 어노테이션이 이제 Kubernetes 스타일 API로 쓸 때 올바르게 읽히고 시행돼요. 이전에는 provenance가 모든 Kubernetes API 쓰기에 none으로 하드코딩되어 어노테이션이 조용히 무시됐어요. 이제 존중돼요. 설정하려면 다음 권한 중 하나가 필요해요.
기타
/api 경로 폐기
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개
Grafana가 App Platform을 구동하고 앞으로 더 일관되고 확장 가능한 기반을 주는 /apis API 계층으로 이동하고 있어요. Grafana 13과 함께 공식적으로 /api 경로를 폐기하고 새 /apis 경로를 채택해요. /api 폐기는 이 새 모델에 대한 commitment를 표시해요.
Pre-Scenes 아키텍처 기능 토글 제거
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개
Grafana v11에서 대시보드용 Scenes 기반 아키텍처를 활성화했지만 기능을 끌 수도 있었어요. 이 릴리스에서 Scenes를 비활성화하는 기능을 제거했어요.
Grafana 데이터베이스 메트릭 폐기
Open Source / Enterprise / 일반 공개
다음 Prometheus 메트릭이 Grafana v13에서 폐기되고 향후 릴리스에서 제거될 예정이에요:
go_sql_stats_connections_max_opengo_sql_stats_connections_opengo_sql_stats_connections_in_usego_sql_stats_connections_idlego_sql_stats_connections_waited_forgo_sql_stats_connections_blocked_secondsgo_sql_stats_connections_closed_max_idlego_sql_stats_connections_closed_max_lifetimego_sql_stats_connections_closed_max_idle_timegrafana_database_conn_max_opengrafana_database_conn_opengrafana_database_conn_in_usegrafana_database_conn_idlegrafana_database_conn_wait_count_totalgrafana_database_conn_wait_duration_secondsgrafana_database_conn_max_idle_closed_totalgrafana_database_conn_max_idle_closed_secondsgrafana_database_conn_max_lifetime_closed_total
이 메트릭들은 정확히 같은 데이터를 제공하는 다음 메트릭들로 대체돼요:
go_sql_max_open_connectionsgo_sql_open_connectionsgo_sql_in_use_connectionsgo_sql_idle_connectionsgo_sql_wait_count_totalgo_sql_wait_duration_seconds_totalgo_sql_max_idle_closed_totalgo_sql_max_idle_time_closed_totalgo_sql_max_lifetime_closed_total
breaking changes
다음은 Grafana를 업그레이드할 때 알아야 할 breaking changes예요.
여기서 breaking change란 사용자나 운영자가 뭔가를 해야 하는 모든 변경을 말해요. 다음을 포함해요:
- 시스템의 한 부분에서 다른 컴포넌트가 실패하게 할 수 있는 변경
- 기능의 폐기 또는 제거
- 자동화를 깨뜨릴 수 있는 API 변경
- 일부 플러그인이나 Grafana 기능에 영향을 주는 변경
- 롤백할 수 없는 마이그레이션
각 변경에 대해 제공되는 정보는:
- 영향받는지 판단을 도와줘요
- 변경 또는 관련 배경 정보를 설명해요
- 변경 완화 또는 마이그레이션 방법을 안내해요
- 더 많은 학습 리소스를 제공해요
감사: 데이터 소스 쿼리 감사 로그 설정의 기본값 변경
Enterprise / 일반 공개 · breaking change
Grafana 12.2.0에서 데이터 소스 쿼리의 감사 로그 생성을 제어하는 두 가지 새 설정(log_datasource_query_request_body, log_datasource_query_response_body)을 도입했어요. 각각 요청·응답 본문 페이로드를 로그해요.
쿼리 캐싱: 중복 메트릭 제거
Grafana Cloud / 일반 공개 · Enterprise / 일반 공개 · breaking change · 데이터 소스
Grafana v12에서 Query Caching 기능이 노출하는 중복 메트릭의 폐기를 발표했어요. Grafana v13에서 중복 메트릭 grafana_caching_items와 grafana_caching_size를 제거했어요.
폴더와 대시보드용 통합 스토리지
Open Source / Enterprise / 일반 공개 · 대시보드와 시각화 · breaking change · 경고
Git Sync 초기 채택자 주의: Grafana v13.0.0의 마이그레이션 버그로 Git Sync가 활성화된 상태에서 v12.x.x에서 업그레이드하면 대시보드와 폴더가 손실되거나 되돌아갈 수 있어요. v13.0.0에서 v13.0.1로의 업그레이드는 손실된 데이터를 복구하지 않으므로, 이미 업그레이드했다면 먼저 데이터베이스를 복원한 다음 v13.0.1로 업그레이드해야 해요.
Grafana Image Renderer 플러그인 지원 제거
breaking change · Reporting
2025년 9월 블로그 게시물에서 Grafana Image Renderer 플러그인이 이미 폐기됐다고 발표했어요. Grafana 13부터 플러그인 지원이 완전히 제거되고 스크린샷이나 예약 보고서 렌더링에 더 이상 동작하지 않아요.
렌더링: 기본 인증 모드가 JWT 사용으로 변경됨
Open Source / Enterprise / 일반 공개 · Reporting · breaking change
이전에는 Image Renderer가 스크린샷과 PDF를 생성하기 위해 패널과 대시보드로 이동할 때 Grafana 데이터베이스에 저장된 불투명 토큰으로 Grafana 인스턴스와 인증했어요.
@grafana/runtime의 config.apps와 config.panels 폐기·제거 타임라인
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · breaking change
@grafana/runtime 패키지의 config.apps와 config.panels 속성이 폐기되고 2026년 하반기로 예정된 Grafana 13.2.0에서 제거될 예정이에요.
grafana-cli와 grafana-server 명령 제거
Open Source / Enterprise / 일반 공개 · breaking change
grafana-cli와 grafana-server 명령은 grafana cli와 grafana server 명령을 위해 Grafana v10.0에서 폐기됐어요. 지금까지 두 명령 집합 모두 사용할 수 있었어요.
폐기된 데이터 소스 API 기본 비활성화
Open Source / Enterprise / 일반 공개 · 데이터 소스 · breaking change
숫자 id로 데이터 소스를 참조하던 데이터 소스 API는 대신 uid로 데이터 소스를 참조하는 API를 위해 Grafana v9.0에서 폐기됐어요. Grafana v13.0에서 이 폐기된 API는 기본으로 비활성화돼요.
HTTP 압축 kini 기본 활성화
Open Source / Enterprise / 일반 공개 · breaking change
이전에는 Grafana 구성 파일의 [server] 섹션에 있는 enable_gzip 구성 옵션(HTTP 압축 활성화)이 기본 비활성화되어 있었고 대부분의 사용자가 수동으로 활성화하길 권장했어요. Grafana v13.0부터 이 설정은 기본 활성화돼요.
Alertmanager 상태 엔드포인트에 새 권한 필요
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · breaking change · 알림
GET /api/alertmanager/grafana/api/v2/status 엔드포인트는 이전에 레거시 alert.notifications:read 권한을 요구했어요. 이제 전용 alert.notifications.system-status:read 권한을 요구해요. 이 새 권한은 기본적으로 Admin 사용자에게 부여되는 fixed:alerting.notifications:writer 역할에 포함돼요.
레거시 Alertmanager 구성 API 엔드포인트 변경
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · breaking change · 알림
Grafana v12.0에서 레거시 단일 테넌트 Alertmanager 구성 의미론에 의존하는 여러 Alertmanager 구성 API 엔드포인트를 폐기했어요. Grafana v13.0에서 이를 제거하거나 접근을 제한해요.
TwinMaker SceneViewer 패널 사용 불가
Grafana Cloud / 일반 공개 · Open Source / Enterprise / 일반 공개 · breaking change · 데이터 소스
Grafana v13.0이 코어 애플리케이션을 React 18에서 React 19로 업그레이드해요. IoT TwinMaker 앱(grafana-iot-twinmaker-app)의 SceneViewer 패널은 React 19에서 제거된 React API에 의존해서 업그레이드 후 렌더링에 실패해요.
@grafana/ui에서 폐기된 컴포넌트 제거
Open Source / Enterprise / 일반 공개 · breaking change
Grafana v13.0에서 2023년 이후 폐기된 @grafana/ui 패키지의 여러 컴포넌트를 제거해요:
GraphGraphWithLegendGraphContextMenuGraphContextMenuHeadergraphTimeFormatgraphTickFormatterGraphSeriesTogglerGraphSeriesTogglerAPI
또한 2026년 1월 이후 폐기된 컴포넌트 하나도 제거해요.
What's new: Grafana 13과 함께하는 RBAC 동작 변경
Grafana Cloud / 일반 공개 · Enterprise / 일반 공개 · breaking change
Grafana 13은 커스텀 역할, Terraform 관리 역할, 역할 프로비저닝에 대한 RBAC 시행을 강화해요. 대부분의 사용자는 영향받지 않아요. 커스텀 RBAC 역할, 특히 특정 UID로 한정된 데이터 소스 권한이 있는 역할이나 레거시 주석 스코프를 쓰는 역할을 유지한다면, 지금 역할 정의를 검토해 오류를 방지하세요.