플레임 그래프

이 설명서 항목은 Grafana 버전 10.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.

Grafana 버전 9.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 9에서 작업하기

Grafana 버전 8.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 8에서 작업하기

플레임 그래프를 사용하면 프로파일링 데이터를 시각화할 수 있습니다. 이 시각화를 사용하면 프로파일을 플레임 그래프, 표 또는 둘 다로 표현할 수 있습니다.

플레임 그래프 모드

플레임 그래프는 프로파일링 데이터의 계층적 특성을 활용합니다. CPU 시간, 할당된 개체, 메모리 측정 시 공간 등 시스템 리소스를 가장 많이 소비하는 코드 경로를 쉽게 확인할 수 있는 형식으로 데이터를 압축합니다. 플레임 그래프의 각 블록은 스택에서의 함수 호출을 나타내며, 블록의 너비는 해당 값을 나타냅니다.

회색으로 표시된 섹션은 비교적 작은 값을 나타내는 함수 집합이며 성능상의 이유로 한 섹션으로 함께 축소됩니다.

특정 함수를 마우스로 가리키면 함수 값, 전체 값 대비 백분율, 해당 함수의 샘플 수 등 해당 함수에 대한 추가 데이터를 보여주는 도구 설명을 볼 수 있습니다.

드롭다운 액션

함수를 클릭하면 추가 작업이 포함된 드롭다운 메뉴를 표시할 수 있습니다.

• 포커스 블록 — 포커스 블록을 선택하면 블록 또는 함수가 플레임 그래프 너비의 100% 로 설정되고 상위 함수의 너비를 기준으로 업데이트된 너비로 모든 하위 함수가 표시됩니다. 이렇게 하면 플레임 그래프의 더 작은 부분을 더 쉽게 드릴다운할 수 있습니다.

• 함수 이름 복사 - 함수 이름 복사를 선택하면 블록이 나타내는 함수의 전체 이름이 복사됩니다.

• 샌드위치 뷰 — 샌드위치 뷰를 사용하면 클릭한 함수의 컨텍스트를 표시할 수 있습니다. 상단에는 모든 함수 호출자가 표시되고 하단에는 모든 피호출자가 표시됩니다. 이렇게 하면 함수의 집계된 컨텍스트가 표시되므로 함수가 플레임 그래프의 여러 위치에 있는 경우 모든 컨텍스트가 샌드위치 뷰에 표시되고 집계됩니다.

상태 표시줄

상태 표시줄에는 플레임 그래프에 대한 메타데이터와 현재 적용된 수정 사항 (예: 그래프의 어느 부분에 초점이 맞춰져 있는지, 샌드위치 뷰에서 어떤 기능이 표시되는지 등) 에 대한 메타데이터가 표시됩니다. 상태 표시줄 필의 X를 클릭하여 해당 수정 사항을 제거합니다.

도구 모음

검색

검색 필드를 사용하여 특정 이름의 함수를 찾을 수 있습니다. 불꽃 그래프에서 검색과 일치하는 모든 함수는 색상이 유지되고 나머지 함수는 회색으로 표시됩니다.

색상 스키마 피커

값 또는 패키지 이름을 기준으로 색상 지정 함수 사이를 전환하여 동일한 패키지의 함수를 시각적으로 연결할 수 있습니다.

텍스트 정렬

함수 이름이 블록에 맞지 않을 경우 텍스트를 왼쪽 또는 오른쪽으로 정렬하여 함수 이름의 중요한 부분을 더 많이 표시합니다.

시각화 피커

플레임 그래프만 표시하거나, 테이블만 표시하거나, 둘 다 동시에 표시하도록 선택할 수 있습니다.

탑 테이블 모드

상단 표에는 프로파일의 기능이 표 형식으로 표시됩니다. 테이블에는 기호, 자체, 합계 등 세 개의 열이 있습니다. 테이블은 기본적으로 자체 시간을 기준으로 정렬되지만 열 헤더를 클릭하여 총 시간 또는 기호 이름을 기준으로 재정렬할 수 있습니다. 함수가 프로필의 여러 위치에 나타나는 경우 각 행은 해당 함수의 집계된 값을 나타냅니다.

또한 각 행의 왼쪽에는 작업 버튼이 있습니다. 첫 번째 버튼은 함수 이름을 검색하고 두 번째 버튼은 함수의 샌드위치 보기를 표시합니다.

데이터 API

플레임 그래프를 렌더링하려면 중첩 집합 모델을 사용하여 데이터 프레임 데이터의 형식을 지정해야 합니다.

중첩 집합 모델을 사용하면 플레임 그래프의 각 항목이 정수 값으로서의 중첩 수준, 메타데이터 및 데이터 프레임에서의 순서만으로 인코딩됩니다. 즉, 항목 순서가 중요하고 정확해야 합니다. 순서는 플레임 그래프에 있는 항목을 깊이 우선 순회하는 것으로, 어린이 배열처럼 데이터 프레임에 가변 길이 값을 입력할 필요 없이 그래프를 다시 생성합니다.

필수 필드:

필드 이름	유형	설명
level	number	항목의 중첩 수준. 즉, 이 항목과 불꽃 그래프의 최상위 항목 사이에 있는 항목 수입니다.
값	number	항목의 절대값 또는 누적값. 이는 그래프에 있는 항목의 너비로 변환됩니다.
레이블	문자열	특정 항목에 대해 표시될 라벨입니다.
self	number	자기 가치는 일반적으로 항목의 누적 가치에서 직계 하위 항목의 누적 가치의 합계를 뺀 값입니다.