opentelemetry java instrumentation
Version 2.10.0
การเริ่มต้นใช้งาน • การมีส่วนร่วม • การติดต่อ
การมีส่วนร่วม • ขอบเขต
โปรเจ็กต์นี้จัดเตรียม JAR เอเจนต์ Java ที่สามารถแนบกับแอปพลิเคชัน Java 8+ ใดก็ได้ และแทรกโค้ดไบต์แบบไดนามิกเพื่อบันทึกการวัดและส่งข้อมูลทางไกลจากไลบรารีและเฟรมเวิร์กยอดนิยมจำนวนหนึ่ง คุณสามารถส่งออกข้อมูลการวัดและส่งข้อมูลทางไกลได้หลากหลายรูปแบบ คุณยังสามารถกำหนดค่าเอเจนต์และผู้ส่งออกผ่านอาร์กิวเมนต์บรรทัดคำสั่งหรือตัวแปรสภาพแวดล้อมได้ ผลลัพธ์สุทธิคือความสามารถในการรวบรวมข้อมูลการวัดและส่งข้อมูลทางไกลจากแอปพลิเคชัน Java โดยไม่ต้องเปลี่ยนแปลงโค้ด
พื้นที่เก็บข้อมูลนี้ยังเผยแพร่เครื่องมือวัดแบบสแตนด์อโลนสำหรับหลายไลบรารี (และที่กำลังเติบโต) ซึ่งสามารถใช้ได้หากคุณต้องการมากกว่าการใช้เอเจนต์ Java โปรดดูคอลัมน์เครื่องมือไลบรารีแบบสแตนด์อโลนในไลบรารีที่รองรับ หากคุณกำลังมองหาเอกสารเกี่ยวกับการใช้งานเหล่านั้น
ดาวน์โหลดเวอร์ชันล่าสุด
แพ็คเกจนี้ประกอบด้วยตัวแทนเครื่องมือวัดตลอดจนเครื่องมือวัดสำหรับไลบรารีที่รองรับทั้งหมดและผู้ส่งออกข้อมูลที่มีอยู่ทั้งหมด แพ็คเกจนี้มอบประสบการณ์อัตโนมัติที่สมบูรณ์แบบนอกกรอบ
หมายเหตุ: มีรุ่น 2.x และรุ่น 1.x รุ่น 2.0 มีการเปลี่ยนแปลงที่สำคัญ ดูรายละเอียดได้ในบันทึกประจำรุ่น ขอแนะนำให้ใช้เวอร์ชัน 2.x ล่าสุดซึ่งจะมีคุณสมบัติและการปรับปรุงล่าสุด 1.x จะได้รับแพตช์รักษาความปลอดภัยในระยะเวลาจำกัด และจะไม่รวมการแก้ไขข้อบกพร่องและการปรับปรุงอื่นๆ
เปิดใช้งานเอเจนต์เครื่องมือวัดโดยใช้แฟล็ก -javaagent ไปยัง JVM
java -javaagent:path/to/opentelemetry-javaagent.jar
-jar myapp.jar
ตามค่าเริ่มต้น เอเจนต์ OpenTelemetry Java จะใช้ตัวส่งออก OTLP ที่กำหนดค่าให้ส่งข้อมูลไปยังตัวรวบรวม OpenTelemetry ที่ http://localhost:4318
พารามิเตอร์คอนฟิกูเรชันถูกส่งผ่านเป็นคุณสมบัติระบบ Java (แฟล็ก -D ) หรือเป็นตัวแปรสภาพแวดล้อม ดูเอกสารการกำหนดค่าสำหรับรายการการกำหนดค่าทั้งหมด ตัวอย่างเช่น:
java -javaagent:path/to/opentelemetry-javaagent.jar
-Dotel.resource.attributes=service.name=your-service-name
-Dotel.traces.exporter=zipkin
-jar myapp.jar
ตัวแทนสามารถกำหนดค่าได้สูง! คุณสามารถกำหนดค่าลักษณะการทำงานของตัวแทนได้หลายด้านตามความต้องการของคุณ เช่น ตัวเลือกผู้ส่งออก การกำหนดค่าผู้ส่งออก (เช่น ตำแหน่งที่ส่งข้อมูล) ติดตามส่วนหัวการเผยแพร่บริบท และอื่นๆ อีกมากมาย
สำหรับรายการตัวเลือกการกำหนดค่าตัวแทนโดยละเอียด โปรดดูเอกสารการกำหนดค่าตัวแทน
สำหรับรายการโดยละเอียดของตัวแปรสภาพแวดล้อมการกำหนดค่า SDK เพิ่มเติมและคุณสมบัติของระบบ โปรดดูเอกสารการกำหนดค่า SDK
หมายเหตุ: ชื่อพารามิเตอร์การกำหนดค่ามีแนวโน้มที่จะเปลี่ยนแปลงเมื่อเวลาผ่านไป ดังนั้นโปรดกลับมาตรวจสอบที่นี่เมื่อลองใช้เวอร์ชันใหม่! กรุณารายงานข้อบกพร่องหรือพฤติกรรมที่ไม่คาดคิดที่คุณพบ
เรารองรับไลบรารีและเฟรมเวิร์กจำนวนมากที่น่าประทับใจ รวมถึงเซิร์ฟเวอร์แอปพลิเคชันยอดนิยมส่วนใหญ่...ทันทีที่แกะกล่อง! คลิกที่นี่เพื่อดูรายการทั้งหมดและเรียนรู้เพิ่มเติมเกี่ยวกับเครื่องมือที่ปิดใช้งาน และวิธีการระงับเครื่องมือที่ไม่ต้องการ
ส่วนขยายเพิ่มคุณสมบัติและความสามารถใหม่ให้กับเอเจนต์โดยไม่ต้องสร้างการแจกจ่ายแยกต่างหากหรือแยกพื้นที่เก็บข้อมูลนี้ ตัวอย่างเช่น คุณสามารถสร้างตัวอย่างที่กำหนดเองหรือผู้ส่งออก span ตั้งค่าดีฟอลต์ใหม่ และฝังทั้งหมดไว้ในเอเจนต์เพื่อรับไฟล์ jar ไฟล์เดียว
สำหรับผู้ใช้ส่วนใหญ่ เครื่องมือที่แกะกล่องก็เพียงพอแล้วและไม่ต้องทำอะไรเพิ่มเติม อย่างไรก็ตาม บางครั้งผู้ใช้ต้องการเพิ่มแอตทริบิวต์ให้กับช่วงอัตโนมัติ หรืออาจต้องการสร้างช่วงสำหรับโค้ดที่กำหนดเองของตนเอง
สำหรับคำแนะนำโดยละเอียด โปรดดูที่เครื่องมือวัดด้วยตนเอง
คุณสามารถแทรกข้อมูลการติดตาม เช่น ID การติดตามและการขยาย ID ลงในบันทึกแอปพลิเคชันที่คุณกำหนดเองได้ สำหรับรายละเอียด โปรดดูที่เครื่องมือวัดอัตโนมัติ Logger MDC
หากต้องการเปิดการบันทึกการแก้ไขข้อบกพร่องภายในของตัวแทน:
-Dotel.javaagent.debug=true
หมายเหตุ : บันทึกเหล่านี้มีรายละเอียดมาก เปิดใช้งานการบันทึกการแก้ไขข้อบกพร่องเมื่อจำเป็นเท่านั้น การบันทึกการแก้ไขข้อบกพร่องส่งผลเสียต่อประสิทธิภาพของแอปพลิเคชันของคุณ
ดูการมีส่วนร่วม.md
Triagers (@open-telemetry/java-instrumentation-triagers):
ผู้อนุมัติ (@open-telemetry/java-instrumentation-approvers):
ผู้ดูแล (@open-telemetry/java-instrumentation-maintainers):
ผู้ดูแลเกียรติคุณ:
เรียนรู้เพิ่มเติมเกี่ยวกับบทบาทในที่เก็บชุมชน
ขอบคุณทุกคนที่มีส่วนร่วมแล้ว!
