การอ้างอิงเมตริก มิติข้อมูล และตัวกรองของ Analytics

จำนวนธุรกรรมโดยเฉลี่ยต่อวินาที ซึ่งหมายถึงคำขอพร็อกซี API โปรดทราบว่าหากคุณมีจำนวนธุรกรรมค่อนข้างต่ำในช่วงเวลาหนึ่ง จำนวนการทำธุรกรรมโดยเฉลี่ยต่อวินาทีในรายงานที่กำหนดเองของ UI อาจดูเหมือนเป็น 0 หากตัวเลขมีค่าน้อยกว่า 2 หลัก

ไวยากรณ์ API: tps

จำนวนคำขอ API ที่สำเร็จซึ่งใช้แคชการตอบกลับแทนการตอบกลับจากบริการเป้าหมาย

ไวยากรณ์ API: sum(cache_hit)

แสดงจำนวนองค์ประกอบในแคช L1 (ในหน่วยความจำ) ต่อธุรกรรมในระยะเวลาที่กำหนด ตัวอย่างเช่น หากคุณเลือก max สำหรับช่วงเวลา 1 วัน และภายในวันดังกล่าว จำนวนองค์ประกอบสูงสุดในแคชคือ 12 สำหรับธุรกรรมหนึ่งๆ จำนวนจะเท่ากับ 12 สำหรับ avg หากมีธุรกรรม 3 รายการในระยะเวลาที่คุณค้นหา และจำนวนแคชคือ 5, 6 และ 7 ค่าเฉลี่ยคือ 6 แคช L1 เป็นแคชในหน่วยความจำซึ่งตรงข้ามกับแคชฐานข้อมูล L2 ตามที่อธิบายไว้ในแคชภายใน

ไวยากรณ์ API: avg(ax_cache_l1_count)

จำนวนข้อผิดพลาดด้านนโยบายทั้งหมดในระยะเวลาที่ระบุ

ข้อผิดพลาดของนโยบายมักจะเกิดขึ้นจากการออกแบบ เช่น นโยบาย "ยืนยันคีย์ API" จะแสดงข้อผิดพลาดเมื่อมีการส่งคีย์ API ที่ไม่ถูกต้องในคำขอ และนโยบาย Spike Arrest จะแสดงข้อผิดพลาดหากจำนวนการเรียก API เกินขีดจำกัดที่ระบุไว้ในนโยบาย เมตริกนี้จึงมีประโยชน์ในการหาจุดที่เป็นปัญหาที่อาจเกิดขึ้นใน API เช่น เมตริก policy_error ที่จัดกลุ่มตามมิติข้อมูล developer_app อาจช่วยให้คุณค้นพบว่าคีย์ API หรือโทเค็น OAuth ของแอปหมดอายุแล้ว คุณอาจพบว่าพร็อกซี API ที่ทำให้เกิดข้อผิดพลาดการจับกุมการเพิ่มขึ้นจำนวนมาก ทำให้คุณพบว่าขีดจำกัดการจับกุมที่เพิ่มขึ้นอย่างฉับพลันของพร็อกซีไม่ได้คำนึงถึงการเข้าชมที่เพิ่มขึ้นในวันหยุด

ระบบจะบันทึกข้อผิดพลาดด้านนโยบายไว้ใน Analytics ก็ต่อเมื่อข้อผิดพลาดดังกล่าวส่งผลให้พร็อกซี API ทำงานไม่สำเร็จ เช่น หากตั้งค่าแอตทริบิวต์ continueOnError ของนโยบายเป็น true พร็อกซี API จะประมวลผลคำขอต่อไป แม้ว่านโยบายจะไม่สำเร็จ ในกรณีดังกล่าว ระบบจะไม่บันทึกข้อผิดพลาดของนโยบายลงใน Analytics

มิติข้อมูลชื่อนโยบายเกี่ยวกับข้อผิดพลาด (ax_execution_fault_policy_name) มีประโยชน์ในการจัดกลุ่มข้อผิดพลาดของนโยบายตามชื่อนโยบาย

เป้าหมายที่ล้มเหลว (เช่น 404 หรือ 503) จะไม่นับเป็นความล้มเหลวของนโยบาย การดำเนินการดังกล่าวนับเป็นความล้มเหลวของพร็อกซี API (is_error)

ไวยากรณ์ API: sum(policy_error)

จำนวนครั้งทั้งหมดที่พร็อกซี API ดำเนินการไม่สำเร็จในระยะเวลาที่กำหนด พร็อกซีที่ไม่สำเร็จอาจเกิดขึ้นเมื่อนโยบายล้มเหลวหรือเมื่อรันไทม์ล้มเหลว เช่น 404 หรือ 503 จากบริการเป้าหมาย

มิติข้อมูลพร็อกซี (apiproxy) มีประโยชน์ในการจัดกลุ่มความล้มเหลวของพร็อกซี API ตามพร็อกซี

ไวยากรณ์ API: sum(is_error)

ระยะเวลา (เฉลี่ย ต่ำสุด หรือสูงสุด) หน่วยเป็นมิลลิวินาทีที่ Edge จะประมวลผลคำขอที่เข้ามาใหม่ เวลาจะเริ่มต้นเมื่อคำขอมาถึง Edge และสิ้นสุดเมื่อ Edge ส่งต่อคำขอไปยังบริการเป้าหมาย

เมื่อใช้มิติข้อมูลที่แตกต่างกัน คุณสามารถตรวจสอบเวลาในการตอบสนองของการดำเนินการตามคำขอโดยใช้พร็อกซี API, แอปของนักพัฒนาซอฟต์แวร์, ภูมิภาค และอื่นๆ

ไวยากรณ์ API: max(request_processing_latency)

ขนาดของเพย์โหลดคำขอที่ Edge ได้รับเป็นไบต์

ไวยากรณ์ API: avg(request_size)

จำนวนครั้งทั้งหมดที่มีการใช้นโยบายแคชการตอบกลับในระยะเวลาที่กำหนด

เนื่องจากนโยบายแคชการตอบกลับจะแนบไว้ใน 2 ตำแหน่งในพร็อกซี API (1 ครั้งในคำขอและ 1 ครั้งในการตอบสนอง) จึงมักเรียกใช้ 2 ครั้งในการเรียก API แคช "get" และ "put" แคชจะนับเป็นการดำเนินการ 1 รายการ

อย่างไรก็ตาม การดำเนินการแคชการตอบกลับจะเป็น 0 หากองค์ประกอบ <SkipCacheLookup> ในนโยบายประเมินค่าเป็น True (ในคำขอ) และ 0 หากองค์ประกอบ <SkipCachePopulation> ในนโยบายประเมินค่าเป็นจริง (ในการตอบสนอง)

ในเครื่องมือติดตาม คุณสามารถคลิกไอคอนแคชการตอบกลับในการเรียก API ที่ดำเนินการ และดูตัวแปรโฟลว์ responsecache.executed เพื่อดูว่ามีการดำเนินการแคชหรือไม่ (ค่า 1)

ไวยากรณ์ API: sum(ax_cache_executed)

ระยะเวลา (เฉลี่ย ต่ำสุด หรือสูงสุด) หน่วยเป็นมิลลิวินาทีที่ใช้ Edge ในการประมวลผลการตอบกลับจาก API เวลาจะเริ่มต้นเมื่อพร็อกซี API ได้รับการตอบสนองของบริการเป้าหมายและสิ้นสุดเมื่อ Apigee ส่งต่อการตอบกลับไปยังผู้เรียกใช้เดิม

เมื่อใช้มิติข้อมูลที่แตกต่างกัน คุณสามารถตรวจสอบเวลาในการตอบสนองของการประมวลผลการตอบกลับตามพร็อกซี API, ภูมิภาค และอื่นๆ

ไวยากรณ์ API: min(response_processing_latency)

ขนาดของเปย์โหลดการตอบกลับที่ส่งคืนไปยังไคลเอ็นต์เป็นไบต์

ไวยากรณ์ API: max(response_size)

จำนวนการตอบกลับทั้งหมด 5xx รายการจากบริการเป้าหมาย ข้อผิดพลาดเหล่านี้เป็นข้อผิดพลาดของบริการเป้าหมายที่ไม่ได้เกิดจาก Apigee

ไวยากรณ์ API: sum(target_error)

ระยะเวลา (ผลรวม เฉลี่ย ต่ำสุด หรือสูงสุด) หน่วยเป็นมิลลิวินาทีที่เซิร์ฟเวอร์เป้าหมายจะตอบกลับการโทร เมตริกนี้จะบอกให้ทราบถึงประสิทธิภาพการทำงานของเซิร์ฟเวอร์เป้าหมาย เวลาจะเริ่มต้นเมื่อ Edge ส่งต่อคำขอไปยังบริการเป้าหมาย และจะสิ้นสุดเมื่อ Edge ได้รับการตอบกลับ

โปรดทราบว่าหากการเรียก API ส่งการตอบกลับจากแคช (เช่น ใช้นโยบายแคชการตอบกลับ) การเรียกจะไม่ส่งถึงบริการเป้าหมาย และจะไม่มีการบันทึกเมตริกเวลาตอบสนองเป้าหมาย

ไวยากรณ์ API: avg(target_response_time)

ระยะเวลา (ผลรวม ค่าเฉลี่ย ต่ำสุด หรือสูงสุด) หน่วยเป็นมิลลิวินาทีนับตั้งแต่ที่ Edge ได้รับคำขอจากไคลเอ็นต์จนถึงตอนที่ Edge ส่งการตอบกลับกลับไปยังไคลเอ็นต์ เวลาจะรวมค่าใช้จ่ายของเครือข่าย (เช่น เวลาที่ตัวจัดสรรภาระงานและเราเตอร์ใช้ในการทำงาน) เวลาในการตอบสนองการประมวลผลคำขอ เวลาในการตอบสนองในการประมวลผลการตอบกลับ และเวลาตอบสนองเป้าหมาย (หากการตอบสนองได้รับมาจากบริการเป้าหมายแทนที่จะเป็นแคช)

เมื่อใช้มิติข้อมูลที่แตกต่างกัน คุณสามารถตรวจสอบเวลาในการตอบสนองในการประมวลผลตามพร็อกซี API, แอปของนักพัฒนาซอฟต์แวร์, ภูมิภาค และอื่นๆ

ไวยากรณ์ API: avg(total_response_time)

จำนวนการเรียก API ทั้งหมดที่ประมวลผลโดย Edge ในระยะเวลาที่ระบุ

ใช้มิติข้อมูลเพื่อจัดกลุ่มจำนวนการเข้าชมในวิธีที่มีความหมายกับคุณมากที่สุด

ไวยากรณ์ API: sum(message_count)

ชื่อผลิตภัณฑ์ API ที่มีพร็อกซี API ที่กำลังเรียกใช้ หากต้องการรับมิติข้อมูลนี้ แอปของนักพัฒนาซอฟต์แวร์ที่เรียกใช้จะต้องเชื่อมโยงกับผลิตภัณฑ์ API อย่างน้อย 1 รายการที่มีพร็อกซี API และพร็อกซีที่มีการเรียกใช้ต้องตรวจสอบคีย์ API หรือโทเค็น OAuth ที่ส่งไปพร้อมกับการเรียก API คีย์หรือโทเค็นเชื่อมโยงกับผลิตภัณฑ์ API แล้ว หากต้องการข้อมูลเพิ่มเติม โปรดดูสิ่งที่ต้องทำก่อน: วิธีสร้างข้อมูลวิเคราะห์ที่สมบูรณ์

หากไม่เป็นไปตามเกณฑ์ข้างต้น คุณจะเห็นค่า "(not set)" ดูเพิ่มเติมที่ ค่าเอนทิตีการวิเคราะห์ "(not set)" หมายถึงอะไร

คีย์ที่มีค่าแคชการตอบกลับที่มีการเข้าถึง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างคีย์สำหรับแคชการตอบกลับได้ที่นโยบายแคชการตอบกลับ

ในเครื่องมือติดตาม เมื่อคุณเลือกนโยบายแคชการตอบกลับที่อ่านหรือเขียนข้อมูลลงในแคช คุณจะเห็นค่านี้ในตัวแปรโฟลว์ responsecache.cachekey

ชื่อของแคชที่มีคีย์/ค่าที่นโยบายแคชการตอบกลับใช้ ซึ่งนำหน้าด้วย orgName__envName__ ตัวอย่างเช่น หากองค์กรคือ "foo" สภาพแวดล้อมจะเป็น "test" และชื่อแคชคือ "myCache" ax_cache_name จะเป็น foo__test__myCache

ในเครื่องมือติดตาม เมื่อเลือกนโยบายแคชการตอบกลับ คุณจะเห็นค่านี้ในตัวแปรโฟลว์ responsecache.cachename

ระดับแคช (ในหน่วยความจำ "L1" หรือฐานข้อมูล "L2") ที่มีการดึงข้อมูลแคชการตอบกลับ มิติข้อมูลนี้จะแสดง "CACHE_MISS" ด้วยเมื่อมีการส่งการตอบกลับจากเป้าหมายแทนที่จะเป็นแคช (และรีเฟรชแคชการตอบกลับด้วยการตอบกลับเป้าหมาย) หรือเมื่อคีย์แคชในคำขอไม่ถูกต้อง คีย์แคชต้องมีขนาดไม่เกิน 2 KB

ในเครื่องมือติดตาม เมื่อคุณเลือกนโยบายแคชการตอบกลับ คุณจะเห็นค่านี้ในตัวแปรโฟลว์ responsecache.cachesource

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับระดับแคชที่หัวข้อแคชภายใน

คีย์ผู้ใช้ (คีย์ API) ของแอปนักพัฒนาซอฟต์แวร์ที่ทำการเรียก API ไม่ว่าจะผ่านในคำขอเป็นคีย์ API หรือรวมอยู่ในโทเค็น OAuth

หากต้องการรับมิติข้อมูลนี้ ต้องมีการกำหนดค่าพร็อกซีที่รับการเรียกเพื่อตรวจสอบคีย์ API หรือโทเค็น OAuth ที่ถูกต้อง แอปของนักพัฒนาซอฟต์แวร์จะได้รับคีย์ API ซึ่งใช้สร้างโทเค็น OAuth เมื่อลงทะเบียนแอปใน Edge ได้ หากต้องการข้อมูลเพิ่มเติม โปรดดูสิ่งที่ต้องทำก่อน: วิธีสร้างข้อมูลวิเคราะห์ที่สมบูรณ์

หากไม่เป็นไปตามเกณฑ์ข้างต้น คุณจะเห็นค่า "(not set)" ดูข้อมูลเพิ่มเติมได้ในค่าเอนทิตีการวิเคราะห์ "(not set)" หมายถึงอะไร

แอปของนักพัฒนาแอปที่ลงทะเบียน Edge ซึ่งเรียกใช้ API

หากต้องการรับมิติข้อมูลนี้ แอปต้องเชื่อมโยงกับผลิตภัณฑ์ API อย่างน้อย 1 รายการซึ่งมีพร็อกซี API ที่กำลังเรียกใช้ และพร็อกซีต้องตรวจหาคีย์ API หรือโทเค็น OAuth ที่ส่งไปพร้อมกับการเรียก API คีย์หรือโทเค็นจะระบุแอปของนักพัฒนาซอฟต์แวร์ สำหรับข้อมูลเพิ่มเติม โปรดดูสิ่งที่ต้องทำก่อน: วิธีสร้างข้อมูลการวิเคราะห์ที่สมบูรณ์

หากไม่เป็นไปตามเกณฑ์ข้างต้น คุณจะเห็นค่า "(not set)" ดูข้อมูลเพิ่มเติมได้ในค่าเอนทิตีการวิเคราะห์ "(not set)" หมายถึงอะไร

อีเมลของนักพัฒนาซอฟต์แวร์ที่ลงทะเบียน Edge ซึ่งแอปได้เรียก API

นักพัฒนาซอฟต์แวร์ต้องมีแอปที่เชื่อมโยงกับผลิตภัณฑ์ API อย่างน้อย 1 รายการซึ่งมีพร็อกซี API ที่กำลังเรียกใช้ และพร็อกซีต้องตรวจสอบคีย์ API หรือโทเค็น OAuth ที่ส่งไปพร้อมกับการเรียก API เพื่อให้ได้รับมิติข้อมูลนี้ คีย์หรือโทเค็นจะระบุแอปของนักพัฒนาซอฟต์แวร์ สำหรับข้อมูลเพิ่มเติม โปรดดูสิ่งที่ต้องทำก่อน: วิธีสร้างข้อมูลการวิเคราะห์ที่สมบูรณ์

หากไม่เป็นไปตามเกณฑ์ข้างต้น คุณจะเห็นค่า "(not set)" ดูข้อมูลเพิ่มเติมได้ในค่าเอนทิตีการวิเคราะห์ "(not set)" หมายถึงอะไร

รหัสนักพัฒนาซอฟต์แวร์ Edge ที่ไม่ซ้ำกันซึ่งสร้างในรูปแบบ org_name@@@unique_id

นักพัฒนาซอฟต์แวร์ต้องมีแอปที่เชื่อมโยงกับผลิตภัณฑ์ API อย่างน้อย 1 รายการที่มีพร็อกซี API ที่กำลังเรียกใช้อยู่ และพร็อกซีต้องตรวจหาคีย์ API หรือโทเค็น OAuth ที่ส่งไปพร้อมกับการเรียก API เพื่อให้ได้รับมิติข้อมูลนี้ คีย์หรือโทเค็นจะระบุนักพัฒนาแอป หากต้องการทราบข้อมูลเพิ่มเติม โปรดดูสิ่งที่ต้องทำก่อน: วิธีสร้างข้อมูลวิเคราะห์ที่สมบูรณ์

หากไม่เป็นไปตามเกณฑ์ข้างต้น คุณจะเห็นค่า "(not set)" ดูข้อมูลเพิ่มเติมได้ในค่าเอนทิตีการวิเคราะห์ "(not set)" หมายถึงอะไร

รหัสข้อผิดพลาดของข้อผิดพลาด ตัวอย่างเช่น messaging.adaptors.http.flow.GatewayTimeout

flow ที่มีชื่อในพร็อกซี API ที่ทำให้เกิดข้อผิดพลาด เช่น "PreFlow" "PostFlow" หรือชื่อของโฟลว์แบบมีเงื่อนไขที่คุณสร้างขึ้น

โปรดทราบว่าชื่อเต็มที่จะใช้ใน API การจัดการคือ ax_execution_fault_flow_name โดยไม่มีการขึ้นบรรทัดใหม่

คุณจะเห็นค่า "(not set)" ในตำแหน่งที่ไม่มีข้อผิดพลาด

ชื่อของโฟลว์พร็อกซี API จะทำให้เกิดข้อผิดพลาด เช่น "PROXY_REQ_FLOW" หรือ "TARGET_RESP_FLOW"

โปรดทราบว่าชื่อเต็มที่จะใช้ใน API การจัดการคือ ax_execution_fault_flow_state โดยไม่มีตัวแบ่งบรรทัด

ชื่อของนโยบายที่เกิดข้อผิดพลาดและทำให้เรียก API ไม่สำเร็จ

โปรดทราบว่าชื่อเต็มที่จะใช้ใน API การจัดการคือ ax_execution_fault_policy_name โดยไม่มีการขึ้นบรรทัดใหม่

หากนโยบายแสดงข้อผิดพลาด แต่มีการตั้งค่าแอตทริบิวต์รูทของนโยบาย continueOnError เป็น true โฟลว์พร็อกซีของ API จะดำเนินต่อไปโดยไม่ล้มเหลว และระบบจะไม่นับความล้มเหลวของนโยบายในมิติข้อมูลนี้

BasePath ที่กำหนดค่าบนพร็อกซี API ProxyEndpoint เส้นทางฐานไม่รวมโดเมนและส่วนพอร์ตของ URL พร็อกซี API ตัวอย่างเช่น หาก URL หลักของพร็อกซี API คือ https://apigeedocs-test.apigee.net/releasenotes/ เส้นทางฐานจะเป็น /releasenotes

ค่านี้ยังจัดเก็บอยู่ใน ตัวแปรโฟลว์ proxy.basepath ด้วย

เส้นทางทรัพยากรที่เพิ่มลงในเส้นทางฐานพร็อกซี API ตัวอย่างเช่น หาก URL พื้นฐานของพร็อกซี API คือ https://apigeedocs-test.apigee.net/hello/ และมีการเรียกไปยัง https://apigeedocs-test.apigee.net/hello/json เส้นทางของพร็อกซีจะเป็น /json

หากไม่มีการใช้เส้นทางต่อท้าย ค่าจะว่างเปล่า

ค่านี้ยังจัดเก็บอยู่ใน ตัวแปรโฟลว์ proxy.pathsuffix ด้วย

มีที่อยู่ IP ของไคลเอ็นต์ต้นทาง ค่าของมิติข้อมูล ax_resolved_client_ip คำนวณจากค่าในมิติข้อมูล ax_true_client_ip และ x_forwarded_for_ip

โปรดทราบว่าเมื่อใช้การกำหนดเส้นทางผลิตภัณฑ์ เช่น Akamai เพื่อบันทึกที่อยู่ IP ที่แท้จริงของไคลเอ็นต์ ระบบจะส่ง IP ของไคลเอ็นต์ไปยัง Edge ในส่วนหัว HTTP True-Client-IP ซึ่งจะนำไปใช้เพื่อตั้งค่ามิติข้อมูล ax_true_client_ip

ค่าของมิติข้อมูล ax_resolved_client_ip คํานวณได้ดังนี้

1. หาก ax_true_client_ip ไม่ได้เป็นค่าว่างและไม่มีที่อยู่ IP ในเครื่อง ให้ตั้งค่า ax_resolved_client_ip เป็น ax_true_client_ip
2. ไม่เช่นนั้น ให้ตั้งค่า ax_resolved_client_ip เป็นที่อยู่ IP แรกที่ไม่ใช่ภายในเครื่องใน x_forwarded_for_ip
3. หากทั้ง ax_true_client_ip และ x_forwarded_for_ip มีที่อยู่ IP ในเครื่องเท่านั้น ให้ตั้งค่า ax_resolved_client_ip เป็นที่อยู่ IP ภายในเครื่องแรกใน x_forwarded_for_ip
4. หากทั้ง ax_true_client_ip และ x_forwarded_for_ip เป็นค่าว่าง ให้ตั้งค่า ax_resolved_client_ip เป็น (not set)
5. หาก ax_true_client_ip เป็นที่อยู่ IP ในเครื่องและ x_forwarded_for_ip เป็นค่าว่าง ให้ตั้งค่า ax_resolved_client_ip เป็น (not set)

เวอร์ชันระบบปฏิบัติการของอุปกรณ์ที่โทรออก

การใช้รายการนี้เป็นมิติข้อมูล "เจาะลึก" รายการที่ 2 กับ OS Family (ax_ua_os_family) เพื่อดูเวอร์ชันของระบบปฏิบัติการ

ที่อยู่ IP ของไคลเอ็นต์ที่เรียกใช้ ซึ่งจัดเก็บไว้ในตัวแปรโฟลว์ proxy.client.ip ซึ่งมักจะเป็นที่อยู่ X-Forwarded-For ของสายเรียกเข้า ซึ่งเป็นที่อยู่ IP Edge ที่ได้รับจากแฮนด์เชค TCP ภายนอกครั้งล่าสุด ซึ่งอาจเป็นไคลเอ็นต์การโทรหรือตัวจัดสรรภาระงาน เมื่อมี IP หลายรายการในส่วนหัว X-Forwarded-For นี่คือ IP สุดท้ายที่แสดง

เมื่อใช้การกำหนดเส้นทางผลิตภัณฑ์ เช่น Akamai เพื่อบันทึกที่อยู่ IP ที่แท้จริงของไคลเอ็นต์ ระบบจะส่ง IP ของไคลเอ็นต์ไปยัง Edge ในส่วนหัว HTTP True-Client-IP มิติข้อมูลนี้จะบันทึก IP จริงของไคลเอ็นต์เหล่านั้นจากส่วนหัวนั้น

Edge จะใช้มิติข้อมูล ax_true_client_ip และ x_forwarded_for_ip เพื่อระบุที่อยู่ IP ของไคลเอ็นต์เดิมที่เข้าถึงผ่านมิติข้อมูล ax_resolved_client_ip

เส้นทางทรัพยากร (ไม่รวมโดเมน) ไปยังบริการเป้าหมาย โดยไม่รวมพารามิเตอร์การค้นหา

ตัวอย่างเช่น เป้าหมายตัวอย่างของ Apigee คือ http://mocktarget.apigee.net มีทรัพยากรหลายรายการ รวมถึง /user ซึ่งแสดงผลคำทักทาย ไม่ว่าพร็อกซี API จะเรียกใช้ http://mocktarget.apigee.net/user อย่างไร request_path จะเป็น /user

เส้นทางทรัพยากร (ไม่รวมโดเมน) ไปยังบริการเป้าหมาย รวมถึงพารามิเตอร์การค้นหา

ตัวอย่างเช่น เป้าหมายตัวอย่าง Apigee ของ http://mocktarget.apigee.net มีทรัพยากรหลายรายการ รวมถึงทรัพยากรและพารามิเตอร์การค้นหา /user?user={name} รายการเพื่อส่งคําทักทายที่กําหนดเองกลับไปยังชื่อที่ระบุ ไม่ว่าพร็อกซี API จะเรียกใช้ http://mocktarget.apigee.net/user?user=Dude อย่างไร request_uri จะเป็น /user?user=Dude

ชื่อของ User Agent หรือ Software Agent ที่ใช้เรียก API ตัวอย่าง

• Pixel XL โทรออกผ่าน Chrome: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36
• iPad ที่โทรออกผ่าน Chrome: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1
• cURL จากเทอร์มินัล: curl/7.51.0

เวอร์ชันของ Useragent

การใช้รายการนี้เป็นมิติข้อมูล "เจาะลึก" รายการที่ 2 กับกลุ่ม User Agent (ax_ua_agent_family) เพื่อรับเวอร์ชันของกลุ่ม Agent

เส้นทางทรัพยากร (ไม่รวมโดเมน) ไปยังบริการเป้าหมาย (ไม่รวมพารามิเตอร์การค้นหา) ที่กำหนดไว้ใน <TargetEndpoint> ของพร็อกซี

ตัวอย่างเช่น สมมติว่าพร็อกซี API เรียกเป้าหมายต่อไปนี้

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

ในตัวอย่างนี้ target_basepath คือ /user

หากเป้าหมายคือ:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

target_basepath จะเป็น Null

ในเครื่องมือติดตาม เมื่อคุณเลือกไอคอน AX ที่ท้ายแผนภาพโฟลว์แล้ว ตัวแปรโฟลว์ target.basepath จะแมปกับมิติข้อมูล target_basepath

รหัสสถานะการตอบกลับ HTTP ที่บริการเป้าหมายส่งคืนไปยังพร็อกซี API เช่น 200, 404, 503 และอื่นๆ

ค่า "null" หมายความว่าคำขอไม่เคยไปถึงบริการเป้าหมาย ข้อผิดพลาดนี้เกิดขึ้นเมื่อระบบแสดงการตอบกลับโดยนโยบายแคชการตอบกลับหรือเมื่อการประมวลผลคำขอล้มเหลว

ซึ่งแตกต่างจากมิติข้อมูลรหัสสถานะการตอบกลับ (response_status_code)

URL แบบเต็มของบริการเป้าหมายที่กำหนดไว้ใน TargetEndpoint ของพร็อกซี API

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

ในตัวอย่างนี้ target_url คือ http://mocktarget.apigee.net/user?user=Dude

โปรดทราบว่าคุณยังลบล้าง URL ได้ในระหว่างการประมวลผลพร็อกซี API ด้วยตัวแปรโฟลว์ target.url

ในเชนพร็อกซีและเมื่อใช้เป้าหมายสคริปต์ (Node.js) target_url ในพร็อกซีการเรียกใช้จะเป็นค่าว่าง

รายการที่อยู่ IP ในส่วนหัว X-Forwarded-For

Edge จะใช้มิติข้อมูล ax_true_client_ip และ x_forwarded_for_ip เพื่อระบุที่อยู่ IP ของไคลเอ็นต์เดิมที่เข้าถึงผ่านมิติข้อมูล ax_resolved_client_ip

ชั่วโมงแบบ 2 หลักที่มีการเรียก API ตามระบบเวลา 24 ชั่วโมง เช่น การเรียก API ที่เกิดขึ้นในชั่วโมงระหว่าง 22:00 น. ถึง 23:00 น. ax_hours_of_day จะเป็น 22

ค่าเวลาอยู่ในเขตเวลา UTC