ส่วนขยาย Google Stackdriver Logging

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

เวอร์ชัน 1.3.7

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

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

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

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

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

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

3. ใช้เนื้อหาของไฟล์ JSON คีย์ที่ได้มาเมื่อเพิ่มและกำหนดค่าส่วนขยายโดยใช้การอ้างอิงการกำหนดค่า

ส่วนขยายนี้สนับสนุนให้เรียกโดยนโยบาย Extensionส่วนขยายไฮไลต์ที่อยู่ใน PostClientFlow หากต้องการใช้นโยบาย Extension callout เพื่อเรียกใช้ส่วนขยายนี้จาก PostClientFlow โปรดตรวจสอบว่าได้ตั้งค่าแฟล็ก features.allowExtensionsInPostClientFlow เป็น true ในองค์กร

• หากคุณเป็นลูกค้า Apigee Edge สำหรับระบบคลาวด์สาธารณะ คุณต้องติดต่อทีมสนับสนุนของ Apigee Edge เพื่อให้แน่ใจว่าการตั้งค่าแฟล็ก features.allowExtensionsInPostClientFlow เป็น true ในองค์กรของคุณ

• หากคุณเป็น Apigee Edge สำหรับลูกค้าของ Private Cloud ให้ใช้ API อัปเดตพร็อพเพอร์ตี้ขององค์กรเพื่อตั้งค่าแฟล็ก features.allowExtensionsInPostClientFlow เป็น true

เกี่ยวกับ 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" : "stackdriver-log-name-to-use",
  "metadata" : { "resource" : { "type" : "global" } },
  "message" : "data-to-log-as-entry"
}]]></Input>

พารามิเตอร์คำขอ

คำตอบ

ไม่มีหากมีการเขียนข้อความไปยังบันทึก มิฉะนั้น คำขอจะแสดงผลข้อผิดพลาด โปรดดูเพิ่มเติมที่การแก้ไขข้อบกพร่องของส่วนขยาย

ข้อมูลอ้างอิงการกำหนดค่า

ใช้ข้อมูลต่อไปนี้เมื่อคุณกำหนดค่าและทำให้ส่วนขยายนี้ใช้งานได้ เพื่อใช้ในพร็อกซี API

คุณสมบัติส่วนขยายที่พบบ่อย

พร็อพเพอร์ตี้ต่อไปนี้มีอยู่ในส่วนขยายทุกรายการ

พร็อพเพอร์ตี้สำหรับแพ็กเกจส่วนขยายนี้

ระบุค่าสำหรับพร็อพเพอร์ตี้การกำหนดค่าต่อไปนี้ที่เจาะจงสำหรับส่วนขยายนี้