Lỗi Sentry thành Vấn đề GitHub

Okou là một tác nhân DevOps AI tự động phân loại lỗi hàng ngày. Mỗi sáng, nó kéo các lỗi chưa được giải quyết từ Sentry và Axiom, loại bỏ trùng lặp giữa cả hai nguồn và tạo các vấn đề GitHub được chỉ định với đầy đủ dấu vết ngăn xếp trước khi họp đứng, giúp các kỹ sư tiết kiệm 20 đến 30 phút xem xét thủ công.

Okou kết nối:SentryAxiomGitHub

Những gì Okou cung cấp: một báo cáo phân loại lỗi hàng ngày

Khám phá một báo cáo phân loại lỗi mẫu do AI tạo ra với các sự cố được ưu tiên, loại bỏ trùng lặp giữa các nguồn, các vấn đề GitHub được gán, mức độ nghiêm trọng, khối lượng và thời gian tiết kiệm. Dữ liệu chỉ mang tính minh họa; định dạng báo cáo là một đầu ra thực tế mà Okou có thể tạo ra từ Sentry và Axiom.

Okou · Báo cáo tự động hóaDữ liệu mẫu

Tóm tắt tác nhân

Okou đã kiểm tra 17 lỗi thô từ Sentry và Axiom, loại bỏ trùng lặp thành 13 nguyên nhân gốc, tạo 6 vấn đề GitHub được chỉ định và định tuyến 2 tín hiệu chỉ xem đến #dev.

Đã kiểm tra lỗi thô
1712 Sentry · 5 Axiom
Nguyên nhân gốc rễ duy nhất
13sau khi loại bỏ trùng lặp
Các vấn đề GitHub đã tạo
6tất cả đã được giao
Mở báo cáo phân loại lỗi hàng ngày đầy đủ

Phân loại lỗi là gì?

Phân loại lỗi, còn được gọi là phân loại lỗi hoặc phân loại sự cố, là quá trình nhóm, ưu tiên và gán các lỗi sản xuất để các kỹ sư biết phải sửa gì trước. Okou hoạt động như một tác nhân SRE AI trên Sentry, Axiom và GitHub: nó loại bỏ các lỗi trùng lặp, áp dụng ngưỡng, đính kèm dấu vết ngăn xếp và gán chủ sở hữu mã. Kết quả là một quy trình tự động phân loại lỗi hàng ngày nhất quán với ít sự mệt mỏi do cảnh báo hơn.

Tại sao việc phân loại lỗi thủ công gây ra sự mệt mỏi do cảnh báo

Mỗi sáng, một kỹ sư phải mở Sentry, quét các cảnh báo Sentry chưa được giải quyết, kiểm tra chéo Axiom, xác định cái nào mới hoặc trùng lặp, quyết định cái nào nghiêm trọng, mở các vấn đề GitHub và tìm đúng chủ sở hữu. Bước đầu tiên lặp đi lặp lại đó tốn 20 đến 30 phút thời gian kỹ thuật tập trung và tạo ra sự mệt mỏi do cảnh báo trước khi công việc thực sự bắt đầu. Okou chạy lúc 8:45 sáng và hoàn thành việc phân loại tương tự trước khi bất kỳ ai mở máy tính xách tay.

Cách Okou tự động hóa việc phân loại lỗi hàng ngày

Bước 1: Kết nối các công cụ của bạn

Sentry
Sentry
Bắt buộc
Tích hợp Sentry của Okou truy vấn các lỗi sản xuất chưa được giải quyết, dấu vết ngăn xếp, số lượng sự kiện và thẻ môi trường.
Kết nối
GitHub
GitHub
Bắt buộc
Tích hợp Sentry GitHub tạo các vấn đề có cấu trúc với đầy đủ chi tiết lỗi và gán chúng cho chủ sở hữu mã.
Kết nối
Axiom
Axiom
Tùy chọn
Okou truy vấn Axiom để tìm nhật ký lỗi để đối chiếu và loại bỏ trùng lặp với các phát hiện của Sentry. Tùy chọn nhưng được khuyến nghị.
Kết nối

Bước 2: Hỏi Okou

Okou mỗi ngày làm việc lúc 8:45 sáng, kéo các lỗi chưa được giải quyết từ Sentry và Axiom trong 24 giờ qua. Loại bỏ trùng lặp trên các nguồn. Đối với bất kỳ lỗi nào có 5+ lần xuất hiện, mở một vấn đề GitHub trong okou-ai/okou với dấu vết ngăn xếp đầy đủ và gán cho chủ sở hữu mã có liên quan.
Một lần chạy mẫu của cùng một quy trình làm việc, từng bước: tìm nạp và xếp hạng các vấn đề Sentry, gắn cờ các hồi quy triển khai, hiển thị biểu đồ, xuất bản báo cáo và đăng nó lên Slack.
Okou kéo các lỗi chưa được giải quyết từ Sentry và Axiom
Okou truy vấn cả Sentry và Axiom để tìm các lỗi chưa được giải quyết trong khoảng thời gian bạn đặt, sau đó áp dụng ngưỡng xuất hiện của bạn để loại bỏ nhiễu tín hiệu thấp và chỉ các lỗi xảy ra trên quy mô lớn mới được hiển thị.
Các lỗi trùng lặp được hợp nhất trên Sentry và Axiom
Cùng một lỗi thường xuất hiện trong cả Sentry và Axiom với các định dạng khác nhau. Okou loại bỏ trùng lặp chúng thành một bản ghi duy nhất kết hợp dữ liệu từ cả hai nguồn, vì vậy bạn chỉ phân loại mỗi vấn đề thực sự một lần.
Các vấn đề GitHub được lập hồ sơ và giao cho chủ sở hữu mã
Đối với mỗi lỗi duy nhất, đủ điều kiện, Okou mở một vấn đề GitHub có cấu trúc với toàn bộ dấu vết ngăn xếp, số lần xuất hiện và dấu thời gian lần đầu và lần cuối nhìn thấy, sau đó gán nó cho kỹ sư sở hữu khu vực mã đó — quá trình chuyển giao Sentry sang GitHub, tự động từ đầu đến cuối.

Bước 3: Phát triển thêm

Điều chỉnh ngưỡng
Thay đổi bộ lọc sự cố để giảm nhiễu hoặc phát hiện thêm vấn đề.
Okou cập nhật lịch phân loại hàng ngày để chỉ gửi vấn đề cho các lỗi có 10+ lần xuất hiện. Bất cứ điều gì dưới đó, chỉ cần đăng một bản tóm tắt lên #dev.
Thêm nó vào tóm tắt buổi sáng của bạn
Tích hợp phân loại lỗi vào bản tóm tắt sức khỏe sản phẩm mà nhóm của bạn đã đọc.
Okou bao gồm đầu ra phân loại lỗi hôm nay trong bản tóm tắt sức khỏe sản phẩm lúc 9 giờ sáng mà bạn đăng lên #standup.
Kiểm tra an toàn sau triển khai
Chạy phân loại ngay sau khi triển khai sản xuất để các lỗi hồi quy xuất hiện trong vòng vài phút, không phải sáng hôm sau.
Okou bất cứ khi nào một PR hợp nhất vào main trong okou-ai/okou, đợi 15 phút rồi chạy kiểm tra lỗi Sentry để tìm lỗi mới.

Tích hợp Sentry, GitHub và Axiom để phân loại lỗi

Quy trình làm việc này là một tích hợp Sentry GitHub với một tác nhân ở giữa: Okou đọc từ Sentry, kiểm tra chéo cùng một cửa sổ trong Axiom và ghi vào GitHub. Mỗi trình kết nối được cấp riêng và giới hạn trong những gì quy trình làm việc thực sự sử dụng, vì vậy quyền đọc dữ liệu lỗi của bạn không bao giờ ngụ ý quyền ghi vào kho lưu trữ của bạn.

Sentry

Tích hợp Sentry: các lỗi mà Okou đọc

Bắt buộc

Okou đọc theo dõi lỗi Sentry của bạn thông qua Sentry vấn đề API, truy vấn các lỗi chưa được giải quyết trong các môi trường bạn đặt tên, được sắp xếp theo tần suất. Đối với mỗi lỗi, nó đọc tiêu đề và thủ phạm, số lượng sự kiện và số lượng người dùng bị ảnh hưởng, cấp độ, và dấu thời gian nhìn thấy lần đầu và lần cuối, sau đó kéo sự kiện mới nhất để có dấu vết ngăn xếp đầy đủ và các thẻ phát hành và môi trường của nó. Điều đó bao gồm những gì quyết định phân loại cần: cái gì đã hỏng, tần suất, ở đâu và từ khi nào. Trong quy trình làm việc này, tích hợp Sentry chỉ đọc. Okou không bao giờ giải quyết, hợp nhất hoặc gán lại các vấn đề Sentry của bạn, và bản ghi nó viết sẽ được gửi đến GitHub thay vào đó.

GitHub

Tích hợp GitHub: các vấn đề mà Okou đã gửi

Bắt buộc

Mỗi lỗi vượt ngưỡng của bạn sẽ trở thành một vấn đề GitHub trong kho lưu trữ mà bạn chỉ Okou đến. Vấn đề bao gồm tiêu đề lỗi, dấu vết ngăn xếp, số lần xuất hiện và số người dùng bị ảnh hưởng, dấu thời gian lần đầu và lần cuối nhìn thấy, và một liên kết trở lại vấn đề Sentry để dữ liệu gốc chỉ cách một cú nhấp chuột. Okou áp dụng các nhãn bạn chỉ định và gán chủ sở hữu mã cho các tệp được đặt tên trong dấu vết ngăn xếp. Quyền ghi được giới hạn trong các kho lưu trữ bạn cấp, và việc tạo vấn đề là tất cả những gì nó làm: không có cam kết, không có yêu cầu kéo, không có cài đặt kho lưu trữ.

Axiom

Tích hợp Axiom: nhật ký Axiom Okou tham chiếu chéo

Tùy chọn

Axiom là tùy chọn và nó có vị trí của mình trong việc loại bỏ trùng lặp. Nếu hệ thống quản lý nhật ký của bạn đã chạy trên Axiom, Okou sẽ đọc nó trong cùng một lần: nó chạy một truy vấn APL đối với các tập dữ liệu bạn chọn, giới hạn trong cùng một khoảng thời gian với lần kéo Sentry, và khớp các nhật ký Axiom đó với các chữ ký lỗi mà nó đã có. Điều đó giải quyết trường hợp một lỗi xuất hiện hai lần ở các định dạng khác nhau, và nó thêm ngữ cảnh cấp yêu cầu xung quanh lỗi mà một sự kiện Sentry đơn thuần không mang theo. Nếu không có Axiom, quy trình vẫn chạy từ đầu đến cuối, và việc loại bỏ trùng lặp chỉ dựa vào dữ liệu Sentry.

Okou so với phân loại thủ công so với quy tắc cảnh báo Sentry

Phân loại lỗi hàng ngày là lớp đầu tiên của phản ứng sự cố tự động. Các nhóm tự động hóa Sentry thành GitHub với Okou, hoàn thành bước đầu tiên lặp đi lặp lại trước khi một vấn đề cần quản lý sự cố AI rộng hơn.

Phân loại thủ công

Một kỹ sư xem xét Sentry và Axiom, xác định các bản sao, quyết định mức độ nghiêm trọng, mở các vấn đề và tìm chủ sở hữu. Nó linh hoạt, nhưng lặp lại cùng 20 đến 30 phút làm việc mỗi sáng.

Quy tắc cảnh báo Sentry

Các quy tắc thông báo cho nhóm khi một ngưỡng bị vượt qua. Chúng hữu ích cho việc phát hiện, nhưng nhóm vẫn phải đối chiếu nhật ký, loại bỏ lỗi trùng lặp, tạo các vấn đề GitHub và chỉ định chủ sở hữu.

Tự động hóa quy trình làm việc Sentry của Okou

Okou chạy tự động hóa Sentry từ đầu đến cuối: truy vấn, loại bỏ trùng lặp đa nguồn, ngưỡng, tạo vấn đề, đính kèm dấu vết ngăn xếp và gán chủ sở hữu mã. Các lần chạy theo yêu cầu và sau triển khai sử dụng cùng một quy trình làm việc.

Mẹo để có kết quả tốt hơn

Đặt ngưỡng xuất hiện để giữ số lượng vấn đề ở mức có thể quản lý được. 5+ là một điểm khởi đầu tốt; điều chỉnh dựa trên khối lượng của bạn.
Phạm vi truy vấn của Okou đến sản xuất bằng cách sử dụng môi trường Sentry hoặc thẻ dự án, để lỗi dàn dựng không bao giờ đến hàng đợi phân loại.
Xích phân loại hàng ngày với kiểm tra sau triển khai để biến một thói quen thành phản ứng sự cố tự động nhẹ, và ghép nối nó với bản tóm tắt tình trạng sản phẩm lúc 9:00 để nhóm thấy lỗi và trạng thái ở một nơi.

Các câu hỏi thường gặp

Làm thế nào để phân loại lỗi Sentry và biến chúng thành vấn đề GitHub?

Để tự động tạo các vấn đề GitHub từ Sentry, hãy kết nối Sentry và GitHub với Okou, sau đó đặt lịch hoặc lời nhắc theo yêu cầu. Okou truy vấn các lỗi chưa được giải quyết, áp dụng các bộ lọc sự cố và môi trường, tạo một vấn đề cho mỗi lỗi đủ điều kiện, đính kèm dấu vết ngăn xếp và dấu thời gian, và chỉ định chủ sở hữu mã.

Cách loại bỏ lỗi trùng lặp trên Sentry và Axiom?

Có. Okou so sánh các chữ ký lỗi, dấu vết ngăn xếp, thông báo và thời gian trên Sentry và Axiom, sau đó hợp nhất các sự kiện phù hợp thành một bản ghi phân loại. Mỗi nguồn cơ bản vẫn được liên kết để điều tra.

Làm thế nào để giảm mệt mỏi do cảnh báo từ việc giám sát lỗi?

Giới hạn phân loại đến sản xuất, đặt ngưỡng xuất hiện, loại bỏ lỗi trùng lặp trên các công cụ và định tuyến các lỗi có khối lượng thấp đến một bản tóm tắt thay vì tạo một vấn đề. Điều này giúp hàng đợi tập trung vào các lỗi cần hành động.

Okou có thể chạy phân loại lỗi sau mỗi lần triển khai không?

Có. Tạo một tự động hóa bắt đầu quy trình xử lý lỗi sau khi triển khai hoặc hợp nhất vào chính, tùy chọn chờ một cửa sổ quan sát ngắn, sau đó kiểm tra Sentry để tìm lỗi sản xuất mới và các vấn đề đủ điều kiện.

Tự động hóa phân loại lỗi cần những công cụ nào?

Sentry và GitHub là bắt buộc: Sentry cung cấp dữ liệu lỗi và GitHub nhận các vấn đề được chỉ định. Axiom là tùy chọn, nhưng nó thêm ngữ cảnh nhật ký và cải thiện việc loại bỏ trùng lặp giữa các nguồn.

Tích hợp Sentry GitHub cần những quyền nào?

Sentry cần quyền đọc các vấn đề và sự kiện trong các dự án bạn phân loại. GitHub cần quyền ghi vấn đề trên các kho lưu trữ sẽ nhận các vấn đề. Axiom, nếu bạn sử dụng nó, cần quyền truy vấn các tập dữ liệu bạn đặt tên. Bạn cấp quyền cho mỗi trình kết nối riêng biệt trong Okou, và việc thu hồi một trình kết nối sẽ không ảnh hưởng đến các trình kết nối khác.

Okou có thể gửi vấn đề trong nhiều kho lưu trữ GitHub không?

Có. Hãy cho Okou biết dịch vụ hoặc dự án nào tương ứng với kho lưu trữ nào và nó sẽ định tuyến từng vấn đề một cách phù hợp, để các lỗi giao diện người dùng xuất hiện trong kho lưu trữ web của bạn và các lỗi API trong kho lưu trữ phụ trợ của bạn. Ánh xạ đó nằm trong lời nhắc, vì vậy bạn có thể thay đổi nó mà không cần cấu hình lại trình kết nối GitHub.

Okou có thay đổi bất cứ điều gì trong Sentry không?

Không. Tích hợp Sentry ở đây chỉ đọc: Okou truy vấn các vấn đề và sự kiện và không ghi lại bất cứ điều gì. Trạng thái vấn đề, phân công và lịch sử giải quyết của bạn vẫn giữ nguyên như nhóm của bạn đã để lại. Điều duy nhất Okou tạo ra là vấn đề GitHub.

Chạy phân loại Sentry đầu tiên của bạn

Kết nối Sentry, GitHub và tùy chọn Axiom. Sử dụng cùng một lời nhắc phân loại hàng ngày để xem quy trình làm việc hoạt động mà không cần xây dựng lại thủ công.

Okou mỗi ngày làm việc lúc 8:45 sáng, kéo các lỗi chưa được giải quyết từ Sentry và Axiom trong 24 giờ qua. Loại bỏ trùng lặp trên các nguồn. Đối với bất kỳ lỗi nào có 5+ lần xuất hiện, mở một vấn đề GitHub trong okou-ai/okou với dấu vết ngăn xếp đầy đủ và gán cho chủ sở hữu mã có liên quan.