Tuist-ის ინტეგრაცია Slack-თან
Tuist-ის Slack-ინტეგრაცია პირდაპირ აჩვენებს ბილდების, ტესტებისა და ბანდლების ანალიტიკას თქვენს არხებში. ის მონიტორინგს გარდაქმნის იმ საქმიანობად, რომელიც თავისით ხდება, ნაცვლად იმისა, რომ გუნდმა ყოველ ჯერზე უნდა გაიხსენოს. მაგალითად, თქვენს გუნდს შეუძლია მიიღოს ყოველდღიური შეჯამებები ბილდების წარმადობის, ქეშში მოხვედრის სიხშირის ან ბანდლის ზომის ტენდენციების შესახებ, ასევე მყისიერი გაფრთხილებები, როდესაც საკვანძო მეტრიკა გაუარესდება ან ტესტი გახდება არასტაბილური.
ეს გვერდი აღწერს, რას აკეთებს ინტეგრაცია, როგორ დავაყენოთ ის თითოეული არხისთვის ცალ-ცალკე და როგორ ამუშავებს Tuist თქვენს მონაცემებს. დეტალებისთვის, თუ როგორ აგროვებს, მართავს და ინახავს Tuist მესამე მხარის მონაცემებს, იხილეთ ჩვენი კონფიდენციალურობის პოლიტიკა.
როგორ მუშაობს ინტეგრაცია#
Tuist აგზავნის შეტყობინებებს Slack-ში Slack-ის Incoming Webhooks-ის მეშვეობით. ინტეგრაცია ითხოვს მხოლოდ incoming-webhook სკოუპს. თითოეული შეტყობინების დანიშნულება (პროექტის ანგარიში, გაფრთხილების წესი, არასტაბილური ტესტის გაფრთხილება, ავტომატიზაციის მოქმედება) შეესაბამება ერთ Slack-არხს, რომელსაც თქვენ ირჩევთ დაყენებისას. Slack ქმნის ერთ webhook URL-ს თითოეული არხისთვის, ხოლო Tuist ინახავს მას შეტყობინებების მიწოდებისთვის.
Tuist არასდროს კითხულობს შეტყობინებებს, წევრთა სიებს ან სხვა მონაცემებს თქვენი სამუშაო სივრციდან. ინტეგრაცია მხოლოდ წერს შეტყობინებებს იმ არხებში, რომლებიც თქვენ ცალსახად დაუშვით.
დაყენება#
პროექტის ანგარიშები#
პროექტის ანგარიშები აწვდის თქვენი პროექტის ბილდების, ტესტებისა და ქეშის მეტრიკების ყოველდღიურ შეჯამებას თქვენს მიერ შერჩეულ Slack-არხში.
- გახსენით თქვენი პროექტის შეტყობინებების პარამეტრები Tuist-ის დაშბორდზე.
- დააჭირეთ Select Slack channel და აირჩიეთ სამუშაო სივრცე და არხი, სადაც Tuist გამოაქვეყნებს შეტყობინებებს. Slack მოგთხოვთ
incoming-webhookსკოუპის ავტორიზაციას და ერთი არხის არჩევას. - აირჩიეთ კვირის დღეები და დრო, როდესაც გსურთ ყოველდღიური ანგარიშის მიღება.

კონფიგურაციის შემდეგ, Tuist ავტომატურად აგზავნის ყოველდღიურ ანგარიშებს შერჩეულ არხში:
პირად არხში გამოქვეყნებისთვის, ჯერ გახსენით არხი Slack-ში და დაამატეთ ის ინტეგრაციისთვის ხელმისაწვდომი არხების სიაში ავტორიზაციის ეტაპზე.
გაფრთხილების წესები#
გაფრთხილების წესები გაგატყობინებთ Slack-ში, როდესაც საკვანძო მეტრიკები მნიშვნელოვნად გაუარესდება, რაც დაგეხმარებათ დროულად შეამჩნიოთ შენელებული ბილდები, ქეშის დეგრადაცია ან ტესტების შენელება.
გაფრთხილების წესის შესაქმნელად, გადადით თქვენი პროექტის შეტყობინებების პარამეტრებში და დააჭირეთ Add alert rule. შეგიძლიათ დააკონფიგურიროთ:
- სახელი: გაფრთხილების აღმწერი სახელი
- კატეგორია: რა უნდა გაიზომოს (ბილდის ხანგრძლივობა, ტესტის ხანგრძლივობა, ქეშში მოხვედრის სიხშირე ან ბანდლის ზომა)
- მეტრიკა: როგორ მოხდეს მონაცემების აგრეგაცია (p50, p90, p99 ან საშუალო)
- გადახრა: პროცენტული ცვლილება, რომელიც იწვევს გაფრთხილებას
- მოძრავი ფანჯარა: რამდენი ბოლო გაშვება შედარდეს
- ბრენჩი: ქეშში მოხვედრის სიხშირის გაფრთხილებებისთვის, შეადარეთ მხოლოდ ერთ ბრენჩზე შესრულებული გაშვებები. დატოვეთ ცარიელი ყველა ბრენჩის გასათვალისწინებლად. ბანდლის ზომის გაფრთხილებები ყოველთვის ერთ ბრენჩს ეხება.
- Slack-არხი: დანიშნულების არხი. თქვენ ავტორიზებთ არხს ზემოთ აღწერილი იგივე
incoming-webhookნაკადის მეშვეობით.
მაგალითად, შეგიძლიათ შექმნათ გაფრთხილება, რომელიც აქტიურდება, როდესაც p90 ბილდის ხანგრძლივობა 20%-ზე მეტით იზრდება წინა 100 ბილდთან შედარებით.
ქეშში მოხვედრის სიხშირის გაფრთხილების თქვენს ძირითად ბრენჩზე შეზღუდვა სასარგებლოა, როდესაც მხოლოდ ეს ბრენჩი ავსებს ქეშს. Pull request ბრენჩები, რომლებიც ეხებიან დაბალი დონის მოდულს, კანონიერად ვერ ხვდებიან ქეშში, და მათი ჩართვა გამოიწვევდა გაფრთხილებას მოსალოდნელი გაუარესებების დროს.
ქეშში მოხვედრის სიხშირის გაფრთხილება ადარებს მხოლოდ ისეთ ფანჯრებს, რომელთა სამართლიანი შედარებაც შესაძლებელია. ორივე ფანჯარაში უნდა იყოს იმდენივე გაშვება, რამდენიც მოძრავი ფანჯრის ზომაა, ხოლო ქეშის მონაცემთა წყარო, რომელიც მხოლოდ ერთ-ერთ ფანჯარაში ჩანს, გამოირიცხება ორივედან. ბრენჩი, რომელმაც ჯერ არ დააგროვა მოძრავი ფანჯრის ზომაზე ორჯერ მეტი გაშვება, ან ბრენჩის სახელი, რომელიც არაფერს ემთხვევა, შესაბამისად, არასდროს ააქტიურებს წესს. თუ წესს დაუკავშირებთ დაბალი აქტივობის ბრენჩს, შეინარჩუნეთ მოძრავი ფანჯარა საკმარისად მცირე, რათა ბრენჩმა შეავსოს ის.
როდესაც გაფრთხილება აქტიურდება, თქვენს Slack-არხში მიიღებთ ასეთ შეტყობინებას:
გაფრთხილების აქტივაციის შემდეგ, იგივე წესისთვის ის 24 საათის განმავლობაში აღარ აქტიურდება. ეს ხელს უშლის შეტყობინებებით გადატვირთვას, როდესაც მეტრიკა მაღალი რჩება.
არასტაბილური ტესტების გაფრთხილებები#
არასტაბილური ტესტების გაფრთხილებები აქტიურდება მაშინვე, როდესაც Tuist აღმოაჩენს ახალ არასტაბილურ ტესტს, რაც დაგეხმარებათ შეამჩნიოთ ტესტების არასტაბილურობა, სანამ ის თქვენს გუნდს შეეხება.
არასტაბილური ტესტის გაფრთხილების წესის შესაქმნელად, გადადით თქვენი პროექტის შეტყობინებების პარამეტრებში და დააჭირეთ Add flaky test alert rule. შეგიძლიათ დააკონფიგურიროთ:
- სახელი: გაფრთხილების აღმწერი სახელი
- აქტივაციის ზღვარი: არასტაბილური გაშვებების მინიმალური რაოდენობა ბოლო 30 დღეში, რაც საჭიროა გაფრთხილების აქტივაციისთვის
- Slack-არხი: დანიშნულების არხი, ავტორიზებული
incoming-webhookნაკადის მეშვეობით.
როდესაც ტესტი ხდება არასტაბილური და აკმაყოფილებს თქვენს ზღვარს, მიიღებთ შეტყობინებას სატესტო შემთხვევის შესასწავლად პირდაპირი ბმულით:
ინტეგრაციის გათიშვა#
შეტყობინების შეჩერებისთვის, წაშალეთ კონფიგურირებული Slack-არხი ანგარიშში, გაფრთხილების წესში ან ავტომატიზაციის ქმედებაში თქვენს Tuist დაშბორდზე. Tuist-ის წვდომის სრულად გაუქმებისთვის, წაშალეთ webhook ინტეგრაცია Slack-ის შიგნიდან გზით Settings & administration → Manage apps.