OpenObserve: giám sát log, metric, trace gọn trong một file — hướng dẫn cài đặt và dùng

Tóm tắt nhanh
OpenObserve là nền tảng quan sát (observability) mã nguồn mở viết bằng Rust, gom log, metric, trace, giám sát người dùng thật (RUM) và theo dõi ứng dụng AI vào một giao diện web. Bạn dùng nó để xem hệ thống đang chạy thế nào, tìm lỗi và đặt cảnh báo, thay cho Datadog, Splunk hay Elasticsearch. Cài thử khá dễ: README có sẵn một lệnh Docker, chạy xong mở trình duyệt là dùng được.
OpenObserve (viết tắt O2) là một nền tảng quan sát mã nguồn mở: nó nhận log, metric, trace và dữ liệu giám sát phía người dùng, rồi cho bạn tìm kiếm, vẽ biểu đồ và đặt cảnh báo trên cùng một giao diện web. Tác giả định vị nó là lựa chọn thay thế cho Datadog, Splunk và Elasticsearch, với lời hứa chi phí lưu trữ thấp hơn tới 140 lần và chỉ cần một file chạy duy nhất.
Nếu bạn là dev, người vận hành hệ thống, hoặc chủ một sản phẩm phần mềm nhỏ đang đau đầu vì hóa đơn công cụ giám sát, repo này đáng để thử. Repo hiện có khoảng 23.046 sao và 1.199 fork, được cập nhật trong 3 tháng gần đây, nên khá "sống".
Điểm đáng giá nhất là sự gọn gàng. Thay vì ghép Grafana, Loki, Prometheus và Tempo, bạn chạy một dịch vụ duy nhất. Với người mới, README có sẵn đúng một lệnh Docker để chạy thử ngay trên máy.
openobserve/openobserve
OpenObserve là nền tảng quan sát mã nguồn mở gom log, metric, trace, RUM vào một chỗ, thay thế Datadog, Splunk, Elasticsearch, chạy được chỉ bằng một lệnh Docker.
I.OpenObserve làm được gì
Dưới đây là các tính năng chính theo README, kèm lợi ích thực tế.
- Log tập trung. Tìm kiếm toàn văn, truy vấn bằng SQL, bộ lọc nhanh và công cụ dựng truy vấn bằng giao diện. Bạn không cần học cú pháp riêng, ai biết SQL cơ bản là dùng được.
- Truy vết phân tán (trace). Dựa trên OpenTelemetry, giúp bạn theo dõi một yêu cầu đi qua nhiều dịch vụ và thấy chỗ nào chậm. Có biểu đồ waterfall, flame graph, Gantt; bấm vào từng span để xem chi tiết.
- Service Graph. Vẽ sơ đồ các dịch vụ gọi nhau, hiển thị số request và tình trạng (khỏe, suy giảm, cảnh báo, nghiêm trọng) bằng màu. Nhìn một lần là biết "điểm nóng" nằm đâu.
- Metric. Truy vấn bằng SQL hoặc PromQL, kết hợp nhiều truy vấn bằng công thức, hiển thị bằng hơn 19 loại biểu đồ.
- Dashboard. Dựng bảng điều khiển từ bất kỳ loại dữ liệu nào bằng kéo thả, có biến mẫu và bản đồ địa lý.
- Frontend Monitoring (RUM). Đo Core Web Vitals, theo dõi lỗi, hiệu năng và xem lại phiên người dùng (session replay) để biết khách thật đang gặp gì.
- Cảnh báo và sự cố. Đặt ngưỡng cho log, metric, trace; cảnh báo theo lịch hoặc thời gian thực; gom các cảnh báo liên quan thành sự cố và theo dõi trạng thái mở, đã xác nhận, đã xử lý.
- Pipeline. Làm giàu, che giấu (redact), giảm hoặc chuẩn hóa dữ liệu ngay lúc nhận vào, bằng trình soạn thảo trực quan, kể cả chuyển log thành metric.
- Quan sát AI/LLM. Theo dõi chi phí, số token, độ trễ và tỷ lệ lỗi của ứng dụng dùng mô hình ngôn ngữ.
- Trợ lý O2 AI. Biến câu hỏi tiếng tự nhiên thành truy vấn SQL, VRL, PromQL, dashboard và cảnh báo.
Về kiến trúc, README nói OpenObserve dùng lưu trữ cột Parquet và thiết kế xoay quanh S3, viết bằng Rust, có phân vùng, đánh chỉ mục và bộ nhớ đệm. Kết quả: ít tốn dung lượng, ít tốn phần cứng. Nó cũng hỗ trợ nhiều tổ chức (multi-tenancy) với dữ liệu tách biệt hoàn toàn.
II.Cần chuẩn bị gì
Tư liệu README chỉ nêu cách chạy thử bằng Docker, nên phần chuẩn bị tối thiểu là:
- Một máy đã cài Docker (README chưa nói phiên bản cụ thể).
- Một thư mục để chứa dữ liệu, vì lệnh mẫu gắn thư mục
datavào bên trong container. - Cổng 5080 trên máy còn trống.
- Một email và một mật khẩu tự đặt cho tài khoản quản trị gốc.
README không nêu yêu cầu cụ thể về hệ điều hành, RAM hay GPU. Chỉ có câu chung chung là nó cần khoảng một phần tư phần cứng so với Elasticsearch. Bạn không cần API key nào để chạy bản tự cài. Nếu không muốn cài gì, README có nhắc OpenObserve Cloud với gói miễn phí tới 50 GB dữ liệu mỗi ngày.
Trong repo có file .env.example liệt kê các biến cấu hình như ZO_ROOT_USER_EMAIL, ZO_ROOT_USER_PASSWORD, ZO_LOCAL_MODE, ZO_S3_BUCKET_NAME, RUST_LOG. Hai biến đầu chính là email và mật khẩu bạn truyền vào lệnh Docker bên dưới.
III.Cài đặt từng bước
- Cài DockerChuẩn bị Docker trên máy của bạn
- Mở terminalVào thư mục bạn muốn lưu dữ liệu
- Chạy containerDán lệnh docker run trong README
- Mở trình duyệtVào localhost:5080
- Đăng nhậpDùng email và mật khẩu bạn đã đặt
A.Cài Docker
README chưa hướng dẫn cài Docker, bạn cần tự cài theo trang chủ của Docker cho hệ điều hành của mình. Cài xong, hãy chắc là Docker đang chạy (trên Windows và macOS là mở ứng dụng Docker Desktop) trước khi sang bước sau.
B.Mở terminal đúng chỗ
Mở terminal (hoặc Git Bash trên Windows) rồi cd vào thư mục bạn muốn dùng. Lệnh mẫu tạo thư mục data ngay tại thư mục hiện tại để lưu dữ liệu, nên chỗ bạn đứng chính là chỗ dữ liệu sẽ nằm.
Lưu ý: lệnh của README dùng $PWD và dấu \ xuống dòng theo kiểu bash. Trên Windows, hãy dùng Git Bash hoặc WSL cho chắc. Nếu dùng PowerShell, cú pháp xuống dòng và biến thư mục hiện tại khác, README chưa ghi bản PowerShell.
C.Chạy container
Chép đúng lệnh trong README, đổi email và mật khẩu theo ý bạn:
docker run -d \
--name openobserve \
-v $PWD/data:/data \
-p 5080:5080 \
-e ZO_ROOT_USER_EMAIL="root@example.com" \
-e ZO_ROOT_USER_PASSWORD="Complexpass#123" \
public.ecr.aws/zinclabs/openobserve:latestÝ nghĩa từng dòng:
-dchạy nền, terminal không bị chiếm.--name openobserveđặt tên container để sau này dễ gọi.-v $PWD/data:/datalưu dữ liệu ra thư mụcdatatrên máy bạn, tắt container dữ liệu vẫn còn.-p 5080:5080mở cổng 5080 để bạn vào giao diện web.- Hai dòng
-elà email và mật khẩu đăng nhập quản trị. - Dòng cuối là ảnh Docker của OpenObserve.
Đừng giữ nguyên email và mật khẩu mẫu trong README nếu bạn mở máy chủ ra internet. Hãy đặt mật khẩu riêng, đủ mạnh, và đừng đăng lệnh có mật khẩu thật lên chỗ công khai.
D.Mở trình duyệt và đăng nhập
Vào địa chỉ http://localhost:5080 rồi đăng nhập bằng đúng email và mật khẩu bạn đã đặt trong lệnh. Vậy là xong phần cài.
Các cách cài khác và cách dựng cụm nhiều máy (High Availability) nằm trong tài liệu quickstart và hướng dẫn HA trên trang openobserve.ai/docs. README chưa tóm tắt chúng, bạn vào đó xem khi cần.
IV.Kiểm tra đã chạy được chưa
Theo README, chỉ cần mở http://localhost:5080 và đăng nhập được bằng thông tin đã đặt là thành công. Bạn sẽ thấy giao diện web với các mục như log, trace, metric, dashboard, cảnh báo.
Nếu trang không hiện, thử hai lệnh Docker phổ thông này:
docker ps
docker logs openobservedocker ps cho biết container có đang chạy không. docker logs openobserve in ra nhật ký khởi động để bạn đọc lỗi.
Một điều cần biết: máy mới cài sẽ chưa có dữ liệu. Muốn thấy log hay trace, bạn phải gửi dữ liệu từ ứng dụng vào. README không ghi từng bước gửi dữ liệu, chỉ nói OpenObserve hỗ trợ chuẩn OpenTelemetry (OTLP). Cách gửi cụ thể bạn xem ở tài liệu trên openobserve.ai/docs.
V.Dùng vào việc thật
A.Dev tìm lỗi trong log của ứng dụng
Bạn làm backend cho một app nhỏ, khách báo "hôm qua hệ thống chập chờn". Sau khi cấu hình ứng dụng gửi log vào OpenObserve, bạn vào mục Logs, chọn khoảng thời gian, rồi tìm bằng từ khóa hoặc bằng SQL. Bạn có thể lọc theo mức lỗi, đếm số lỗi theo giờ để xem chập chờn bắt đầu từ lúc nào. Nếu chưa rành SQL, nhờ trợ lý O2 AI chuyển câu hỏi tiếng tự nhiên thành truy vấn. Kết quả: bạn khoanh được khung giờ và loại lỗi thay vì lục từng file log.
Công cụ giám sát tốt nhất là cái bạn thật sự mở ra xem mỗi ngày, và chi phí thấp giúp bạn dám bật nó cho mọi thứ.
Ông T
B.Chủ sản phẩm theo dõi trải nghiệm khách thật
Bạn có một website bán hàng và muốn biết vì sao khách bỏ giỏ. Bật Frontend Monitoring (RUM), bạn xem được Core Web Vitals, các lỗi phía trình duyệt và xem lại phiên của người dùng. Bạn thấy chỗ trang tải chậm hoặc nút bấm không phản hồi, rồi đưa đúng thông tin đó cho dev sửa. Cách bật RUM cụ thể README chưa ghi, xem trong tài liệu liên kết ở mục Frontend Monitoring.
C.Đội vận hành đặt cảnh báo và dựng dashboard
Bạn phụ trách vài dịch vụ chạy cùng lúc. Vào mục Dashboards, kéo thả dựng bảng có biểu đồ lỗi, độ trễ, lượng request. Sang mục Alerts, đặt ngưỡng (ví dụ lỗi vượt mức nào đó thì báo) và chọn kênh nhận thông báo. Các cảnh báo liên quan sẽ được gom thành một sự cố để bạn theo dõi từ lúc mở đến lúc xử lý xong. Kết quả là sáng ra bạn chỉ cần nhìn một màn hình thay vì mở nhiều công cụ.
D.Nhóm làm sản phẩm AI theo dõi chi phí mô hình
Bạn đang chạy một chatbot dùng mô hình ngôn ngữ và muốn biết tiền đi đâu. Phần AI Observability cho xem chi phí, số token, độ trễ theo phân vị và tỷ lệ lỗi theo từng mô hình, kèm đồ thị agent và trace theo phiên. Nhờ đó bạn biết mô hình hoặc bước nào đắt và chậm nhất để tối ưu.
VI.Lỗi hay gặp và cách xử lý
A.Docker báo cổng 5080 đã bị chiếm
Có chương trình khác đang dùng cổng này, hoặc bạn đã chạy container cũ. Hãy chạy docker ps để xem. Nếu container cũ tên openobserve còn đó, dừng nó bằng docker stop openobserve rồi xóa bằng docker rm openobserve trước khi chạy lại (dữ liệu vẫn nằm trong thư mục data bạn đã gắn).
B.Lệnh chạy không được trên Windows PowerShell
Lệnh mẫu viết theo kiểu bash. Hãy chạy trong Git Bash hoặc WSL, hoặc tự đổi $PWD và ký tự xuống dòng cho đúng PowerShell, hoặc gộp lệnh thành một dòng. README chưa có bản PowerShell nên bạn cần cẩn thận khi tự chuyển.
C.Không đăng nhập được
Hãy dùng đúng email và mật khẩu đã truyền trong hai dòng -e. Nếu bạn đã chạy trước đó với thông tin khác trong cùng thư mục data, tài khoản cũ có thể vẫn còn. Cách an toàn là dùng một thư mục data mới cho lần thử lại, hoặc kiểm tra docker logs openobserve.
D.Vào được giao diện nhưng không có gì để xem
Đây là bình thường: OpenObserve chỉ hiển thị dữ liệu bạn gửi vào. Bạn cần cấu hình ứng dụng hoặc bộ thu thập (theo chuẩn OpenTelemetry) gửi dữ liệu tới. Xem tài liệu nhập dữ liệu trên openobserve.ai/docs.
E.Muốn xóa hoặc sửa một dòng log đã nhận
README nói rõ dữ liệu trong OpenObserve là bất biến: nhận vào rồi không sửa được, cũng không xóa từng dòng, chỉ xóa được cả khoảng thời gian lưu giữ. Vì vậy hãy dùng pipeline để che hoặc lọc dữ liệu nhạy cảm ngay lúc nhận vào, đừng gửi mật khẩu hay dữ liệu cá nhân vào rồi mới nghĩ cách xóa.
VII.Có nên dùng không
Điểm mạnh. Cài thử rất nhanh bằng một lệnh Docker. Gom log, metric, trace, RUM, dashboard, cảnh báo vào một nơi. Dùng SQL và PromQL nên không phải học ngôn ngữ truy vấn riêng. Hỗ trợ OpenTelemetry nên ít bị khóa vào một nhà cung cấp. Bản mã nguồn mở được README mô tả là đầy đủ tính năng và dùng thương mại được.
Giới hạn cần biết.
- Giấy phép là AGPL-3.0. Dùng nội bộ thì thoải mái, còn nếu bạn định sửa code rồi cung cấp thành dịch vụ cho người khác, hãy đọc kỹ giấy phép.
- Dữ liệu bất biến, không sửa hay xóa từng dòng được.
- Một số tính năng chỉ có ở bản Enterprise: đăng nhập một lần (SSO), phân quyền nâng cao, nhật ký kiểm toán, tìm kiếm liên cụm, che dữ liệu nhạy cảm tự động.
- Các con số như "rẻ hơn 140 lần" hay "cần một phần tư phần cứng" là do tác giả công bố. Hãy tự thử với dữ liệu của bạn trước khi tin hoàn toàn.
- Chạy thật cho môi trường quan trọng cần bạn tự lo sao lưu, bảo mật và mở rộng, README chỉ nói sơ và dẫn sang tài liệu.
Khi nào chọn cách khác. Nếu đội bạn không có ai quản trị máy chủ và chỉ cần dùng ngay, bản Cloud (có gói miễn phí tới 50 GB mỗi ngày theo README) sẽ đỡ việc hơn. Nếu bạn đã quen và hài lòng với một bộ công cụ đang chạy ổn, chưa chắc cần đổi. Còn nếu bạn muốn một chỗ duy nhất để xem mọi tín hiệu với chi phí thấp, OpenObserve là ứng viên rất đáng thử trước.
Câu hỏi thường gặp
OpenObserve có miễn phí không?
Bản mã nguồn mở theo giấy phép AGPL-3.0, README nói là miễn phí và dùng thương mại được. Bản Cloud có gói miễn phí tới 50 GB dữ liệu mỗi ngày. Bản Enterprise có thêm tính năng và hỗ trợ, tính theo thỏa thuận riêng.
Cài OpenObserve có cần GPU không?
README không nhắc tới GPU. Nó chỉ nói OpenObserve dùng khoảng một phần tư phần cứng so với Elasticsearch. Cấu hình tối thiểu cụ thể (RAM, CPU) thì tư liệu chưa ghi.
Chạy được trên Windows không?
README hướng dẫn chạy bằng Docker nên về nguyên tắc bạn cần Docker chạy được trên Windows. Lệnh mẫu viết theo kiểu bash, nên trên Windows hãy dùng Git Bash hoặc WSL. README chưa có bản lệnh riêng cho PowerShell.
Dữ liệu của tôi có an toàn không?
Khi tự cài, dữ liệu nằm trên máy của bạn, trong thư mục gắn vào container. README nói có mã hóa dữ liệu lúc lưu và lúc truyền, và đạt các chứng nhận như SOC 2 Type II, ISO 27001. Tính năng che dữ liệu nhạy cảm tự động và SSO thuộc bản Enterprise.
OpenObserve khác gì Elasticsearch hay Datadog?
Theo README, so với Elasticsearch thì nó dùng SQL, cài chỉ một file chạy, không cần tinh chỉnh shard hay heap, và tốn lưu trữ ít hơn. So với Datadog thì nó mã nguồn mở, tự cài được, dùng SQL và PromQL thay vì ngôn ngữ riêng. Đây là so sánh do tác giả đưa ra.
Gửi dữ liệu vào OpenObserve bằng cách nào?
README nói OpenObserve hỗ trợ OpenTelemetry (OTLP) nhưng không ghi từng bước gửi dữ liệu. Bạn xem hướng dẫn nhập dữ liệu trong tài liệu tại openobserve.ai/docs.
Có sửa hoặc xóa log đã nhận được không?
Không xóa hay sửa từng dòng được. README nói dữ liệu là bất biến theo thiết kế, chỉ xóa được cả khoảng thời gian lưu giữ. Điều này giúp đảm bảo toàn vẹn dữ liệu cho mục đích kiểm toán.


