기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 노드 그래프 패널
****
이 설명서 주제는 **Grafana 버전 9.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.
노드 그래프 패널은 방향 그래프 또는 네트워크를 시각화합니다. 방향을 지닌 하중 레이아웃을 사용하여 노드를 효과적으로 배치하므로 복잡한 인프라 맵, 계층 구조 또는 실행 다이어그램을 표시하는 데 도움이 될 수 있습니다.
## 데이터 요구 사항
노드 그래프 패널에는 노드와 엣지를 표시할 수 있는 데이터의 특정 형태가 필요합니다. 이 패널에서 모든 데이터 소스 또는 쿼리를 시각화할 수 있는 것은 아닙니다.
노드 그래프 시각화는 *노드* 및 *엣지*로 구성됩니다.
+ *노드*는 원으로 표시됩니다. 노드는 애플리케이션, 서비스 또는 애플리케이션 관점에서 관련된 모든 항목을 나타낼 수 있습니다.
+ *엣지*는 두 노드를 연결하는 선으로 표시됩니다. 연결은 요청, 작업 또는 두 노드 간의 기타 관계일 수 있습니다.
노드와 엣지 모두 연결된 메타데이터 또는 통계가 있을 수 있습니다. 데이터 소스는 표시되는 정보와 값을 정의하므로 데이터 소스가 다르면 서로 다른 유형의 값을 표시하거나 일부 값을 표시하지 않을 수 있습니다.
## Nodes(노드)
일반적으로 노드는 노드 내에 두 개의 통계 값과 노드 바로 아래에 두 개의 식별자(일반적으로 이름과 유형)를 표시합니다. 노드는 노드 주변의 색상 원으로 다른 값 세트를 표시할 수도 있습니다. 색상이 다른 섹션은 최대 1의 값을 더해야 하는 서로 다른 값을 나타냅니다. 예를 들어, 원의 빨간색 부분으로 오류 비율을 표시할 수 있습니다.
추가 세부 정보는 컨텍스트 메뉴에 표시될 수 있으며, 노드를 선택할 때 표시됩니다. 컨텍스트 메뉴에는 Grafana 워크스페이스의 다른 부분 또는 외부 링크를 대상으로 할 수 있는 추가 링크가 있을 수도 있습니다.
**참고**
노드 그래프에서는 1,500개의 노드만 표시할 수 있습니다. 이 한도를 초과하면 오른쪽 상단에 경고가 표시되고 일부 노드는 숨겨집니다. 그래프에서 **숨겨진 노드** 마커를 클릭하여 그래프의 숨겨진 부분을 확장할 수 있습니다.
## 엣지
엣지 위에 마우스를 가져가면 엣지에 통계가 표시될 수도 있습니다. 노드와 마찬가지로 엣지를 선택하여 추가 세부 정보 및 링크가 포함된 컨텍스트 메뉴를 열 수 있습니다.
이 시각화를 지원하는 첫 번째 데이터 소스는 서비스 맵 기능의 AWS X-Ray 데이터 소스입니다. 자세한 내용은 [AWS X-Ray 데이터 소스에 연결](x-ray-data-source.md) 단원을 참조하십시오.
## 노드 그래프 탐색
노드 또는 엣지 외부를 선택하고 포인터를 끌어 노드 그래프 내에서 이동할 수 있습니다.
노드 그래프의 왼쪽 상단에 있는 버튼을 사용해 확대/축소할 수 있습니다.
**숨겨진 노드**
지정된 시간에 표시되는 노드 수는 합리적인 성능을 유지하기 위해 제한됩니다. 이 제한을 벗어나는 노드는 클릭 가능한 마커 뒤에 숨겨집니다. 이 마커에서는 해당 엣지에 연결된 대략적인 숨겨진 노드 수를 보여줍니다. 마커를 선택하여 해당 노드 주변의 그래프를 확장할 수 있습니다.
**그리드 보기**
그리드 보기로 전환하여 그래프에서 가장 관심 있는 노드의 더 나은 개요를 제공할 수 있습니다. 그리드 보기에서는 엣지가 없는 그리드에서 노드를 표시하며 노드 내부에 표시된 통계 또는 노드의 색상 지정된 테두리로 표시된 통계를 기준으로 정렬할 수 있습니다.
노드를 정렬하려면 범례 내부의 통계를 선택합니다. 통계 이름 옆의 마커에서는 현재 정렬 및 정렬 방향에 사용되는 통계를 보여줍니다.
노드를 선택한 다음, **그래프 레이아웃에 표시** 옵션을 선택하여 선택한 노드에 초점을 맞춘 그래프 레이아웃으로 다시 전환해 전체 그래프의 컨텍스트로 표시합니다.
## 데이터 API
이 시각화를 올바르게 표시하려면 데이터 소스에서 반환할 데이터의 특정 형태가 필요합니다.
노드 그래프에는 최소한 그래프의 엣지를 설명하는 데이터 프레임이 필요합니다. 기본적으로 노드 그래프는 이 데이터 프레임을 기반으로 노드 및 모든 통계를 계산합니다. 선택적으로 노드를 설명하는 두 번째 데이터 프레임은 노드별 메타데이터를 더 많이 표시해야 하는 경우에 전송할 수 있습니다. 노드 그래프를 렌더링하려면 두 데이터 프레임에서 `frame.meta.preferredVisualisationType = 'nodeGraph'`를 설정하거나 각 이름을 `nodes` 및 `edges`으로 지정해야 합니다.
**구조에서 데이터 엣지**
필수 필드:
| 필드 이름 | Type | 설명 |
| --- | --- | --- |
| id | 문자열 | 엣지의 고유 식별자. |
| source | 문자열 | 소스 노드의 ID. |
| 대상 | 문자열 | 대상의 ID. |
선택적 필드:
| 필드 이름 | Type | 설명 |
| --- | --- | --- |
| 메인스탯 | 문자열/숫자 | 엣지 위로 마우스를 가져갈 때 오버레이에 표시된 첫 번째 통계. 값을 있는 그대로 표시하는 문자열이거나 숫자일 수 있습니다. 숫자인 경우 해당 필드와 연결된 모든 단위도 표시됩니다. |
| secondarystat | 문자열/숫자 | mainStat과 동일하지만 바로 아래에 표시됩니다. |
| detail\$1\$1\$1 | 문자열/숫자 | `detail__` 접두사를 사용하는 필드는 엣지를 클릭하면 컨텍스트 메뉴의 헤더에 표시됩니다. 레이블의 가독성을 더 개선하려면 `config.displayName`을 사용합니다. |
**구조의 노드 데이터**
필수 필드:
| 필드 이름 | Type | 설명 |
| --- | --- | --- |
| id | 문자열 | 노드의 고유한 식별자. 이 ID는 소스 및 대상 필드의 엣지에서 참조됩니다. |
선택적 필드:
| 필드 이름 | Type | 설명 |
| --- | --- | --- |
| 제목 | 문자열 | 노드 바로 아래에 표시되는 노드의 이름. |
| subtitle | 문자열 | 제목 아래에 표시된 추가, 이름, 유형 또는 기타 식별자. |
| 메인스탯 | 문자열/숫자 | 노드 자체 내에 표시된 첫 번째 통계. 값을 있는 그대로 표시하는 문자열 또는 숫자일 수 있습니다. 숫자인 경우 해당 필드와 연결된 모든 단위도 표시됩니다. |
| secondarystat | 문자열/숫자 | mainStat과 동일하지만 노드 내부 아래에 표시됩니다. |
| arc\$1\$1\$1 | number | `arc__` 접두사를 사용하는 모든 필드는 노드 주위에 색상이 지정된 원을 생성하는 데 사용됩니다. 이러한 필드의 모든 값은 최대 1이어야 합니다. `config.color.fixedColor`를 사용하여 색상을 지정할 수 있습니다. |
| detail\$1\$1\$1 | 문자열/숫자 | `detail__` 접두사를 사용하는 필드는 노드를 클릭하면 컨텍스트 메뉴의 헤더에 표시됩니다. 레이블의 가독성을 더 개선하려면 `config.displayName`을 사용합니다. |