Tích hợp công cụ giám sát vào Web Framework

Trong các dự án sử dụng Gin framework, việc theo dõi các chỉ số về tài nguyên hệ thống giúp lập trình viên phát hiện sớm các vấn đề về rò rỉ bộ nhớ hoặc nghẽn cổ chai. Có hai cách tiếp cận phổ biến để tích hợp công cụ pprof.

Sử dụng thư viện gin-pprof

Cách nhanh nhất là sử dụng middleware ginpprof để tự động đăng ký các route cần thiết vào ứng dụng.

package main

import (
	"github.com/DeanThompson/ginpprof"
	"github.com/gin-gonic/gin"
)

func main() {
	app := gin.Default()

	// Kích hoạt pprof middleware
	ginpprof.Wrap(app)

	app.Run(":8080")
}

Sử dụng gói net/http/pprof tiêu chuẩn

Nếu bạn muốn sử dụng gói chuẩn của Go mà không cần thêm thư viện bên ngoài, hãy thực hiện import blank trong tệp main.go:

import _ "net/http/pprof"

Các chỉ số hiệu năng sẽ được cung cấp công khai tại địa chỉ 127.0.0.1:8080/debug/pprof/. Các endpoint quan trọng bao gồm:

• /debug/pprof/profile: Thu thập dữ liệu CPU trong khoảng 30 giây để phân tích các hàm tốn tài nguyên nhất.
• /debug/pprof/heap: Theo dõi việc phân bổ bộ nhớ trên vùng Heap, hữu ích khi tìm kiếm Memory Leak.
• /debug/pprof/goroutine: Thống kê số lượng và trạng thái của các Goroutine đang hoạt động.
• /debug/pprof/block: Ghi lại các sự kiện tắc nghẽn (blocking) của các tiến trình.
• /debug/pprof/mutex: Kiểm tra các xung đột và tranh chấp khóa giữa các luồng.

Theo dõi chi tiết Garbage Collection (GC)

Để phân tích sâu hơn về cách trình thu gom rác của Go hoạt động, bạn có thể sử dụng biến môi trường GODEBUG khi khởi chạy ứng dụng.

# Thiết lập biến môi trường và chạy ứng dụng
$env:GODEBUG="gctrace=1" 
go run main.go

Phân tích các thông số GC Trace

Khi ứng dụng chạy, hệ thống sẽ in ra các dòng log có định dạng tương tự như sau:

gc 4 @0.254s 5%: 2.0+1.0+9.9 ms clock, 16+0/2.0/2.0+79 ms cpu, 4->4->0 MB, 5 MB goal, 8 P

• gc 4: Số thứ tự của chu kỳ thu gom rác.
• @0.254s: Thời điểm bắt đầu GC tính từ khi khởi động ứng dụng.
• 5%: Tổng thời gian CPU dành cho GC kể từ khi chương trình bắt đầu.
• 2.0+1.0+9.9 ms clock: Thời gian thực thi các giai đoạn: Stop The World (STW) để bắt đầu đánh dấu + Concurrent Marking + STW kết thúc đánh dấu.
• 16+0/2.0/2.0+79 ms cpu: Thời gian CPU tiêu tốn, trong đó mutator assist cho thấy nỗ lực của luồng ứng dụng hỗ trợ GC.
• 4->4->0 MB: Dung lượng Heap tại thời điểm: Bắt đầu Mark -> Kết thúc Mark -> Sau khi thu gom.
• 5 MB goal: Mục tiêu dung lượng Heap sẽ kích hoạt lần GC tiếp theo.
• 8 P: Số lượng Processor (luồng logic) tham gia vào quá trình GC.

Theo dõi bộ nhớ cấp phát từ hệ thống (Scavenger)

Log scvg giúp bạn hiểu cách Go quản lý bộ nhớ ở cấp độ hệ điều hành:

scvg4: inuse: 111, idle: 54, sys: 187, released: 10, consumed: 177 (MB)

• inuse: Bộ nhớ đang thực sự chứa dữ liệu ứng dụng.
• idle: Bộ nhớ trống đã được GC thu hồi nhưng vẫn thuộc quyền quản lý của Runtime.
• sys: Tổng bộ nhớ mà Go đã yêu cầu từ hệ điều hành.
• released: Bộ nhớ đã được trả lại hoàn toàn cho hệ điều hành.
• consumed: Bộ nhớ thực tế mà hệ điều hành đang cấp cho tiến trình ứng dụng.