kona-node의 관측 가능성(observability)을 다룹니다.
로그 상세 수준 조정, 로그 대상 필터링, Prometheus 메트릭을 수집하여
Grafana 대시보드로 시각화하는 방법을 설명합니다.
로깅
kona-node는 로그의 “상세 수준(verbosity)“을 설정하는 방법으로
-v(또는 --v) 플래그를 제공합니다. 기본적으로 상세 수준은
INFO 수준인 3으로 설정됩니다. 수준은 로그가 없는 0부터
trace 로그를 포함하는 5까지입니다. 로그 수준은 아래와 같으며,
각 수준은 그 아래 수준을 포함합니다.
5:TRACE- 자세한 추적 정보를 제공하는 매우 상세한 로그4:DEBUG- 디버깅 정보를 출력하기 위한 로그3:INFO- 정보성 로그2:WARN- 경고 및 오류 로그 포함1:ERROR- 오류 로그만 표시0: 로그 없음
3 또는 INFO 수준인 -vvv입니다.
kona-node가 DEBUG 로그(수준 4)를 출력하도록 하려면
kona-node node -vvvv와 같이 노드를 실행하십시오.
로그 대상 필터링
기본적으로kona-node는 tracing_subscriber crate가 제공하는
기본 환경 변수 필터를 사용해 tracing(로깅)을 초기화합니다.
이 필터는 RUST_LOG 환경 변수의 값을 사용해 특정 대상의 tracing
수준을 설정합니다. 사실상 RUST_LOG를 사용하면 노드 전체 또는 특정
로그 대상에 대해 기본 로그 수준을 우회할 수 있습니다. 예를 들어
kona-node 명령 앞에 RUST_LOG=engine=debug를 붙이면(또는 이를
환경 변수로 설정하면), engine 로그 대상만 DEBUG 로그까지
출력되고 나머지는 INFO 로그만 표시됩니다.
이는 Kona의 P2P 스택을 디버깅하려는 경우 등에 유용합니다.
RUST_LOG=discv5=debug,libp2p=debug를 앞에 붙이면 discv5와
libp2p 대상의 디버그 로그만 볼 수 있습니다.
메트릭
kona-node는 Prometheus 메트릭을 제공할 수 있으며, 이는 기본적으로
비활성화되어 있습니다. 활성화하려면 --metrics.enabled CLI 플래그를 전달하십시오.
--metrics.port 플래그로 별도로 지정하지 않으면 메트릭은
포트 9090에서 노출됩니다.
메트릭 스냅샷을 확인하려면 0.0.0.0:9090에 접속하거나
해당 URL에 curl을 실행하십시오.
Grafana와 Prometheus
Prometheus는 미리 정의된 간격으로 메트릭을 수집(scrape)하는 간단한 서비스입니다. Grafana는 Prometheus를 “데이터 소스(Data Source)“로 사용하여 수집된 메트릭을 시각화합니다. Reth book은 Prometheus와 Grafana 설정에 대한 훌륭한 개요를 제공합니다. Reth 문서를 참조하여 따라 하십시오.kona-node에는 kona-node용 기본 Grafana 대시보드가 함께
제공됩니다. 대시보드를 Grafana로 가져오려면 + 아이콘 >
Import Dashboard를 클릭하고, kona의 대시보드 내용을
텍스트 상자에 붙여 넣은 후 Load를 클릭하십시오.