Edge for Private Cloud v4.18.01
ลูกค้า Edge สำหรับ Private Cloud ทั้งหมดต้องส่งสถิติเกี่ยวกับ API ไปยัง Apigee การรับส่งข้อมูลผ่านพร็อกซี Apigee แนะนำให้ลูกค้าอัปโหลดข้อมูลดังกล่าววันละครั้ง โดยทำได้ดังนี้ สร้างงาน Cron
คุณต้องส่งข้อมูลสําหรับการติดตั้งใช้งาน API เวอร์ชันที่ใช้งานจริง แต่ไม่ต้องส่งสําหรับ API ที่อยู่ในระหว่างการพัฒนาหรือการติดตั้งใช้งานการทดสอบ ในการติดตั้ง Edge ส่วนใหญ่ คุณจะกำหนดองค์กรหรือสภาพแวดล้อมที่เฉพาะเจาะจงสำหรับ API เวอร์ชันที่ใช้งานจริง ข้อมูลที่ส่งมีไว้สำหรับองค์กรและสภาพแวดล้อมเวอร์ชันที่ใช้งานจริงเท่านั้น
Apigee เป็นผู้ช่วยในการอัปโหลดข้อมูลนี้ที่มีบรรทัดคำสั่ง apigee-analytics-collector ให้กับเวอร์ชันเบต้า ยูทิลิตี ยูทิลิตีนี้จะส่งรายงานปริมาณการเรียก API กลับไปยัง Apigee Edge ทั้งหมดสําหรับการติดตั้ง Private Cloud สามารถใช้ยูทิลิตีนี้เพื่อดึงข้อมูลและรายงานข้อมูลการเข้าชมไปยัง Apigee
การเข้าถึงข้อมูลที่อัปโหลดโดย apigee-analytics-collector
หลังจากอัปโหลดข้อมูลด้วยยูทิลิตี apigee-analytics-collector แล้ว คุณสามารถดูได้ใน Apigee 360
หากต้องการดูข้อมูล ให้เข้าสู่ระบบ Apigee 360 แล้วเลือกตัวเลือกการใช้งาน หน้าการใช้งานจะแสดงกราฟการใช้งานและตารางข้อมูลการใช้งาน องค์กร Edge
การติดตั้ง apigee-analytics-collector
apigee-analytics-collector ยูทิลิตีคือ RPM ที่คุณติดตั้งโดยใช้ยูทิลิตี apigee-service
ติดตั้งที่ใด
โหนดที่คุณติดตั้งยูทิลิตี apigee-analytics-collector อาจเป็นโหนดใดก็ได้ โหนดที่เข้าถึง Edge Management API ในเซิร์ฟเวอร์การจัดการ Edge ได้ คุณสามารถติดตั้งได้โดยตรงในเซิร์ฟเวอร์การจัดการ ในโหนดอื่นของการติดตั้ง Edge หรือในโหนดแยกต่างหาก ตราบใดที่โหนดนั้นส่งคําขอ API ไปยังเซิร์ฟเวอร์การจัดการได้
การเข้าถึงอินเทอร์เน็ต ข้อกำหนด
ติดตั้งยูทิลิตี apigee-analytics-collector ใน เครื่องที่มีการเข้าถึงอินเทอร์เน็ตภายนอก จากนั้นยูทิลิตี apigee-analytics-collector จะอัปโหลดได้ ข้อมูลไปยัง Apigee โดยตรง
หากไม่มีโหนดที่มีทั้งสิทธิ์เข้าถึง Edge Management API ในเซิร์ฟเวอร์การจัดการ Edge และสิทธิ์เข้าถึงอินเทอร์เน็ตภายนอก คุณจะใช้ Edge Management API เพื่อบันทึกข้อมูลการเข้าชมในเครื่องได้ จากนั้นคุณต้องโอนข้อมูลไปยังเครื่องที่มีการเข้าถึงอินเทอร์เน็ตเพื่ออัปโหลดไปยัง Apigee ในกรณีนี้ คุณไม่จําเป็นต้องใช้ยูทิลิตี apigee-analytics-collector โปรดดู การอัปโหลดข้อมูลด้วยตนเองไปยัง Apigee ด้านล่างเพื่อดูข้อมูลเพิ่มเติม
การติดตั้ง
ใช้คำสั่งต่อไปนี้เพื่อติดตั้งยูทิลิตี apigee-analytics-collector เพราะ คุณกำลังติดตั้งไฟล์ RPM คำสั่งนี้ต้องเรียกใช้โดยผู้ใช้รากหรือโดยผู้ใช้ที่มี การเข้าถึง sudo แบบเต็ม สำหรับการเข้าถึง sudo แบบเต็ม หมายความว่าผู้ใช้มีสิทธิ์เข้าถึง sudo เพื่อดำเนินการเดียวกัน เป็นราก
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector install
กำลังเรียกใช้ apigee-analytics-collector
ส่วนนี้จะอธิบายวิธีเรียกใช้ยูทิลิตี apigee-analytics-collector
กำหนดค่าผู้ใช้เพื่อเรียกใช้ apigee-analytics-collector
คุณต้องเรียกใช้ apigee-analytics-collector เป็นค่าเริ่มต้น ผู้ใช้ ผู้ใช้รายนี้ต้องมีสิทธิ์ sudo แบบเต็มสำหรับผู้ใช้ "apigee"
หากต้องการกำหนดค่าให้ผู้ใช้มีสิทธิ์เข้าถึงแบบ sudo เต็มรูปแบบสำหรับผู้ใช้ "apigee" ให้ใช้คำสั่ง "visudo" เพื่อแก้ไขไฟล์ sudoers เพื่อเพิ่มข้อมูลต่อไปนี้
analyticsUser ALL=(apigee) NOPASSWD: ALL
โดยที่ analyticsUser คือชื่อผู้ใช้ของบุคคลที่ทำงาน ยูทิลิตี apigee-analytics-collector
หลังจากติดตั้งยูทิลิตี apigee-analytics-collector และกำหนดค่าผู้ใช้แล้ว คุณสามารถทดสอบยูทิลิตีได้โดยเรียกใช้คำสั่ง help สำหรับยูทิลิตี apigee-analytics-collector ดังนี้
> /opt/apigee/apigee-service/bin/ apigee-service apigee-analytics-collector export traffic --help
ข้อมูลที่จำเป็นในการเรียกใช้ apigee-analytics-collector
คุณต้องมีข้อมูลต่อไปนี้เพื่อเรียกใช้คำสั่ง apigee-analytics-collector และ ส่งต่อข้อมูลไปยัง Apigee:
- apigee_mgmt_api_uri: URL พื้นฐานของ Edge API ในเซิร์ฟเวอร์การจัดการ โดยปกติแล้ว URL นี้จะอยู่ในรูปแบบ
http://ms_IP:8080/v1
โดยที่ ms_IP คือที่อยู่ IP หรือเซิร์ฟเวอร์การจัดการ และ 8080 คือ พอร์ตที่ Edge API ใช้ หากคุณสร้างรายการ DNS สำหรับ Edge API URL จะอยู่ใน แบบฟอร์ม:
http://ms_DNS/v1
หากคุณเปิดใช้ TLS ใน Edge Management API การเปลี่ยนแปลงนี้จะอยู่ในรูปแบบ:
https://ms_IP:8080/v1
https://ms_DNS/v1 - apigee_mgmt_api_email: อีเมลของบัญชีที่มีสิทธิ์เข้าถึง API /stats ของ Edge มักจะเป็นเช่นนี้ จะเป็นอีเมลของผู้ดูแลระบบ Edge หรืออีเมลของผู้ดูแลระบบองค์กร สำหรับองค์กรที่ใช้งานจริง
- apigee_mgmt_api_password: รหัสผ่าน Edge สำหรับบัญชีที่ระบุโดย apigee_mgmt_api_email
- apigee_analytics_client_id และ apigee_analytics_secret: ข้อมูลเข้าสู่ระบบสําหรับอัปโหลดข้อมูลไปยัง Apigee โปรดส่งตั๋วกับทีมสนับสนุนของ Apigee เพื่อรับ apigee_analytics_client_id และ apigee_analytics_secret
คำสั่งตัวอย่าง
ด้านล่างนี้คือตัวอย่างคําสั่งในการดึงข้อมูลการเข้าชมสําหรับองค์กรและสภาพแวดล้อมทั้งหมดในการติดตั้ง Edge และอัปโหลดข้อมูลดังกล่าวไปยัง Apigee โปรดสังเกตว่าคุณใช้ apigee-service เพื่อเรียกใช้คําสั่ง apigee-analytics-collector อย่างไร
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
โปรดสังเกตว่าคำสั่งมีข้อมูลที่จำเป็นทั้งหมด เช่น apigee_analytics_client_id และ apigee_analytics_secret.
คุณควรเห็นผลลัพธ์ในแบบฟอร์ม:
[ { "org": "myOrg", "env": "prod", "time_range_start": "08/27/2016 00:00", "time_range_end": "08/30/2016 00:00", "response": [ { "store_org_env_metrics_hourly_v4": 1 } ] }, { "org": "VALIDATE", "env": "test", "time_range_start": "08/27/2016 00:00", "time_range_end": "08/30/2016 00:00", "response": [ { "store_org_env_metrics_hourly_v4": 1 } ] } ]
ใช้ตัวเลือกบรรทัดคำสั่งกับคำสั่งเพื่อควบคุมการดำเนินการ ใช้ตัวเลือกต่อไปนี้เพื่อ ระบุองค์กรและสภาพแวดล้อมที่จะรวมไว้ในข้อมูลที่สร้างขึ้น
- -i, --include_orgs <รายการที่คั่นด้วยเครื่องหมายจุลภาค>
- -x, --exclude_orgs <รายการที่คั่นด้วยเครื่องหมายจุลภาค>
- -n, --include_envs <รายการที่คั่นด้วยเครื่องหมายจุลภาค>
- -e, --exclude_envs <comma-separated list of items>
ตัวอย่างเช่น หากต้องการระบุเฉพาะองค์กรและสภาพแวดล้อมที่ใช้งานจริง ให้ใช้เมธอด ตัวเลือก -i (หรือ --include_orgs) และ -n (หรือ --include_envs) มีดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
ในตัวอย่างนี้ คุณรวบรวมข้อมูลจากสภาพแวดล้อมการใช้งานของ myOrg เท่านั้น
หากต้องการส่งออกข้อมูลไปยังหน้าจอเพื่อตรวจสอบก่อนที่จะส่งไปยัง Apigee ให้ใช้ตัวเลือก -S ดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
ตัวเลือก -S จะละเว้นการอัปโหลดข้อมูลไปยัง Apigee จากนั้นเรียกใช้คําสั่งอีกครั้งโดยไม่มีตัวเลือก -S เพื่อส่งข้อมูลไปยัง Apigee
เหตุผลหนึ่งที่ต้องใช้เครื่องหมาย -S ให้คุณแสดงข้อมูลประเภทต่างๆ ภายในเครื่องได้ Apigee กำหนดให้คุณอัปโหลดข้อมูลการเข้าชม API เท่านั้น แต่ตัวเลือก -D ช่วยให้คุณแสดงข้อมูลเกี่ยวกับผลิตภัณฑ์ นักพัฒนาแอป แอป หรือพร็อกซี API ของ API ได้ ตัวอย่างด้านล่างใช้ตัวเลือก -D และ -S เพื่อแสดงข้อมูลนักพัฒนาแอปในเครื่อง
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S -D devs \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
ใส่ตัวเลือก -v เพื่อรับเอาต์พุตแบบละเอียด และตัวเลือก -R เพื่อดูคําสั่ง curl ที่ apigee-analytics-collector สร้างขึ้น
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S -R -v \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
ส่วนถัดไปมีรายการตัวเลือกบรรทัดคำสั่งทั้งหมด
พารามิเตอร์คำสั่ง
ตารางต่อไปนี้แสดงชุดตัวเลือกทั้งหมดของยูทิลิตี apigee-analytics-collector
คำสั่ง |
การใช้งาน |
---|---|
-h, --help |
ข้อมูลการใช้งานเอาต์พุต |
-D, --dimension <dimension> |
มิติข้อมูลการเข้าชมที่จะรวบรวม มิติข้อมูลที่ถูกต้อง ได้แก่ apiproducts, devs, apps, apiproxy (ค่าเริ่มต้น) |
-d, --วัน <days> |
จํานวนวันที่ผ่านมาซึ่งจะเริ่มนับจากวันที่ปัจจุบันสําหรับข้อมูลที่เก็บรวบรวม ค่าเริ่มต้นคือ 3 หากระบุ -d ให้ใช้ ไม่ได้ระบุ -s และ -z เพื่อตั้งเวลา |
-m, --apigee_mgmt_api_uri <apigee_mgmt_api_uri> |
URL ไปยัง Edge Management API |
-u, --apigee_mgmt_api_email <apigee_mgmt_api_email> |
อีเมลของบัญชีที่มีสิทธิ์เข้าถึง API /stats ของ Edge ซึ่งมักจะเป็นอีเมลของผู้ดูแลระบบระบบ Edge หรืออีเมลของผู้ดูแลระบบองค์กรสำหรับองค์กรเวอร์ชันที่ใช้งานจริง |
-p, --apigee_mgmt_api_password <apigee_mgmt_api_password> |
รหัสผ่านที่เชื่อมโยงกับบัญชีอีเมลของ Edge Management API ที่ระบุโดย -u |
-i, --include_orgs <items> |
รายชื่อองค์กรที่คั่นด้วยคอมมาที่จะรวมในเอาต์พุต |
-x, --exclude_orgs <items> |
รายการองค์กรที่คั่นด้วยคอมมาที่จะยกเว้นจากเอาต์พุต |
-n, --include_envs <items> |
รายการสภาพแวดล้อมที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต |
-e, --exclude_envs <items> |
รายการสภาพแวดล้อมที่คั่นด้วยจุลภาคที่จะรวมจากเอาต์พุต |
-o, --output <path> |
เส้นทางและชื่อไฟล์ที่จะบันทึกเอาต์พุต |
-s, --time_range_start <time_range_start> |
ช่วงเวลาที่จะเริ่มต้นเพื่อค้นหาสถิติการเข้าชม ซึ่งอยู่ในรูปแบบ "03/01/2016 00:00" หากระบุ -d โปรดอย่าระบุ -s และ -z เพื่อตั้งค่าช่วงเวลา |
-z, --time_range_end <time_range_end> |
จุดสิ้นสุดของช่วงเวลาสำหรับการค้นหาสถิติการเข้าชม ซึ่งอยู่ในรูปแบบ "04/01/2016 24:00" หากคุณระบุ -d โปรดอย่าระบุ -s และ -z เพื่อกำหนดช่วงเวลาด้วย |
-t, --time_unit <time_unit> |
หน่วยเวลาสําหรับข้อมูลการเข้าชม สัปดาห์เริ่มต้น หน่วยเริ่มต้นตามชั่วโมง หน่วยเวลาที่ถูกต้อง ได้แก่ วินาที นาที ชั่วโมง วัน สัปดาห์ |
-S, --standard_output |
เขียนเอาต์พุตไปยังเทอร์มินัล (stdout) แทนการอัปโหลดไปยัง Apigee |
-c, --apigee_analytics_client_id <apigee_analytics_client_id> |
รหัสสำหรับอัปโหลดข้อมูลไปยัง Apigee โปรดส่งตั๋วกับทีมสนับสนุนของ Apigee เพื่อ สืบเสาะ |
-r, --apigee_analytics_secret <apigee_analytics_secret> |
ข้อมูลลับสำหรับการอัปโหลดข้อมูลไปยัง Apigee โปรดส่งตั๋วกับทีมสนับสนุนของ Apigee เพื่อ สืบเสาะ |
-R, --include_curl_commands |
รวมคําสั่ง cURL ที่สร้างขึ้นไว้ในเอาต์พุตสําหรับการแก้ไขข้อบกพร่อง |
-v, --รายละเอียด |
แสดงเอาต์พุตแบบละเอียด |
การอัปโหลดข้อมูลไปยัง Apigee ด้วยตนเอง
Apigee ขอแนะนำให้คุณติดตั้งยูทิลิตี apigee-analytics-collector ใน เครื่องที่มีการเข้าถึงอินเทอร์เน็ตภายนอก จากนั้นยูทิลิตี apigee-analytics-collector จะอัปโหลดข้อมูลไปยัง Apigee ได้โดยตรง
อย่างไรก็ตาม หากเครื่องไม่มีการเข้าถึงอินเทอร์เน็ตภายนอก ให้ใช้ Edge Management API เพื่อ รวบรวมข้อมูลการรับส่งข้อมูล แล้วใช้คำสั่ง cURL เพื่ออัปโหลดไปยัง Apigee จากเครื่องที่มี การเข้าถึงอินเทอร์เน็ต คุณต้องทำขั้นตอนนี้ซ้ำสำหรับทุกองค์กรที่ใช้งานจริงและ สภาพแวดล้อมในการติดตั้ง Edge
ใช้คําสั่ง cURL ต่อไปนี้เพื่อรวบรวมข้อมูลการเข้าชมสําหรับองค์กรและสภาพแวดล้อมที่เฉพาะเจาะจงในระยะเวลาหนึ่งๆ
curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \ "http://<ms_IP>:8080/v1/organizations/{org_name}/environments/{env_name}/stats/apiproxy?select=sum(message_count)&timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour"
คำสั่งนี้ใช้ Edge Get API สำหรับจำนวนข้อความ API ในคําสั่งนี้
- apigee_mgmt_api_email:apigee_mgmt_api_password จะระบุ อีเมลของบัญชีที่มีสิทธิ์เข้าถึง Edge /stats API
- <ms_IP> คือที่อยู่ IP หรือชื่อ DNS ของ Edge เซิร์ฟเวอร์การจัดการ
- {org_name} และ {org_name} ระบุ องค์กรและสภาพแวดล้อม
- apiproxy คือมิติข้อมูลที่จัดกลุ่มเมตริกตามพร็อกซี API
- MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour ระบุช่วงเวลาที่แบ่งออกเป็นหน่วยเวลาของเมตริกที่จะรวบรวม โปรดทราบว่าคําสั่ง cURL ใช้รหัสฐาน 16
%20
สําหรับเว้นวรรคในช่วงเวลา
เช่น หากต้องการรวบรวมจํานวนข้อความพร็อกซี API ตามชั่วโมงในช่วง 24 ชั่วโมง ให้ใช้การเรียก API การจัดการต่อไปนี้ ช่วงเวลามีอักขระที่เข้ารหัส URL
curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \ "http://192.168.56.103:8080/v1/organizations/myOrg/environments/prod/stats/apiproxy?select=sum(message_count)&timeRange=01%2F01%2F2018%2000%3A00~01%2F02%2F2018%2000%3A00"
คุณควรเห็นคำตอบในรูปแบบต่อไปนี้
{ "environments" : [ { "metrics" : [ { "name" : "sum(message_count)", "values": [ { "timestamp": 1514847600000, "value": "35.0" }, { "timestamp": 1514844000000, "value": "19.0" }, { "timestamp": 1514840400000, "value": "58.0" }, { "timestamp": 1514836800000, "value": "28.0" }, { "timestamp": 1514833200000, "value": "29.0" }, { "timestamp": 1514829600000, "value": "33.0" }, { "timestamp": 1514826000000, "value": "26.0" }, { "timestamp": 1514822400000, "value": "57.0" }, { "timestamp": 1514818800000, "value": "41.0" }, { "timestamp": 1514815200000, "value": "27.0" }, { "timestamp": 1514811600000, "value": "47.0" }, { "timestamp": 1514808000000, "value": "66.0" }, { "timestamp": 1514804400000, "value": "50.0" }, { "timestamp": 1514800800000, "value": "41.0" }, { "timestamp": 1514797200000, "value": "49.0" }, { "timestamp": 1514793600000, "value": "35.0" }, { "timestamp": 1514790000000, "value": "89.0" }, { "timestamp": 1514786400000, "value": "42.0" }, { "timestamp": 1514782800000, "value": "47.0" }, { "timestamp": 1514779200000, "value": "21.0" }, { "timestamp": 1514775600000, "value": "27.0" }, { "timestamp": 1514772000000, "value": "20.0" }, { "timestamp": 1514768400000, "value": "12.0" }, { "timestamp": 1514764800000, "value": "7.0" } ] } ], "name" : "proxy1" } ], "metaData" : { "errors" : [ ], "notices" : [ "query served by:53dab80c-e811-4ba6-a3e7-b96f53433baa", "source pg:6b7bab33-e732-405c-a5dd-4782647ce096", "Table used: myorg.prod.agg_api" ] } }
จากนั้นใช้ cURL ต่อไปนี้เพื่ออัปโหลดข้อมูลดังกล่าวไปยัง Apigee จากเครื่องที่เข้าถึงอินเทอร์เน็ตได้ คำสั่ง:
curl -X POST -H 'Content-Type:application/json' \ -u apigee_analytics_client_id:apigee_analytics_secret \ https://nucleus-api-prod.apigee.com/v1/apigee-analytics-cli-api/traffic/orgs/{org_name}/apis -d '{"environments"...}'
โดยมี
- apigee_analytics_client_id:apigee_analytics_secret ระบุรหัสของคุณ ข้อมูลเข้าสู่ระบบสำหรับอัปโหลดข้อมูลไปยัง Apigee ที่ได้รับจากทีมสนับสนุนของ Apigee
- {org_name} ระบุองค์กร
- {"environments"...} มีผลลัพธ์ของคำสั่ง cURL ที่ ที่คุณใช้รวบรวมสถิติข้างต้น