Giới thiệu về aiozipkin

aiozipkin là một thư viện mã nguồn mở hỗ trợ tích hợp khả năng theo dõi phân tán (distributed tracing) cho các ứng dụng sử dụng asyncio trong Python. Thư viện này tương thích với hệ thống Zipkin — một nền tảng thu thập và phân tích dữ liệu độ trễ trong kiến trúc vi dịch vụ. Yêu cầu tối thiểu là Python 3.6 trở lên.

Các vấn đề phổ biến và cách khắc phục

1. Khởi tạo aiozipkin đúng cách

Vấn đề: Người mới bắt đầu không biết cách thiết lập và khởi tạo bộ theo dõi.

Giải pháp:

1. Cài đặt thư viện qua pip:

   pip install aiozipkin

2. Khởi tạo tracer với endpoint và địa chỉ Zipkin:

   import asyncio
   import aiozipkin as az
   
   async def app_entry():
       zipkin_url = 'http://127.0.0.1:9411/api/v2/spans'
       service_endpoint = az.create_endpoint(
           service_name="my_async_service",
           ipv4="127.0.0.1",
           port=8080
       )
       trace_client = await az.create(zipkin_url, service_endpoint, sample_rate=1.0)
   
       async with trace_client.new_trace(sampled=True) as active_span:
           active_span.name("MainTask")
           # Thực thi logic nghiệp vụ tại đây
           await asyncio.sleep(0.1)
   
   asyncio.run(app_entry())

2. Thêm tracing vào hàm bất đồng bộ

Vấn đề: Không rõ cách chèn span theo dõi vào hàm async.

Giải pháp: Sử dụng context manager new_trace() hoặc truyền span hiện tại qua context. Ví dụ:

async def background_job(tracer_instance):
    async with tracer_instance.new_trace(sampled=True) as current_span:
        current_span.name("BackgroundJob")
        await asyncio.sleep(0.05)

Đảm bảo rằng tracer_instance đã được khởi tạo trước khi gọi hàm này.

3. Cấu hình tỷ lệ lấy mẫu (sampling rate)

Vấn đề: Muốn điều chỉnh mức độ ghi lại trace để cân bằng giữa hiệu năng và độ chi tiết.

Giải pháp: Thiết lập tham số sample_rate khi tạo tracer. Giá trị nằm trong khoảng [0.0, 1.0]:

trace_client = await az.create(
    zipkin_url,
    service_endpoint,
    sample_rate=0.25  # Ghi lại 25% các yêu cầu
)

Tỷ lệ 1.0 nghĩa là ghi lại mọi trace; 0.0 là tắt hoàn toàn.