โดยส่วนใหญ่แล้ว ตัววัด กราฟ และการแสดงภาพการตรวจสอบแอปพลิเคชันเริ่มต้นที่ AppSignal มอบให้จะทำกับแอป Ruby ของคุณ อย่างไรก็ตาม คุณอาจเป็นผู้ใช้ประเภทที่ชอบควบคุมสิ่งที่วัดได้ วิธีแสดงข้อมูล และวิธีถ่ายทอดข้อมูลที่สำคัญเกี่ยวกับแอปของคุณ
AppSignal ช่วยให้คุณปรับแต่งตัววัดและแดชบอร์ดของแอปได้ตามที่คุณต้องการ ในคู่มือนี้ เราจะเรียนรู้ทั้งหมดเกี่ยวกับตัววัดที่กำหนดเองของ AppSignal รวมถึง:
- ตัวชี้วัดที่กำหนดเองคืออะไร
- เมตริกที่กำหนดเองประเภทต่างๆ ที่คุณสามารถตั้งค่าได้
- วิธีปรับแต่งการแสดงภาพกราฟ
- วิธีตั้งค่าการแจ้งเตือนที่มีประสิทธิภาพ
และอีกมากมาย!
แต่ก่อนที่เราจะดำดิ่งลง คุณจะต้องมีบางสิ่งที่ต้องปฏิบัติตาม
ข้อกำหนดเบื้องต้น
- บัญชี AppSignal: หากคุณยังไม่มี ให้สมัครทดลองใช้ฟรี 30 วัน
- แอปพลิเคชัน Ruby: แอปนี้สามารถอิงตามเฟรมเวิร์ก Ruby ที่รองรับ เช่น Rails, Sinatra หรือ Ruby ธรรมดา นอกจากนี้ยังอาจเป็นแอปที่ใช้งานจริงหรือการพัฒนาก็ได้ หากคุณไม่ต้องการสร้างแอปของคุณเอง ให้โคลนโค้ดสำหรับตัวอย่างแอป Sinatra ที่เราจะใช้ในบทช่วยสอนนี้
หมายเหตุ:หากคุณใช้แอปของคุณเองเพื่อปฏิบัติตามบทช่วยสอนนี้ ตรวจสอบให้แน่ใจว่าแอปของคุณได้รับการกำหนดค่าให้ใช้ AppSignal Ruby gem ล่าสุด เนื่องจากตัวอย่างที่ใช้ในบทช่วยสอนนี้ถือว่าเป็นเช่นนั้น ป>
ตัวชี้วัดที่กำหนดเองคืออะไร
นอกเหนือจากการวัดอัตราข้อผิดพลาด ปริมาณการประมวลผล และประสิทธิภาพของแอปแล้ว คุณอาจสนใจในการวัดข้อมูลที่กำหนดเองซึ่งปรับแต่งมาสำหรับแอปของคุณโดยเฉพาะ ตัวอย่างเช่น คุณอาจสนใจจำนวนผู้เข้าชมที่ลงชื่อสมัครใช้แอปของคุณในช่วงเวลาหนึ่งๆ ประสิทธิภาพของชั้น websocket ของแอปของคุณ และอื่นๆ
สำหรับกรณีที่ได้รับการปรับแต่งดังกล่าว คุณอาจลำบากใจในการค้นหาเครื่องมือวัดมาตรฐานภายใน AppSignal คุณจะต้องใช้เมตริกที่กำหนดเองแทน เมตริกที่กำหนดเองคือเมตริกเพิ่มเติมที่คุณกำหนดควบคู่ไปกับเมตริกเริ่มต้นสำหรับบริบทที่ลึกซึ้งยิ่งขึ้นเกี่ยวกับวิธีการทำงานของแอปของคุณ
ต่อไป เรามาเรียนรู้วิธีตั้งค่าเมตริกที่กำหนดเองรายการแรกของเรากัน
การตั้งค่าการวัดที่กำหนดเอง
คุณสามารถตั้งค่าตัววัดแบบกำหนดเองสำหรับกรณีการใช้งานเกือบทุกกรณีภายในแอปพลิเคชันของคุณ เรามาเริ่มด้วยตัวอย่างง่ายๆ เพื่อช่วยให้คุณเข้าใจว่าทุกอย่างเข้ากันได้อย่างไร
ขั้นตอนแรกคือการกำหนดตัววัดแบบกำหนดเองที่จะถูกติดตามบน AppSignal คุณสามารถกำหนดเมตริกที่กำหนดเองได้โดยใช้ประเภทเมตริกต่างๆ ที่มีให้เลือก:
- มาตรวัด
- เคาน์เตอร์
- การกระจาย
มาตรวัดแบบกำหนดเอง
ใน AppSignal มาตรวัด เมตริกที่กำหนดเองมีประโยชน์สำหรับการวัดเมตริกที่เพิ่มขึ้นและลดลงเมื่อเวลาผ่านไป
มาตั้งค่าการวัดแบบกำหนดเองแบบเกจง่ายๆ เพื่อวัดจำนวนโพสต์ทั้งหมดในแอป Sinatra ตัวอย่างของเรา:
ในโค้ดที่แสดงด้านบน เราใช้ 01 โมดูลและเรียก 14 วิธีการซึ่งยอมรับสามข้อโต้แย้ง:
26รหัส> :ชื่อของเมตริกที่กำหนดเอง ในตัวอย่าง นี่จะเป็น all_posts .33รหัส> - ตัวชี้วัดหรือ "สิ่งของ" ที่จะวัด ในตัวอย่างที่แสดงด้านบน นี่เป็นเพียงจำนวนโพสต์ทั้งหมด42รหัส> - ข้อมูลเมตาเพิ่มเติมและตัวเลือกที่สามารถเพิ่มลงในเมตริกที่กำหนดเองได้ และมีประโยชน์สำหรับการติดป้ายกำกับข้อมูลที่จะวัดตามที่คุณต้องการ ตัวอย่างเช่น เราสามารถแท็ก50ได้อย่างง่ายดาย เมตริกเพื่อพิจารณาสภาพแวดล้อม ดังที่แสดงด้านล่าง:
เยี่ยมเลย เราเพิ่งเพิ่มเกจเมตริกที่กำหนดเองอันแรกของเรา! แต่หากคุณกลับไปที่ AppSignal ตัววัดแบบกำหนดเองใหม่ของคุณจะไม่ปรากฏให้เห็น แต่คุณมีแนวโน้มที่จะเห็นแดชบอร์ดเริ่มต้นแทน ดังที่แสดงด้านล่าง:

แล้วคุณต้องทำอย่างไรเพื่อให้เมตริกที่กำหนดเองปรากฏขึ้น คุณต้องเพิ่มแดชบอร์ด เริ่มต้นด้วยการสร้างแดชบอร์ดใหม่:

จากนั้น ตั้งชื่อแดชบอร์ดใหม่ของคุณด้วยชื่อและคำอธิบายที่สื่อความหมาย:

เมื่อเพิ่มแดชบอร์ดที่กำหนดเองแล้ว ตอนนี้คุณจะต้องเพิ่มกราฟสำหรับเมตริกที่กำหนดเอง:

จากนั้นกำหนดกราฟใหม่:

ต่อไปนี้คือรายละเอียดของฟิลด์ต่างๆ เพื่อตั้งค่ากราฟใหม่:
- ก. หัวเรื่อง - ป้อนชื่อที่สื่อความหมายสำหรับกราฟใหม่
- ข. คำอธิบาย - นี่เป็นทางเลือก แต่คุณสามารถป้อนคำอธิบายสำหรับกราฟใหม่ได้
- ค. ตัวชี้วัด - ที่นี่คือที่ที่คุณกำหนดหน่วยเมตริกที่จะวัดและแสดงด้วยกราฟใหม่ นี่คือชื่อของเมตริกที่กำหนดเอง หรืออาร์กิวเมนต์แรกที่กำหนดใน
67วิธีการ:73รหัส> . ในส่วนนี้ คุณยังสามารถกำหนดแท็กได้ (เช่น แท็ก สภาพแวดล้อม รวมอยู่ด้วยดังที่แสดง) - ง. การแสดงกราฟ - นี่คือที่ที่คุณเลือกประเภทของการแสดงกราฟสำหรับกราฟใหม่ของคุณ
- จ. ป้ายคำอธิบาย - คุณสามารถปรับแต่งป้ายกำกับสำหรับคำอธิบายแผนภูมิได้ที่นี่
- ฉ. รูปแบบข้อมูล - กำหนดชนิดข้อมูลที่ใช้สำหรับการแสดงกราฟ คุณสามารถเลือกจากหลายรูปแบบ รวมถึงตัวเลข เปอร์เซ็นต์ ปริมาณงาน (ในคำขอ/นาทีหรือชั่วโมง) ระยะเวลา (เป็นมิลลิวินาที) หรือขนาดไฟล์ (เป็นไบต์)
เมื่อคุณกำหนดคุณสมบัติของกราฟใหม่อย่างถูกต้องแล้ว คุณควรได้รับกราฟสำหรับเมตริกที่กำหนดเอง สิ่งนี้คล้ายกับสิ่งที่แสดงด้านล่าง:

จากนี้ไป มาดูประเภทเมตริกที่กำหนดเองถัดไป:ตัวนับ
ตัวนับเมตริกแบบกำหนดเอง
เมตริกแบบกำหนดเองของตัวนับเหมาะสำหรับการวัดจำนวนครั้งที่เหตุการณ์เกิดขึ้น เมื่อใช้แอปพลิเคชันตัวอย่าง เราสามารถใช้ตัวนับเมตริกเพื่อวัดทุกครั้งที่มีการเยี่ยมชมหน้าแรก (รูท)
ขั้นแรก ให้แก้ไขวิธีการรูทเพื่อรวมโค้ดที่แสดงด้านล่าง:
ที่นี่เราใช้ 87 ของ AppSignal วิธีการแล้วส่งผ่าน 99 เป็นข้อโต้แย้งแรก ขั้นตอนการเพิ่มขึ้นคือจำนวนเต็ม 1 ซึ่งส่งผ่านเป็นอาร์กิวเมนต์ที่สอง คุณสามารถเพิ่ม 102 ได้ด้วย hash เป็นอาร์กิวเมนต์ที่สาม แต่เราจะปล่อยไว้เหมือนเดิม (เนื่องจากสิ่งนี้ได้กล่าวถึงไปแล้วในส่วนที่แล้ว)
ตอนนี้ให้ทำตามขั้นตอนตามที่ระบุไว้สำหรับประเภทเมตริกเกจ เพิ่มกราฟที่กำหนดเองสำหรับเมตริกตัวนับนี้เพื่อให้คุณได้กราฟที่คล้ายกับกราฟที่แสดง:

มาเปลี่ยนเกียร์ไปใช้เมตริกการกระจายแบบกำหนดเองกันดีกว่า
ตัวชี้วัดการกระจายที่กำหนดเอง
ตัววัดแบบกำหนดเองของการกระจาย AppSignal มีประโยชน์ในการวัดบางอย่างต่อหน่วยเวลา เช่น ใช้เวลากี่วินาทีในการสร้างรายงาน PDF หรืองานเบื้องหลังใช้เวลานานเท่าใดในการดำเนินการ
เมื่อใช้แอปพลิเคชันตัวอย่าง เราจะมาแก้ไขไฟล์หลักเพื่อรวมการเรียกไปยังตำแหน่งข้อมูล API ที่เปิดอยู่ จากนั้น เราจะใช้การกระจายแบบกำหนดเองเพื่อวัดว่าการเรียก API ใช้เวลานานเท่าใดในหน่วยมิลลิวินาที
ตอนนี้ ถ้าเรากลับไปที่ AppSignal เราจะสามารถดูการกระจายที่กำหนดเองเป็นกราฟได้
เคล็ดลับ:คุณสามารถทำตามขั้นตอนที่ระบุไว้ในส่วนมาตรวัดเพื่อตั้งค่าการแสดงภาพกราฟแบบกำหนดเองได้ ป>

เมื่อคุณได้เรียนรู้วิธีสร้างหน่วยวัดที่กำหนดเองและการแสดงภาพกราฟที่แนบมาแล้ว คุณอาจสังเกตเห็นว่าการกลับไปที่แดชบอร์ด AppSignal ต่อไปเพื่อดูว่าเกิดอะไรขึ้นกับแอปของคุณนั้นไม่สะดวกนัก แต่จะมีประโยชน์มากหากคุณสามารถรับการแจ้งเตือนสำหรับเมตริกที่คุณกำหนดเองได้ใช่ไหม
มาเรียนรู้วิธีตั้งค่าการแจ้งเตือนสำหรับเมตริกที่คุณกำหนดเองกันต่อไป
การแจ้งเตือน
ตามค่าเริ่มต้น เมื่อใดก็ตามที่เกิดข้อผิดพลาดหรือเหตุการณ์ด้านประสิทธิภาพ AppSignal จะเปิดเหตุการณ์สำหรับเหตุการณ์นั้นและวางไว้ในส่วนที่เกี่ยวข้อง ตัวอย่างเช่น หากเป็นข้อผิดพลาด คุณจะพบข้อผิดพลาดนั้นในรายการข้อผิดพลาด ในขณะที่เหตุการณ์ด้านประสิทธิภาพจะอยู่ในรายการประสิทธิภาพ
นอกจากนี้ AppSignal ยังส่งการแจ้งเตือนเหตุการณ์ผ่านทางอีเมล (ช่องทางการแจ้งเตือนเริ่มต้น) คุณยังสามารถตั้งค่าช่องทางการแจ้งเตือนอื่นๆ ได้ เช่น:
- ความไม่ลงรอยกัน
- Google แฮงเอาท์
- อินเตอร์คอม
- ทีม Microsoft
- หย่อน
- เว็บฮุค
และอื่นๆ อีกมากมาย
แต่ก่อนที่เราจะตั้งค่าทริกเกอร์การแจ้งเตือนสำหรับหนึ่งในเมตริกที่กำหนดเองของเรา สิ่งสำคัญคือต้องทราบถึงตัวเลือกการแจ้งเตือนต่างๆ ที่คุณสามารถใช้ได้
ขั้นแรก คุณสามารถตั้งค่าการแจ้งเตือนสำหรับ:
- ทุกครั้ง - ที่นี่ การแจ้งเตือนจะถูกส่งออกไปทุกครั้งที่มีเหตุการณ์เกิดขึ้น
- ปรับใช้ครั้งแรก - สิ่งนี้บ่งชี้ว่าการแจ้งเตือนจะถูกส่งในครั้งแรกที่เกิดเหตุการณ์หลังจากการปรับใช้
- ก่อนหลังปิด - ที่นี่ การแจ้งเตือนจะถูกส่งออกไปทุกครั้งที่มีเหตุการณ์เกิดขึ้นซ้ำหลังจากที่เหตุการณ์ก่อนหน้าถูกปิด
- ไม่ต้องแจ้งเตือน - ตามชื่อที่แนะนำ ในกรณีนี้ การแจ้งเตือนจะไม่ถูกส่ง แต่ข้อผิดพลาดหรือเหตุการณ์ด้านประสิทธิภาพจะยังคงติดตามบน AppSignal
- ทุกๆ n ชั่วโมงหรือวัน - ด้วยตัวเลือกนี้ คุณสามารถระบุจำนวนการแจ้งเตือนที่จะถูกส่งถึงคุณภายในหนึ่งชั่วโมงหรือหนึ่งวัน ตัวเลือกนี้เหมาะอย่างยิ่งสำหรับการรักษาสมดุลระหว่างการรับการแจ้งเตือนกิจกรรมสำคัญและการแจ้งเตือนมากเกินไป (ซึ่งอาจรบกวนคุณหรือทีมของคุณได้ง่าย)
ฉันขอแนะนำให้คุณศึกษาเอกสารการตั้งค่าการแจ้งเตือนของ AppSignal เพื่อรับข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกเหล่านี้
มาดูวิธีตั้งค่าการแจ้งเตือนสำหรับหนึ่งในเมตริกที่กำหนดเองที่เราสร้างไว้ก่อนหน้านี้ นี่อาจเป็นตัวอย่างเล็กๆ น้อยๆ แต่จะแสดงขั้นตอนที่คุณต้องดำเนินการสำหรับกรณีการใช้งานของคุณเอง
การตั้งค่าการแจ้งเตือนสำหรับตัวชี้วัดที่คุณกำหนดเอง
สำหรับตัวอย่างนี้ เราจะใช้ตัวชี้วัดการกระจายที่วัดระยะเวลาของการเรียก API ในช่วงต้นของโพสต์นี้ สมมติว่าเราต้องการรับการแจ้งเตือนทางอีเมลเมื่อใดก็ตามที่ระยะเวลาเฉลี่ยเกินจำนวนที่กำหนด (เป็นมิลลิวินาที)
ขั้นตอนในการตั้งค่านี้แสดงไว้ด้านล่าง:

ขั้นแรก เริ่มต้นด้วยการกดปุ่ม ทริกเกอร์ ลิงก์ในเมนูด้านซ้ายมือ

ตั้งชื่อที่เกี่ยวข้องให้ทริกเกอร์ จากนั้นเลือกการวัดที่ต้องการการแจ้งเตือนนี้ ในตัวอย่างนี้ เราใช้ 118 เมตริกที่กำหนดเองของการกระจาย คุณยังสามารถเพิ่มแท็กได้หากต้องการ
ถัดไป ให้กำหนดตัวดำเนินการเปรียบเทียบและค่าที่จะตรวจสอบ ตัวอย่างเช่น สมมติว่าเราต้องการรับการแจ้งเตือนเมื่อใดก็ตามที่ระยะเวลาเกิน 1,600 มิลลิวินาที สำหรับสิ่งนี้ เราจะเลือกตัวดำเนินการเปรียบเทียบ มากกว่า จากนั้นมีค่า 1600

สุดท้าย คุณจะต้องกำหนดการตั้งค่าการวอร์มอัพและคูลดาวน์การแจ้งเตือน ระบุคำอธิบายสำหรับการแจ้งเตือน ลิงก์ไปยังแดชบอร์ดที่จะรวมไว้ในข้อความแจ้งเตือน (หากจำเป็น) และสุดท้าย วิธีการแจ้งเตือน (โดยที่อีเมลเป็นค่าเริ่มต้น)

เมื่อดำเนินการเสร็จแล้ว คุณจะได้รับการแจ้งเตือนทุกครั้งที่มีเหตุการณ์เกิดขึ้นซึ่งตรงกับการตั้งค่าที่คุณป้อนไว้ที่นี่
แค่นั้นแหละ!
สรุป
ในบทความนี้ เราได้เรียนรู้วิธีตั้งค่าตัววัดแบบกำหนดเองสำหรับแอปพลิเคชัน Ruby ด้วยแดชบอร์ดและการแสดงภาพกราฟที่ตรงกันบน AppSignal
ฟังก์ชันตัววัดแบบกำหนดเองที่ AppSignal นำเสนอนั้นสามารถปรับแต่งได้อย่างละเอียดสำหรับแอปพลิเคชันที่ทรงพลังมาก เจาะลึกเอกสารประกอบตัววัดที่กำหนดเองของ AppSignal เพื่อค้นหาความเป็นไปได้เพิ่มเติม
ไว้คราวหน้า ขอให้สนุกกับการเขียนโค้ด!
ปล. หากคุณต้องการอ่านโพสต์ Ruby Magic ทันทีที่เผยแพร่ สมัครรับจดหมายข่าว Ruby Magic ของเราและไม่พลาดแม้แต่โพสต์เดียว! ป>