Logfire
เชื่อมต่อ
เชื่อมต่อ Logfire จากเทอร์มินัล ส่ง --help เพื่อดูแฟล็กที่ Logfire รับ
polylane integration connect --type logfireคีย์ API สองอันต่อโปรเจกต์ คีย์ API ของโปรเจกต์และคีย์ API ขององค์กร แต่ละอันมี Read-only access และ Manage project and org
เชื่อมต่อ Pydantic Logfire เพื่อให้เอเจนต์สอบถาม trace, log และเมตริกที่โปรเจกต์ของคุณรับเข้า และ alert ของมันถึง Polylane ทันทีที่ทำงาน
การตั้งค่า
Logfire ให้สิทธิ์สอบถามบนคีย์ของโปรเจกต์และสิทธิ์ช่องทางแจ้งเตือนบนคีย์ขององค์กร การเชื่อมต่อหนึ่งโปรเจกต์จึงใช้ทั้งสองอัน เชื่อมต่อแต่ละโปรเจกต์แยกกัน คีย์ขององค์กรใช้ซ้ำได้กับทุกโปรเจกต์ในองค์กร
คีย์ API ของโปรเจกต์ (ป้อนก่อน)
- ใน Logfire เปิดโปรเจกต์ของคุณ แล้ว Project settings แล้ว Security & access แล้ว New API key
- ทำเครื่องหมาย Read-only access และ Manage project and org คง Key type เป็น Project แล้ว Create API key
- วางคีย์ใน Polylane region (US หรือ EU) ถูกตรวจพบจากคำนำหน้าของคีย์ และ Polylane แสดงโปรเจกต์ที่คีย์เป็นของ
คีย์ API ขององค์กร (ป้อนเป็นอันดับสอง)
- จาก Project settings เลือก Go to org settings แล้ว Security & access แล้ว New API key
- ทำเครื่องหมาย Read-only access และ Manage project and org ตั้ง Key type เป็น Organization แล้ว Create API key
- วางคีย์ใน Polylane Polylane ตรวจว่าองค์กรของคีย์เป็นเจ้าของโปรเจกต์ที่คีย์แรกระบุ
แต่ละคีย์แสดงว่า Logfire ยอมรับมันหรือไม่ขณะที่คุณวาง และ Connect พร้อมใช้เมื่อทั้งสองผ่าน คีย์ทั้งสองถูกเข้ารหัสก่อนจัดเก็บ และเอเจนต์ไม่มีทางเห็นมัน
สิ่งที่เอเจนต์ทำได้
- แสดงรายการเซอร์วิสที่รายงานเข้าโปรเจกต์ในช่วงเวลาหนึ่ง
- จัดอันดับ route ตามจำนวนคำขอ อัตราข้อผิดพลาด และ latency p50/p95
- ค้นหา span และ log ตามเซอร์วิส ชื่อ span, route ระดับ แฟล็ก exception หรือสถานะ HTTP
- เปิดหนึ่ง trace เป็น tree ของ span แม่/ลูกพร้อมระยะเวลาและข้อความ exception
- รันคำสั่ง SQL แบบอ่านอย่างเดียวหนึ่งคำสั่งบนตาราง records และ metrics เมื่อเครื่องมือที่คัดสรรไว้ไม่ครอบคลุมคำถาม
Alert
เมื่อเชื่อมต่อ Polylane เพิ่มตัวเองเป็นช่องทางแจ้งเตือนบนโปรเจกต์ Logfire และแนบช่องทางนั้นเข้ากับทุก alert ที่โปรเจกต์มี โดยไม่แตะต้องช่องทางที่คุณกำหนดค่าไว้แล้ว alert ที่คุณเพิ่มภายหลังถูกรับไปภายในหนึ่งชั่วโมง แต่ละ alert ที่ Logfire ส่งมาถึงเป็นอินซิเดนต์ที่ Polylane สืบสวนได้ การยกเลิกการเชื่อมต่อลบช่องทางและถอดมันออกจากทุก alert
ทุกคิวรีมีขอบเขตช่วงเวลาไม่เกินเจ็ดวัน และเส้นทาง SQL ดิบรับคำสั่ง SELECT เพียงคำสั่งเดียว
ทำไมต้องสองคีย์
คีย์ของโปรเจกต์ครอบคลุม trace และเมตริกที่เอเจนต์สอบถาม: Logfire ให้สโคปนั้นเฉพาะบนคีย์ที่ผูกกับโปรเจกต์เดียว คีย์ขององค์กรให้ Polylane อ่าน alert และช่องทางแจ้งเตือนที่มีอยู่ของโปรเจกต์ สร้างช่องทางของตัวเอง (Logfire เก็บช่องทางไว้ที่ระดับองค์กร นี่คือเหตุที่คีย์ของโปรเจกต์ทำไม่ได้) และแนบเข้ากับแต่ละ alert เพื่อให้ alert ถึง Polylane ทันทีที่ทำงานและอินซิเดนต์เปิดได้แต่เนิ่นๆ
การตรวจสอบต่อเนื่อง
Polylane ตรวจสอบคีย์ที่เก็บไว้ทั้งสองทุกหกชั่วโมงและติดธงการผสานรวมเมื่อ Logfire ปฏิเสธคีย์ใดคีย์หนึ่งหรือคีย์ขององค์กรไม่แสดงโปรเจกต์อีกต่อไป คีย์ที่ถูกเพิกถอนจึงปรากฏก่อนที่การสืบสวนจะต้องใช้มัน
การยกเลิกการเชื่อมต่อ
ยกเลิกการเชื่อมต่อ Logfire ใน Polylane แล้วเพิกถอนคีย์ API ของโปรเจกต์ใต้ Project settings แล้ว Security & access และคีย์ API ขององค์กรใต้ Org settings แล้ว Security & access ใน Logfire คงคีย์ขององค์กรไว้หากโปรเจกต์อื่นขององค์กรยังเชื่อมต่ออยู่
ยกเลิกการเชื่อมต่อ
การยกเลิกการเชื่อมต่อหยุดทุกการซิงก์และการตรวจสอบ และลบข้อมูลรับรองที่ Polylane เก็บไว้ ทุกสิ่งที่ Polylane ตั้งค่าไว้ใน Logfire ถูกลบด้วยเช่นกัน ไม่มีอะไรหลงเหลือ
polylane integration disconnect <id>เครื่องมือ
5การดำเนินการที่เอเจนต์ทำได้ในเธรด