ส่วนขยาย Google Stackdriver Logging

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X
ข้อมูล

เวอร์ชัน 1.2.1

เขียนรายการลงในบันทึก Stackdriver Logging

เนื้อหานี้ให้ข้อมูลอ้างอิงสำหรับการกำหนดค่าและใช้ส่วนขยายนี้

ข้อกำหนดเบื้องต้น

ก่อนใช้ส่วนขยายนี้จากพร็อกซี API คุณต้องดำเนินการดังนี้

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

  2. ใช้คอนโซล GCP เพื่อสร้างคีย์สำหรับบัญชีบริการ

  3. ใช้เนื้อหาของไฟล์ 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 ซึ่งสร้างขึ้นจากไฟล์คีย์บัญชีบริการ ไม่มี ใช่