คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล
เวอร์ชัน 1.2.1
เขียนรายการลงในบันทึก Stackdriver Logging
เนื้อหานี้ให้ข้อมูลอ้างอิงสำหรับการกำหนดค่าและใช้ส่วนขยายนี้
ข้อกำหนดเบื้องต้น
ก่อนใช้ส่วนขยายนี้จากพร็อกซี API คุณต้องดำเนินการดังนี้
ใน IAM ให้มอบสิทธิ์การบันทึก > ผู้เขียนบันทึกให้กับสมาชิกโปรเจ็กต์ ซึ่งจะเป็นตัวแทนส่วนขยายของคุณไปยังระบบการบันทึกของ Stackdriver โปรดดูวิธีการมอบบทบาทที่หัวข้อการให้บทบาทแก่บัญชีบริการสำหรับทรัพยากรเฉพาะ ดูข้อมูลเพิ่มเติมเกี่ยวกับบทบาทการบันทึกได้ที่คู่มือควบคุมการเข้าถึง
ใช้เนื้อหาของไฟล์ JSON คีย์ที่ได้มาเมื่อเพิ่มและกำหนดค่าส่วนขยายโดยใช้การอ้างอิงการกำหนดค่า
เกี่ยวกับ Stackdriver Logging
Stackdriver Logging เป็นส่วนหนึ่งของชุดผลิตภัณฑ์ใน Google Cloud Platform (GCP) โดยมีพื้นที่เก็บข้อมูลสำหรับบันทึก อินเทอร์เฟซผู้ใช้ที่เรียกว่าเครื่องมือดูบันทึก และ API สำหรับจัดการบันทึกแบบเป็นโปรแกรม เมื่อใช้การบันทึก Stackdriver คุณจะอ่านและเขียนรายการบันทึก ค้นหา และกรองบันทึก ส่งออกบันทึก และสร้างเมตริกตามบันทึกได้
ส่วนขยายนี้เขียนรายการลงในบันทึกอยู่ในขณะนี้
ดูข้อมูลเพิ่มเติมได้ที่เอกสารของStackdriver Logging
ลองฟัง
ตัวอย่างต่อไปนี้จะแสดงวิธีกำหนดค่าการสนับสนุนสำหรับการทำงานของส่วนขยาย Stackdriver Logging โดยใช้นโยบายส่วนขยายไฮไลต์
บันทึกส่วนกลาง
นโยบายต่อไปนี้จะเขียนข้อความ "นี่คือการทดสอบ" ลงในบันทึกที่เรียกว่า example-log ในทรัพยากรของ Stackdriver Global ในการใช้งานจริง คุณอาจมีข้อความอยู่ในตัวแปรโฟลว์ซึ่งมีค่าที่คุณตั้งไว้ที่อื่นในพร็อกซี API
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Logging-Extension">
<DisplayName>Logging Connector</DisplayName>
<Connector>stackdriver-extension-sample</Connector>
<Action>log</Action>
<Input><![CDATA[{
"logName": "example-log",
"metadata": {
"resource": {
"type": "global",
"labels": {
"project_id": "my-test"
}
}
},
"message": "This is a test."
}]]></Input>
</ConnectorCallout>
เนื้อหานี้ให้ข้อมูลอ้างอิงสำหรับการกำหนดค่าและใช้ส่วนขยายนี้ โปรดดูขั้นตอนการกำหนดค่าส่วนขยายโดยใช้คอนโซล Apigee ในการเพิ่มและการกำหนดค่าส่วนขยาย
การดำเนินการ
log
เขียนข้อความไปยังบันทึก
การดำเนินการนี้จะเขียนรายการบันทึก Stackdriver รายการบันทึกจะประกอบด้วยข้อมูลเมตาและข้อมูลรายการ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับรายการบันทึกที่หัวข้อข้อมูลอ้างอิงรายการ โปรดดูข้อมูลเกี่ยวกับเนื้อหาของพร็อพเพอร์ตี้ metadata
ที่ออบเจ็กต์ LogEntry ในเอกสาร Stackdriver Logging
ไวยากรณ์
<Action>log</Action>
<Input><![CDATA[{
"logName" : "stackdriver-log-name-to-use",
"metadata" : JSON-structured-metadata,
"message" : "data-to-log-as-entry"
}]]></Input>
ตัวอย่าง: สตริง
<Action>log</Action>
<Input><![CDATA[{
"logName" : "example-log",
"metadata" : { "resource" : { "type" : "global" } },
"message": "This is a test."
}]]></Input>
เช่น JSON
<Action>log</Action>
<Input><![CDATA[{
"logName" : "example-log",
"metadata" : { "resource" : { "type" : "global" } },
"message" : { "info" : "This is a test." }
}]]></Input>
พารามิเตอร์คำขอ
พารามิเตอร์ | คำอธิบาย | Type | ค่าเริ่มต้น | จำเป็น |
---|---|---|---|---|
logName | ชื่อของบันทึกที่เป็นเจ้าของรายการนี้ | สตริง | ไม่มี | ใช่ |
ข้อมูลเมตา | ข้อมูลเมตาเกี่ยวกับรายการบันทึก ดูข้อมูลเพิ่มเติมและตัวเลือกเกี่ยวกับการตั้งค่า type และ labels ใน metadata ได้ที่ MonitoredResource |
JSON | ไม่มี | ไม่มี |
ข้อความ | ข้อมูลที่จะใช้เป็นค่าสำหรับรายการบันทึกนี้ คุณจะระบุสตริงง่ายๆ หรือใช้ JSON เพื่อบันทึกข้อความที่มีโครงสร้างเพิ่มเติมก็ได้ | สตริงหรือ JSON | ไม่มี | ใช่ |
คำตอบ
ไม่มีหากมีการเขียนข้อความไปยังบันทึก มิฉะนั้น คำขอจะแสดงผลข้อผิดพลาด โปรดดูเพิ่มเติมที่การแก้ไขข้อบกพร่องของส่วนขยาย
ข้อมูลอ้างอิงการกำหนดค่า
ใช้ข้อมูลต่อไปนี้เมื่อคุณกำหนดค่าและทำให้ส่วนขยายนี้ใช้งานได้ เพื่อใช้ในพร็อกซี API
คุณสมบัติส่วนขยายที่พบบ่อย
พร็อพเพอร์ตี้ต่อไปนี้มีอยู่ในส่วนขยายทุกรายการ
พร็อพเพอร์ตี้ | คำอธิบาย | ค่าเริ่มต้น | ต้องระบุ |
---|---|---|---|
name |
ชื่อที่คุณกําหนดให้การกําหนดค่านี้ของส่วนขยาย | ไม่มี | ได้ |
packageName |
ชื่อแพ็กเกจส่วนขยายที่ระบุโดย Apigee Edge | ไม่มี | ได้ |
version |
หมายเลขเวอร์ชันของแพ็กเกจส่วนขยายที่คุณกําหนดค่าส่วนขยาย | ไม่มี | ได้ |
configuration |
ค่าการกําหนดค่าเฉพาะสําหรับส่วนขยายที่คุณกําลังเพิ่ม ดูพร็อพเพอร์ตี้สําหรับแพ็กเกจส่วนขยายนี้ | ไม่มี | ได้ |
พร็อพเพอร์ตี้สำหรับแพ็กเกจส่วนขยายนี้
ระบุค่าสำหรับพร็อพเพอร์ตี้การกำหนดค่าต่อไปนี้ที่เจาะจงสำหรับส่วนขยายนี้
พร็อพเพอร์ตี้ | คำอธิบาย | ค่าเริ่มต้น | จำเป็น |
---|---|---|---|
projectId | รหัสโปรเจ็กต์ GCP ที่ควรสร้างบันทึก | ไม่มี | ใช่ |
ข้อมูลเข้าสู่ระบบ | ซึ่งเมื่อป้อนในคอนโซล Apigee Edge คือเนื้อหาในไฟล์คีย์บัญชีบริการ เมื่อส่งผ่าน API การจัดการ ค่าดังกล่าวคือค่าที่เข้ารหัสแบบ Base64 ซึ่งสร้างขึ้นจากไฟล์คีย์บัญชีบริการ | ไม่มี | ใช่ |