Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

วิธีตรวจสอบ

เอกสารนี้อธิบายเทคนิคการตรวจสอบคอมโพเนนต์ที่รองรับโดยการติดตั้งใช้งาน Apigee Edge สำหรับ Private Cloud ในองค์กร

ภาพรวม

Edge รองรับวิธีต่างๆ ในการรับรายละเอียดเกี่ยวกับบริการ รวมถึงการตรวจสอบสถานะของบริการ ตารางต่อไปนี้แสดงประเภทการตรวจสอบที่คุณทำได้ในบริการที่มีสิทธิ์แต่ละรายการ

		Mgmt API
ส่วนประกอบ	การใช้งานหน่วยความจำ [JMX^*]	การตรวจสอบบริการ	สถานะผู้ใช้/องค์กร/ การติดตั้งใช้งาน	axstatus	การตรวจสอบฐานข้อมูล	`apigee-service` สถานะ	`apigee-monit`**
เซิร์ฟเวอร์การจัดการ
Message Processor
เราเตอร์
Qpid
Postgres
	ข้อมูลเพิ่มเติม	ข้อมูลเพิ่มเติม	ข้อมูลเพิ่มเติม	ข้อมูลเพิ่มเติม	ข้อมูลเพิ่มเติม	ข้อมูลเพิ่มเติม	ข้อมูลเพิ่มเติม
^{* คุณต้องเปิดใช้ JMX ก่อนจึงจะใช้ได้ ตามที่อธิบายไว้ในหัวข้อเปิดใช้ JMX} ^{** บริการ apigee-monit จะตรวจสอบว่าคอมโพเนนต์ทำงานอยู่หรือไม่ และจะพยายาม รีสตาร์ทหากคอมโพเนนต์ไม่ทำงาน ดูข้อมูลเพิ่มเติมได้ที่การซ่อมแซมตัวเองด้วย apigee-monit}

การตรวจสอบพอร์ตและไฟล์การกำหนดค่า

คอมโพเนนต์แต่ละรายการรองรับการเรียกการตรวจสอบ Java Management Extensions (JMX) และ Management API ในพอร์ตต่างๆ ตารางต่อไปนี้แสดงพอร์ต JMX และ Management API สำหรับเซิร์ฟเวอร์แต่ละประเภท รวมถึงตำแหน่งไฟล์การกำหนดค่า

ส่วนประกอบ	พอร์ต JMX	พอร์ต Management API	ตำแหน่งไฟล์การกำหนดค่า
เซิร์ฟเวอร์การจัดการ	1099	8080	`$APIGEE_ROOT/customer/application/management-server.properties`
Message Processor	1101	8082	`$APIGEE_ROOT/customer/application/message-processor.properties`
เราเตอร์	1100	8081	`$APIGEE_ROOT/customer/application/router.properties`
Qpid	1102	8083	`$APIGEE_ROOT/customer/application/qpid-server.properties`
Postgres	1103	8084	`$APIGEE_ROOT/customer/application/postgres-server.properties`

ใช้ JMX เพื่อตรวจสอบคอมโพเนนต์

ส่วนต่อไปนี้จะอธิบายวิธีใช้ JMX เพื่อตรวจสอบคอมโพเนนต์ Edge

เปิดใช้ JMX

หากต้องการเปิดใช้ JMX โดยไม่มีการตรวจสอบสิทธิ์หรือการสื่อสารที่ใช้ SSL ให้ทำตามขั้นตอนด้านล่าง หมายเหตุ: ในระบบที่ใช้งานจริง ควรเปิดใช้ทั้งการตรวจสอบสิทธิ์ที่เข้ารหัสและ SSL เพื่อความปลอดภัย

แก้ไขไฟล์การกำหนดค่าที่เหมาะสม (ดู ข้อมูลอ้างอิงไฟล์การกำหนดค่า) สร้างไฟล์การกำหนดค่าหากยังไม่มี
```
conf_system_jmxremote_enable=true
```
บันทึกไฟล์การกำหนดค่าและตรวจสอบว่า apigee:apigee เป็นเจ้าของ
รีสตาร์ทคอมโพเนนต์ Edge ที่เหมาะสม
```
apigee-service edge-management-server restart
```

หากต้องการปิดใช้ JMX ให้นำพร็อพเพอร์ตี้ conf_system_jmxremote_enable ออกหรือเปลี่ยนค่าเป็น false จากนั้นรีสตาร์ทคอมโพเนนต์ Edge ที่เหมาะสม

การตรวจสอบสิทธิ์ใน JMX

Edge for Private Cloud รองรับการตรวจสอบสิทธิ์ด้วยรหัสผ่านโดยใช้รายละเอียดที่จัดเก็บไว้ในไฟล์ คุณจัดเก็บรหัสผ่านเป็นแฮชเพื่อเพิ่มความปลอดภัยได้

หากต้องการเปิดใช้การตรวจสอบสิทธิ์ JMX ในคอมโพเนนต์ edge-* ให้แก้ไขไฟล์การกำหนดค่าที่เหมาะสม (ดู ข้อมูลอ้างอิงไฟล์การกำหนดค่า) สร้างไฟล์การกำหนดค่าหากยังไม่มี
```
conf_system_jmxremote_enable=true
conf_system_jmxremote_authenticate=true
conf_system_jmxremote_encrypted_auth=true
conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password
```
บันทึกไฟล์การกำหนดค่าและตรวจสอบว่า apigee:apigee เป็นเจ้าของ
สร้างแฮช SHA256 ของรหัสผ่าน:
```
echo -n '' | openssl dgst -sha256
```
สร้างไฟล์ jmxremote.password ที่มีข้อมูลเข้าสู่ระบบของผู้ใช้ JMX ดังนี้
1. คัดลอกไฟล์ต่อไปนี้จากไดเรกทอรี $JAVA_HOME ไปยังไดเรกทอรี /opt/apigee/customer/application/<component>/
```
cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/management-server/jmxremote.password
```
2. แก้ไขไฟล์และเพิ่มชื่อผู้ใช้และรหัสผ่าน JMX โดยใช้ไวยากรณ์ต่อไปนี้
```
USERNAME <HASH-PASSWORD>
```
3. ตรวจสอบว่าไฟล์เป็นของ apigee และโหมดไฟล์เป็น 400:
```
chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.password
```
สร้างไฟล์ jmxremote.access ที่มีสิทธิ์ของผู้ใช้ JMX ดังนี้
1. คัดลอกไฟล์ต่อไปนี้จากไดเรกทอรี $JAVA_HOME ไปยังไดเรกทอรี /opt/apigee/customer/application/<component>/
```
cp ${JAVA_HOME}/lib/management/jmxremote.access $APIGEE_ROOT/customer/application/management-server/jmxremote.access
```
2. แก้ไขไฟล์และเพิ่มชื่อผู้ใช้ JMX ตามด้วยสิทธิ์ (READONLY/READWRITE)
```
USERNAME READONLY
```
3. ตรวจสอบว่าไฟล์เป็นของ apigee และโหมดไฟล์เป็น 400:
```
chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.access
chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.access
```
รีสตาร์ทคอมโพเนนต์ Edge ที่เหมาะสม ดังนี้
```
apigee-service edge-management-server restart
```

หากต้องการปิดใช้การตรวจสอบสิทธิ์ JMX ให้นำพร็อพเพอร์ตี้ conf_system_jmxremote_authenticate ออก หรือเปลี่ยนค่าเป็น false แล้ว รีสตาร์ทคอมโพเนนต์ Edge ที่เหมาะสม

SSL ใน JMX

วิธีเปิดใช้ JMX ที่ใช้ SSL ในคอมโพเนนต์ edge-*

แก้ไขไฟล์การกำหนดค่าที่เหมาะสม (ดู ข้อมูลอ้างอิงไฟล์การกำหนดค่า) สร้างไฟล์การกำหนดค่าหากยังไม่มี
```
conf_system_jmxremote_enable=true
conf_system_jmxremote_ssl=true
conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
conf_system_javax_net_ssl_keystorepassword=<keystore-password>
```
บันทึกไฟล์การกำหนดค่าและตรวจสอบว่า apigee:apigee เป็นเจ้าของไฟล์
เตรียมคีย์สโตร์ที่มีคีย์เซิร์ฟเวอร์และวางไว้ในเส้นทางที่ระบุไว้ในการกำหนดค่า conf_system_javax_net_ssl_keystore ด้านบน ตรวจสอบว่า apigee:apigee อ่านไฟล์คีย์สโตร์ได้
รีสตาร์ทคอมโพเนนต์ Edge ที่เหมาะสม ดังนี้
```
apigee-service edge-management-server restart
```

หากต้องการปิดใช้ JMX ที่ใช้ SSL ให้นำพร็อพเพอร์ตี้ conf_system_jmxremote_ssl ออก หรือเปลี่ยนค่าเป็น false รีสตาร์ทคอมโพเนนต์ Edge ที่เหมาะสม

ตรวจสอบด้วย JConsole

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

คุณต้องเริ่ม JConsole ด้วย Truststore และรหัสผ่าน Truststore หากเปิดใช้ SSL สำหรับ JMX โปรดดูหัวข้อ การใช้ JConsole

JConsole ใช้ URL บริการต่อไปนี้เพื่อตรวจสอบแอตทริบิวต์ JMX (MBeans) ที่เสนอผ่าน JMX

service:jmx:rmi:///jndi/rmi://IP_address:port_number/jmxrmi

สถานที่:

IP_address คือที่อยู่ IP ของเซิร์ฟเวอร์ที่คุณต้องการตรวจสอบ
port_number คือหมายเลขพอร์ต JMX ของเซิร์ฟเวอร์ที่ต้องการตรวจสอบ

ตัวอย่างเช่น หากต้องการตรวจสอบเซิร์ฟเวอร์การจัดการ ให้ใช้คำสั่งต่อไปนี้ (สมมติว่าที่อยู่ IP ของเซิร์ฟเวอร์คือ 216.3.128.12)

service:jmx:rmi:///jndi/rmi://216.3.128.12:1099/jmxrmi

โปรดทราบว่าตัวอย่างนี้ระบุพอร์ต 1099 ซึ่งเป็นพอร์ต JMX ของเซิร์ฟเวอร์การจัดการ สำหรับพอร์ตอื่นๆ โปรดดูพอร์ตการตรวจสอบ JMX และ Management API

ตารางต่อไปนี้แสดงสถิติ JMX ทั่วไป

JMX MBeans	แอตทริบิวต์ JMX
หน่วยความจำ	HeapMemoryUsage
	NonHeapMemoryUsage
	การใช้งาน
หมายเหตุ ค่าแอตทริบิวต์จะแสดงเป็น 4 ค่า ได้แก่ committed, init, max และ used

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

ส่วนต่อไปนี้จะอธิบายการเปลี่ยนแปลงที่คุณอาจต้องทําในการกําหนดค่าคอมโพเนนต์ Edge สําหรับการกําหนดค่าที่เกี่ยวข้องกับ JMX ดูข้อมูลเพิ่มเติมได้ที่ การตรวจสอบพอร์ตและไฟล์การกำหนดค่า

การกำหนดค่า JMX ที่จะเพิ่มลงในไฟล์การกำหนดค่าของคอมโพเนนต์ที่เหมาะสม

เปิดใช้ JMX Agent ในคอมโพเนนต์ Edge ค่าเริ่มต้นคือ "เท็จ"
```
conf_system_jmxremote_enable=true
```

การกำหนดค่าสำหรับการตรวจสอบสิทธิ์ด้วยรหัสผ่าน

เปิดใช้การตรวจสอบสิทธิ์ตามรหัสผ่าน ค่าเริ่มต้นคือเท็จ
```
conf_system_jmxremote_authenticate=true
```
เส้นทางในการเข้าถึงไฟล์ ควรเป็นเจ้าของและอ่านได้โดยผู้ใช้ Apigee เท่านั้น
```
conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
```
เส้นทางไปยังไฟล์รหัสผ่าน ผู้ใช้ Apigee เท่านั้นที่ควรเป็นเจ้าของและอ่านได้
```
conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password
```
เปิดใช้การจัดเก็บรหัสผ่านในรูปแบบที่เข้ารหัส ค่าเริ่มต้นคือ "เท็จ"
```
conf_system_jmxremote_encrypted_auth=true
```

การกำหนดค่าสำหรับ JMX ที่ใช้ SSL

เปิดใช้ SSL สำหรับการสื่อสาร JMX ค่าเริ่มต้นคือ "เท็จ"
```
conf_system_jmxremote_ssl=true
```
เส้นทางไปยังคีย์สโตร์ ผู้ใช้ Apigee เท่านั้นที่ควรเป็นเจ้าของและอ่านได้
```
conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
```

รหัสผ่านของ Keystore

conf_system_javax_net_ssl_keystorepassword=changeme

การกำหนดค่า JMX ที่ไม่บังคับ

ค่าที่แสดงเป็นค่าเริ่มต้นและสามารถเปลี่ยนแปลงได้

พอร์ต JMX ค่าเริ่มต้นจะแสดงอยู่ในตารางด้านล่าง
```
conf_system_jmxremote_port=
```
พอร์ต JMX RMI โดยค่าเริ่มต้น กระบวนการ Java จะเลือกพอร์ตแบบสุ่ม
```
conf_system_jmxremote_rmi_port=
```
ชื่อโฮสต์สำหรับสตับระยะไกล ที่อยู่ IP เริ่มต้นของ localhost
```
conf_system_java_rmi_server_hostname=
```
ปกป้องรีจิสทรี JMX ด้วย SSL ค่าเริ่มต้นคือ false ใช้ได้เฉพาะเมื่อเปิดใช้ SSL เท่านั้น
```
conf_system_jmxremote_registry_ssl=false
```

ตรวจสอบด้วย Management API

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

ตรวจสอบบริการ

Management API มีปลายทางหลายรายการสำหรับการตรวจสอบและวิเคราะห์ปัญหาเกี่ยวกับบริการของคุณ ซึ่งมีปลายทางดังนี้

ปลายทาง คำอธิบาย

ปลายทาง	คำอธิบาย
`/servers/self/up`	ตรวจสอบว่าบริการทำงานอยู่หรือไม่ การเรียก API นี้ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์ หากบริการทำงานอยู่ ปลายทางนี้จะแสดงผลการตอบกลับต่อไปนี้ <ServerField> <Up>true</Up> </ServerField> หากบริการไม่ได้ทำงาน คุณจะได้รับการตอบกลับที่คล้ายกับข้อความต่อไปนี้ (ขึ้นอยู่กับว่าบริการใดและคุณตรวจสอบอย่างไร) curl: Failed connect to localhost:`port_number`; Connection refused
`/servers/self`	แสดงข้อมูลเกี่ยวกับบริการ ซึ่งรวมถึงข้อมูลต่อไปนี้ พร็อพเพอร์ตี้การกำหนดค่า เวลาเริ่มต้นและเวลาทำงาน ข้อมูลบิลด์, RPM และ UUID ชื่อโฮสต์และที่อยู่ IP ภายในและภายนอก ภูมิภาคและพ็อด พร็อพเพอร์ตี้ `<isUp>` ซึ่งระบุว่าบริการทำงานอยู่หรือไม่ การเรียก API นี้กำหนดให้คุณต้องตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ Apigee

/servers/self/up

ตรวจสอบว่าบริการทำงานอยู่หรือไม่ การเรียก API นี้ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์

หากบริการทำงานอยู่ ปลายทางนี้จะแสดงผลการตอบกลับต่อไปนี้

<ServerField>
  <Up>true</Up>
</ServerField>

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

curl: Failed connect to localhost:port_number; Connection refused

/servers/self

แสดงข้อมูลเกี่ยวกับบริการ ซึ่งรวมถึงข้อมูลต่อไปนี้

พร็อพเพอร์ตี้การกำหนดค่า
เวลาเริ่มต้นและเวลาทำงาน
ข้อมูลบิลด์, RPM และ UUID
ชื่อโฮสต์และที่อยู่ IP ภายในและภายนอก
ภูมิภาคและพ็อด
พร็อพเพอร์ตี้ <isUp> ซึ่งระบุว่าบริการทำงานอยู่หรือไม่

การเรียก API นี้กำหนดให้คุณต้องตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ Apigee

หากต้องการใช้ปลายทางเหล่านี้ ให้เรียกใช้ยูทิลิตี เช่น curl ด้วยคำสั่งที่ใช้ไวยากรณ์ต่อไปนี้

curl http://host:port_number/v1/servers/self/up -H "Accept: [application/json|application/xml]"
curl http://host:port_number/v1/servers/self -u username:password -H "Accept: [application/json|application/xml]"

สถานที่:

host คือที่อยู่ IP ของเซิร์ฟเวอร์ที่ต้องการตรวจสอบ หากเข้าสู่ระบบเซิร์ฟเวอร์แล้ว คุณสามารถใช้ "localhost" ได้ ไม่เช่นนั้นให้ระบุที่อยู่ IP ของเซิร์ฟเวอร์ รวมถึงชื่อผู้ใช้และรหัสผ่าน
port_number คือพอร์ต Management API สำหรับเซิร์ฟเวอร์ที่ต้องการตรวจสอบ ซึ่งเป็น พอร์ตที่แตกต่างกันสำหรับคอมโพเนนต์แต่ละประเภท เช่น พอร์ต Management API ของ Management Server คือ 8080 ดูรายการหมายเลขพอร์ต Management API ที่จะใช้ได้ที่หัวข้อพอร์ตการตรวจสอบ JMX และ Management API

หากต้องการเปลี่ยนรูปแบบการตอบกลับ คุณสามารถระบุส่วนหัว Accept เป็น "application/json" หรือ "application/xml"

ตัวอย่างต่อไปนี้จะแสดงสถานะของเราเตอร์ใน localhost (พอร์ต 8081)

curl http://localhost:8081/v1/servers/self/up -H "Accept: application/xml"

ตัวอย่างต่อไปนี้จะรับข้อมูลเกี่ยวกับ Message Processor ที่ 216.3.128.12 (พอร์ต 8082)

curl http://216.3.128.12:8082/v1/servers/self -u sysAdminEmail:password
  -H "Accept: application/xml"

ตรวจสอบสถานะผู้ใช้ องค์กร และการติดตั้งใช้งาน

คุณสามารถใช้ Management API เพื่อตรวจสอบสถานะผู้ใช้ องค์กร และการติดตั้งใช้งานพร็อกซีในเซิร์ฟเวอร์การจัดการและ Message Processor ได้โดยใช้คำสั่งต่อไปนี้

curl http://host:port_number/v1/users -u sysAdminEmail:password
curl http://host:port_number/v1/organizations -u sysAdminEmail:password
curl http://host:port_number/v1/organizations/orgname/deployments -u sysAdminEmail:password

โดย port_number คือ 8080 สำหรับเซิร์ฟเวอร์การจัดการ หรือ 8082 สำหรับ Message Processor

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

เซิร์ฟเวอร์ควรแสดงสถานะ "ติดตั้งใช้งานแล้ว" สำหรับการเรียกทั้งหมด หากไม่ได้ผล ให้ทำดังนี้

ตรวจสอบบันทึกของเซิร์ฟเวอร์เพื่อหาข้อผิดพลาด บันทึกจะอยู่ที่ตำแหน่งต่อไปนี้
- เซิร์ฟเวอร์การจัดการ: opt/apigee/var/log/edge-management-server
- Message Processor: opt/apigee/var/log/edge-message-processor
โทรหาเซิร์ฟเวอร์เพื่อตรวจสอบว่าเซิร์ฟเวอร์ทำงานอย่างถูกต้องหรือไม่
นำเซิร์ฟเวอร์ออกจาก ELB แล้วรีสตาร์ทโดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service service_name restart
```
service_name อยู่ที่ไหน
- edge-management-server
- edge-message-processor

ตรวจสอบสถานะด้วยคำสั่ง `apigee-service`

คุณสามารถแก้ปัญหาเกี่ยวกับบริการ Edge ได้โดยใช้คำสั่ง apigee-service เมื่อเข้าสู่ระบบเซิร์ฟเวอร์ที่เรียกใช้บริการ

วิธีตรวจสอบสถานะของบริการด้วย apigee-service

เข้าสู่ระบบเซิร์ฟเวอร์และเรียกใช้คำสั่งต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service service_name status
```
โดยที่ service_name คือค่าใดค่าหนึ่งต่อไปนี้
- เซิร์ฟเวอร์การจัดการ: edge-management-server
- โปรแกรมประมวลผลข้อความ: edge-message-processor
- Postgres: edge-postgres-server
- Qpid: edge-qpid-server
- เราเตอร์: edge-router
เช่น
```
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor status
```
หากบริการไม่ทำงาน ให้เริ่มบริการโดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service service_name start
```
หลังจากรีสตาร์ทบริการแล้ว ให้ตรวจสอบว่าบริการทำงานอยู่หรือไม่ โดยใช้คำสั่ง apigee-service status ที่คุณใช้ก่อนหน้านี้หรือใช้ Management API ที่อธิบายไว้ในตรวจสอบด้วย Management API
เช่น
```
curl -v http://localhost:port_number/v1/servers/self/up
```
โดยที่ port_number คือพอร์ต Management API สำหรับบริการ

ตัวอย่างนี้ถือว่าคุณเข้าสู่ระบบเซิร์ฟเวอร์แล้วและใช้ "localhost" เป็นชื่อโฮสต์ได้ หากต้องการตรวจสอบสถานะจากระยะไกลด้วย Management API คุณต้องระบุที่อยู่ IP ของเซิร์ฟเวอร์ และใส่ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบในคำสั่งเรียก API

การตรวจสอบ Postgres

Postgres รองรับยูทิลิตีหลายรายการที่คุณใช้ตรวจสอบสถานะได้ เราจะอธิบายยูทิลิตีเหล่านี้ ในส่วนต่อไป

ตรวจสอบองค์กรและสภาพแวดล้อมใน Postgres

คุณสามารถตรวจสอบชื่อองค์กรและสภาพแวดล้อมที่เริ่มต้นใช้งานในเซิร์ฟเวอร์ Postgres ได้โดยใช้คำสั่ง curl ต่อไปนี้

curl -v http://postgres_IP:8084/v1/servers/self/organizations

ระบบควรแสดงชื่อองค์กรและสภาพแวดล้อม

ยืนยันสถานะ Analytics

คุณตรวจสอบสถานะของเซิร์ฟเวอร์วิเคราะห์ Postgres และ Qpid ได้โดยออกคำสั่งต่อไปนี้ curl

curl -u userEmail:password http://host:port_number/v1/organizations/orgname/environments/envname/provisioning/axstatus

ระบบควรแสดงสถานะสำเร็จสำหรับเซิร์ฟเวอร์ Analytics ทั้งหมด ดังตัวอย่างต่อไปนี้

{
  "environments" : [ {
    "components" : [ {
      "message" : "success at Thu Feb 28 10:27:38 CET 2013",
      "name" : "pg",
      "status" : "SUCCESS",
      "uuid" : "[c678d16c-7990-4a5a-ae19-a99f925fcb93]"
     }, {
      "message" : "success at Thu Feb 28 10:29:03 CET 2013",
      "name" : "qs",
      "status" : "SUCCESS",
      "uuid" : "[ee9f0db7-a9d3-4d21-96c5-1a15b0bf0adf]"
     } ],
    "message" : "",
    "name" : "prod"
   } ],
  "organization" : "acme",
  "status" : "SUCCESS"
}

ฐานข้อมูล PostgreSQL

ส่วนนี้จะอธิบายเทคนิคที่คุณใช้เพื่อตรวจสอบฐานข้อมูล Postgres โดยเฉพาะได้

ใช้สคริปต์ `check_postgres.pl`

หากต้องการตรวจสอบฐานข้อมูล PostgreSQL คุณสามารถใช้สคริปต์การตรวจสอบมาตรฐาน check_postgres.pl ดูข้อมูลเพิ่มเติมได้ที่ http://bucardo.org/wiki/Check_postgres

ก่อนเรียกใช้สคริปต์

คุณต้องติดตั้งสคริปต์ check_postgres.pl ในแต่ละโหนด Postgres
ตรวจสอบว่าคุณได้ติดตั้ง perl-Time-HiRes.x86_64 ซึ่งเป็นโมดูล Perl ที่ใช้การปลุก การพักเครื่อง การรับเวลาของวัน และตัวจับเวลาเป็นช่วงที่มีความละเอียดสูง เช่น คุณ สามารถติดตั้งได้โดยใช้คำสั่งต่อไปนี้
```
yum install perl-Time-HiRes.x86_64
```
CentOS 7: ก่อนใช้ check_postgres.pl ใน CentOS v7 ให้ติดตั้ง perl-Data-Dumper.x86_64 RPM

check_postgres.pl output

เอาต์พุตเริ่มต้นของการเรียก API โดยใช้ check_postgres.pl จะเข้ากันได้กับ Nagios หลังจากติดตั้งสคริปต์แล้ว ให้ตรวจสอบดังนี้

ตรวจสอบขนาดฐานข้อมูลโดยทำดังนี้

check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -include=apigee -action database_size --warning='800 GB' --critical='900 GB'

ตรวจสอบจำนวนการเชื่อมต่อขาเข้าไปยังฐานข้อมูลและเปรียบเทียบกับการเชื่อมต่อสูงสุดที่อนุญาต โดยทำดังนี้
```
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends
```
ตรวจสอบว่าฐานข้อมูลทำงานอยู่และพร้อมใช้งานหรือไม่ โดยทำดังนี้
```
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action connection
```

ตรวจสอบพื้นที่ในดิสก์โดยทำดังนี้

check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action disk_space --warning='80%' --critical='90%'

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

check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action=custom_query --query="select count(*) as result from pg_tables where schemaname='analytics' and tablename like '%fact'" --warning='80' --critical='90' --valtype=integer

เรียกใช้การตรวจสอบฐานข้อมูล

คุณสามารถตรวจสอบว่ามีการสร้างตารางที่เหมาะสมในฐานข้อมูล PostgreSQL หรือไม่ เข้าสู่ระบบฐานข้อมูล PostgreSQL โดยใช้คำสั่งต่อไปนี้

psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee

จากนั้นเรียกใช้คำสั่งต่อไปนี้

\d analytics."org.env.fact"

ตรวจสอบสถานะประสิทธิภาพของกระบวนการ postgres

คุณสามารถตรวจสอบ API ในเครื่อง Postgres ได้โดยเรียกใช้คำสั่งต่อไปนี้curl

curl -v http://postgres_IP:8084/v1/servers/self/health

คำสั่งนี้จะแสดงสถานะ ACTIVE เมื่อกระบวนการ postgres ทำงานอยู่ หาก กระบวนการ Postgres ไม่ได้ทำงานอยู่ ระบบจะแสดงINACTIVEสถานะ

แหล่งข้อมูล Postgres

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบบริการ Postgres ได้ที่หัวข้อต่อไปนี้

Apache Cassandra

ระบบจะเปิดใช้ JMX โดยค่าเริ่มต้นสำหรับ Cassandra และการเข้าถึง JMX ระยะไกลไปยัง Cassandra ไม่จำเป็นต้องใช้รหัสผ่าน

เปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra

คุณเปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra ได้ หลังจากนั้น คุณจะต้องส่งชื่อผู้ใช้และรหัสผ่านไปยังการเรียกใช้ยูทิลิตี nodetool ทั้งหมด

วิธีเปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra

สร้างและแก้ไขไฟล์ cassandra.properties โดยทำดังนี้
1. แก้ไขไฟล์ /opt/apigee/customer/application/cassandra.properties หากไม่มีไฟล์ ให้สร้างไฟล์ขึ้นมา
2. เพิ่มข้อมูลต่อไปนี้ลงในไฟล์
```
conf_cassandra_env_com.sun.management.jmxremote.authenticate=true
conf_cassandra_env_com.sun.management.jmxremote.password.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.password
conf_cassandra_env_com.sun.management.jmxremote.access.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.access
```
3. บันทึกไฟล์ cassandra.properties
4. เปลี่ยนเจ้าของไฟล์เป็น apigee:apigee ดังตัวอย่างต่อไปนี้
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ไฟล์พร็อพเพอร์ตี้เพื่อตั้งค่าโทเค็นได้ที่หัวข้อวิธีกำหนดค่า Edge
สร้างและแก้ไข jmx_auth.sh:
1. สร้างไฟล์ในตำแหน่งต่อไปนี้หากยังไม่มี
```
/opt/apigee/customer/application/jmx_auth.sh
```
2. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์
```
export CASS_JMX_USERNAME=JMX_USERNAME
export CASS_JMX_PASSWORD=JMX_PASSWORD
```
3. บันทึกไฟล์ jmx_auth.sh
4. จัดหาไฟล์:
```
source /opt/apigee/customer/application/jmx_auth.sh
```
คัดลอกและแก้ไขไฟล์ jmxremote.password โดยทำดังนี้
1. คัดลอกไฟล์ต่อไปนี้จากไดเรกทอรี $JAVA_HOME ไปยัง /opt/apigee/customer/application/apigee-cassandra/
```
cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password
```
2. แก้ไขไฟล์ jmxremote.password และเพิ่มชื่อผู้ใช้และรหัสผ่าน JMX โดยใช้ไวยากรณ์ต่อไปนี้
```
JMX_USERNAME JMX_PASSWORD
```
  โดย JMX_USERNAME และ JMX_PASSWORD คือชื่อผู้ใช้และรหัสผ่าน JMX ที่คุณตั้งค่าไว้ก่อนหน้านี้
3. ตรวจสอบว่าไฟล์เป็นของ "apigee" และโหมดไฟล์เป็น 400
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
```
คัดลอกและแก้ไขไฟล์ jmxremote.access โดยทำดังนี้
1. คัดลอกไฟล์ต่อไปนี้จากไดเรกทอรี $JAVA_HOME ไปยัง /opt/apigee/customer/application/apigee-cassandra/
```
cp ${JAVA_HOME}/lib/management/jmxremote.access
$APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.access
```
2. แก้ไขไฟล์ jmxremote.access และเพิ่มบทบาทต่อไปนี้
```
JMX_USERNAME readwrite
```
3. ตรวจสอบว่าไฟล์เป็นของ "apigee" และโหมดไฟล์คือ 400
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
```

เรียกใช้ configure ใน Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

รีสตาร์ท Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

ทำขั้นตอนนี้ซ้ำในโหนด Cassandra อื่นๆ ทั้งหมด

เปิดใช้การเข้ารหัสรหัสผ่าน JMX

หากต้องการเปิดใช้การเข้ารหัสรหัสผ่าน JMX ให้ทำตามขั้นตอนต่อไปนี้

เปิดไฟล์ source/conf/casssandra-env.sh
สร้างและแก้ไขไฟล์ cassandra.properties โดยทำดังนี้
1. แก้ไขไฟล์ /opt/apigee/customer/application/cassandra.properties หากไม่มีไฟล์ ให้สร้างไฟล์
2. เพิ่มข้อมูลต่อไปนี้ลงในไฟล์
```
conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true
```
3. บันทึกไฟล์ cassandra.properties
4. เปลี่ยนเจ้าของไฟล์เป็น apigee:apigee ดังตัวอย่างต่อไปนี้
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
ในบรรทัดคำสั่ง ให้สร้างแฮช SHA1 ของรหัสผ่านที่ต้องการโดยป้อน echo -n 'Secret' | openssl dgst -sha1
ตั้งรหัสผ่านสำหรับชื่อผู้ใช้ใน $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password (สร้างขึ้นในส่วนก่อนหน้า)
เรียกใช้การกำหนดค่าใน Cassandra โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
```

รีสตาร์ท Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

ทำกระบวนการนี้ซ้ำในโหนด Cassandra อื่นๆ ทั้งหมด

เปิดใช้ JMX ด้วย SSL สำหรับ Cassandra

การเปิดใช้ JMX ด้วย SSL จะช่วยเพิ่มความปลอดภัยและการเข้ารหัสสำหรับการสื่อสารที่ใช้ JMX กับ Cassandra หากต้องการเปิดใช้ JMX ด้วย SSL คุณต้องระบุคีย์และใบรับรองให้ Cassandra เพื่อ ยอมรับการเชื่อมต่อ JMX ที่ใช้ SSL นอกจากนี้ คุณยังต้องกำหนดค่า nodetool (และเครื่องมืออื่นๆ ที่สื่อสารกับ Cassandra ผ่าน JMX) สำหรับ SSL ด้วย

JMX ที่เปิดใช้ SSL รองรับทั้งรหัสผ่าน JMX แบบข้อความธรรมดาและแบบเข้ารหัส

หากต้องการเปิดใช้ JMX ด้วย SSL สำหรับ Cassandra ให้ทำตามขั้นตอนต่อไปนี้

เปิดใช้ JMX เปิดใช้การเข้ารหัสรหัสผ่าน หากจำเป็น
เปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra ตามที่อธิบายไว้ข้างต้น ตรวจสอบว่า nodetool ทำงานร่วมกับชื่อผู้ใช้และรหัสผ่านที่กำหนดค่าไว้
```
/opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring
```
เตรียมคีย์สโตร์และทรัสต์สโตร์
- Keystore ควรมีคีย์และใบรับรอง และใช้เพื่อกำหนดค่าเซิร์ฟเวอร์ Cassandra หาก Keystore มีคู่คีย์หลายคู่ Cassandra จะใช้คู่คีย์คู่แรก เพื่อเปิดใช้ SSL
  
  โปรดทราบว่ารหัสผ่านสำหรับคีย์สโตร์และคีย์ควรเหมือนกัน (ค่าเริ่มต้นเมื่อคุณสร้างคีย์โดยใช้ keytool)
- Truststore ควรมีเฉพาะใบรับรองและไคลเอ็นต์ (คำสั่งที่ใช้ apigee-service หรือ nodetool) จะใช้เพื่อเชื่อมต่อผ่าน JMX
หลังจากยืนยันข้อกำหนดข้างต้นแล้ว ให้ทำดังนี้
1. วางไฟล์คีย์สโตร์ใน /opt/apigee/customer/application/apigee-cassandra/
2. ตรวจสอบว่าผู้ใช้ Apigee เท่านั้นที่อ่านไฟล์ Keystore ได้โดยป้อนคำสั่งต่อไปนี้
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/keystore.node1
chmod 400 /opt/apigee/customer/application/apigee-cassandra/keystore.node1
```
กำหนดค่า Cassandra สำหรับ JMX ด้วย SSL โดยทำตามขั้นตอนต่อไปนี้
1. หยุดโหนด Cassandra โดยป้อนคำสั่งต่อไปนี้
```
apigee-service apigee-cassandra stop
```
2. เปิดใช้ SSL ใน Cassandra โดย เปิดไฟล์ /opt/apigee/customer/application/cassandra.properties และเพิ่มบรรทัดต่อไปนี้
```
conf_cassandra_env_com.sun.management.jmxremote.ssl=true
conf_cassandra_env_javax.net.ssl.keyStore=/opt/apigee/customer/application/apigee-cassandra/keystore.node1
conf_cassandra_env_javax.net.ssl.keyStorePassword=keystore-password
```
3. เปลี่ยนเจ้าของไฟล์เป็น apigee:apigee ดังตัวอย่างต่อไปนี้
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
4. เรียกใช้การกำหนดค่าใน Cassandra โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
```
5. รีสตาร์ท Cassandra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
```
6. ทำขั้นตอนนี้ซ้ำในโหนด Cassandra อื่นๆ ทั้งหมด
7. เริ่มโหนด Cassandra โดยป้อนคำสั่งต่อไปนี้
```
apigee-service apigee-cassandra start
```
กำหนดค่าapigee-serviceคำสั่ง Cassandra คุณต้องตั้งค่าตัวแปรสภาพแวดล้อมบางอย่างขณะเรียกใช้คำสั่ง apigee-service รวมถึงคำสั่งต่อไปนี้
```
apigee-service apigee-cassandra stop
apigee-service apigee-cassandra wait_for_ready
apigee-service apigee-cassandra ring
apigee-service apigee-cassandra backup
```
คุณกำหนดค่า apigee-service สำหรับการตรวจสอบสิทธิ์ JMX และ SSL ได้หลายวิธี เลือกตัวเลือกตามความสามารถในการใช้งานและแนวทางปฏิบัติด้านความปลอดภัย
ตัวเลือกที่ 1 (อาร์กิวเมนต์ SSL ที่จัดเก็บไว้ในไฟล์)

ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
```
export CASS_JMX_USERNAME=ADMIN
# Provide encrypted password here if you have setup JMX password encryption
export CASS_JMX_PASSWORD=PASSWORD
export CASS_JMX_SSL=Y
```
สร้างไฟล์ในไดเรกทอรีหน้าแรกของผู้ใช้ Apigee (/opt/apigee)
```
$HOME/.cassandra/nodetool-ssl.properties
```
แก้ไขไฟล์และเพิ่มบรรทัดต่อไปนี้
```
-Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true
-Djavax.net.ssl.trustStoreType=PKCS12
```
ตรวจสอบว่าผู้ใช้ Apigee อ่านไฟล์ Truststore ได้

เรียกใช้คำสั่ง apigee-service ต่อไปนี้ หากสคริปต์ทำงานโดยไม่มีข้อผิดพลาด แสดงว่าการกำหนดค่าถูกต้อง
```
apigee-service apigee-cassandra ring
```
ตัวเลือกที่ 2 (อาร์กิวเมนต์ SSL ที่จัดเก็บไว้ในตัวแปรสภาพแวดล้อม)

ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
```
export CASS_JMX_USERNAME=ADMIN
# Provide encrypted password here if you have setup JMX password encryption
export CASS_JMX_PASSWORD=PASSWORD
export CASS_JMX_SSL=Y
# Ensure the truststore file is accessible by Apigee user.
export CASS_JMX_TRUSTSTORE=<path-to-trustore.node1>
export CASS_JMX_TRUSTSTORE_PASSWORD=<truststore-password>
# If you are using a non standard truststore type, export truststore type as well
# Possible values are JKS, PKCS12, BCFKS
export CASS_JMX_TRUSTSTORE_TYPE=PKCS12
```
เรียกใช้คำสั่ง apigee-service ต่อไปนี้ หากสคริปต์ทำงานโดยไม่มีข้อผิดพลาด แสดงว่าการกำหนดค่าถูกต้อง
```
apigee-service apigee-cassandra ring
```
ตัวเลือกที่ 3 (ส่งอาร์กิวเมนต์ SSL ไปยัง apigee-service โดยตรง)

เรียกใช้คำสั่ง apigee-service ใดก็ได้ เช่น คำสั่งด้านล่าง คุณไม่จำเป็นต้องกำหนดค่าตัวแปรสภาพแวดล้อมใดๆ
```
CASS_JMX_USERNAME=ADMIN CASS_JMX_PASSWORD=PASSWORD CASS_JMX_SSL=Y CASS_JMX_TRUSTSTORE=<path-to-trustore.node1> CASS_JMX_TRUSTSTORE_PASSWORD=<trustore-password> CASS_JMX_TRUSTSTORE_TYPE=PKCS12 /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring
```
ตั้งค่า nodetool Nodetool ต้องใช้พารามิเตอร์ JMX ที่ส่งไปยัง Nodetool คุณกำหนดค่า nodetool ให้ทำงานกับ JMX ที่เปิดใช้ SSL ได้ 2 วิธีตามที่อธิบายไว้ในตัวเลือกการกำหนดค่าด้านล่าง
- ตัวเลือกการกำหนดค่า 1
- ตัวเลือกการกำหนดค่า 2
ตัวเลือกจะแตกต่างกันไปตามวิธีส่งการกำหนดค่าที่เกี่ยวข้องกับ SSL ไปยัง nodetool ในทั้ง 2 กรณี ผู้ใช้ที่เรียกใช้ nodetool ควรมีสิทธิ์อ่านในไฟล์ Truststore เลือกตัวเลือกที่เหมาะสมตามความสามารถในการใช้งานและแนวทางปฏิบัติด้านความปลอดภัยของคุณ

ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ nodetool ได้ที่ เอกสารประกอบ nodetool ของ Apache Cassandra

ตัวเลือกการกำหนดค่า 1

สร้างไฟล์ในไดเรกทอรีหน้าแรกของผู้ใช้ที่เรียกใช้ nodetool
```
$HOME/.cassandra/nodetool-ssl.properties
```
เพิ่มบรรทัดต่อไปนี้ลงในไฟล์
```
-Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true
-Djavax.net.ssl.trustStoreType=PKCS12
```
ผู้ใช้ที่เรียกใช้เครื่องมือจัดการโหนดควรเข้าถึงเส้นทาง Truststore ที่ระบุไว้ข้างต้นได้

เรียกใช้ nodetool ด้วยตัวเลือก --ssl
```
/opt/apigee/apigee-cassandra/bin/nodetool --ssl -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring
```
ตัวเลือกการกำหนดค่า 2

เรียกใช้ nodetool เป็นคำสั่งเดียวพร้อมพารามิเตอร์เพิ่มเติมที่แสดงด้านล่าง
```
/opt/apigee/apigee-cassandra/bin/nodetool -Djavax.net.ssl.trustStore=<path-to-truststore.node1> -Djavax.net.ssl.trustStorePassword=<truststore-password> -Dcom.sun.management.jmxremote.registry.ssl=true -Djavax.net.ssl.trustStoreType=PKCS12 -Dssl.enable=true -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring
```

เปลี่ยนกลับการกำหนดค่า SSL

หากต้องการเปลี่ยนกลับการกำหนดค่า SSL ที่อธิบายไว้ในขั้นตอนข้างต้น ให้ทำตามขั้นตอนต่อไปนี้

หยุด apigee-cassandraโดยป้อน
```
apigee-service apigee-cassandra stop
```
นำบรรทัด conf_cassandra-env_com.sun.management.jmxremote.ssl=true ออกจาก ไฟล์ /opt/apigee/customer/application/cassandra.properties

แสดงความคิดเห็นในบรรทัดต่อไปนี้ใน /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh

# JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStore=/opt/apigee/data/apigee-cassandra/keystore.node0"
# JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStorePassword=keypass"
# JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.registry.ssl=true”

เริ่ม apigee-cassandra โดยป้อน

apigee-service apigee-cassandra start

นำตัวแปรสภาพแวดล้อม CASS_JMX_SSL ออกหากมีการตั้งค่าไว้
```
unset CASS_JMX_SSL
```
ตรวจสอบว่าคำสั่งที่อิงตาม apigee-service เช่น ring, stop, backup และอื่นๆ ทำงานได้
หยุดใช้สวิตช์ --ssl กับ nodetool

ปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra

วิธีปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra

แก้ไข /opt/apigee/customer/application/cassandra.properties
นำบรรทัดต่อไปนี้ออกจากไฟล์
```
conf_cassandra-env_com.sun.management.jmxremote.authenticate=true
```
เรียกใช้การกำหนดค่าใน Cassandra ดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
```

รีสตาร์ท Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

ทำกระบวนการนี้ซ้ำในโหนด Cassandra อื่นๆ ทั้งหมด

ใช้ JConsole: ตรวจสอบสถิติตา

ใช้ JConsole และ URL บริการต่อไปนี้เพื่อตรวจสอบแอตทริบิวต์ JMX (MBeans) ที่เสนอผ่าน JMX

service:jmx:rmi:///jndi/rmi://IP_address:7199/jmxrmi

โดยที่ IP_address คือ IP ของเซิร์ฟเวอร์ Cassandra

สถิติ JMX ของ Cassandra

JMX MBeans	แอตทริบิวต์ JMX
ColumnFamilies/apprepo/environments ColumnFamilies/apprepo/organizations ColumnFamilies/apprepo/apiproxy_revisions ColumnFamilies/apprepo/apiproxies ColumnFamilies/audit/audits ColumnFamilies/audit/audits_ref	PendingTasks
	MemtableColumnsCount
	MemtableDataSize
	ReadCount
	RecentReadLatencyMicros
	TotalReadLatencyMicros
	WriteCount
	RecentWriteLatencyMicros
	TotalWriteLatencyMicros
	TotalDiskSpaceUsed
	LiveDiskSpaceUsed
	LiveSSTableCount
	BloomFilterFalsePositives
	RecentBloomFilterFalseRatio
	BloomFilterFalseRatio

ใช้ nodetool เพื่อจัดการโหนดคลัสเตอร์

ยูทิลิตี nodetool คืออินเทอร์เฟซบรรทัดคำสั่งสำหรับ Cassandra ที่จัดการโหนดคลัสเตอร์ ดูยูทิลิตีได้ที่ /opt/apigee/apigee-cassandra/bin

การเรียกใช้ต่อไปนี้สามารถทำได้ในโหนดคลัสเตอร์ Cassandra ทั้งหมด

ข้อมูลทั่วไปเกี่ยวกับวงแหวน (ใช้ได้กับโหนด Cassandra เดียวด้วย): มองหา "ขึ้น" และ "ปกติ" สำหรับโหนดทั้งหมด
```
nodetool [-u username -pw password] -h localhost ring
```
คุณต้องส่งชื่อผู้ใช้และรหัสผ่านก็ต่อเมื่อ เปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra

เอาต์พุตของคำสั่งข้างต้นจะมีลักษณะดังที่แสดงด้านล่าง
```
Datacenter: dc-1
==========
Address            Rack     Status State   Load    Owns    Token
192.168.124.201    ra1      Up     Normal  1.67 MB 33,33%  0
192.168.124.202    ra1      Up     Normal  1.68 MB 33,33%  5671...5242
192.168.124.203    ra1      Up     Normal  1.67 MB 33,33%  1134...0484
```

ข้อมูลทั่วไปเกี่ยวกับโหนด (การเรียกต่อโหนด)

nodetool [-u username -pw password]  -h localhost info

เอาต์พุตของคำสั่งข้างต้นจะมีลักษณะดังนี้

ID                     : e2e42793-4242-4e82-bcf0-oicu812
Gossip active          : true
Thrift active          : true
Native Transport active: true
Load                   : 273.71 KB
Generation No          : 1234567890
Uptime (seconds)       : 687194
Heap Memory (MB)       : 314.62 / 3680.00
Off Heap Memory (MB)   : 0.14
Data Center            : dc-1
Rack                   : ra-1
Exceptions             : 0
Key Cache              : entries 150, size 13.52 KB, capacity 100 MB, 1520781 hits, 1520923 requests, 1.000 recent hit rate, 14400 save period in seconds
Row Cache              : entries 0, size 0 bytes, capacity 0 bytes, 0 hits, 0 requests, NaN recent hit rate, 0 save period in seconds
Counter Cache          : entries 0, size 0 bytes, capacity 50 MB, 0 hits, 0 requests, NaN recent hit rate, 7200 save period in seconds
Token                  : 0

สถานะของเซิร์ฟเวอร์ Thrift (ให้บริการ API ของไคลเอ็นต์)
```
nodetool [-u username -pw password] -h localhost statusthrift
```
เอาต์พุตของคำสั่งด้านบนจะมีลักษณะดังนี้
```
running
```

สถานะของการดำเนินการสตรีมข้อมูล: สังเกตการเข้าชมสำหรับโหนด Cassandra ดังนี้

nodetool [-u username -pw password] -h localhost netstats

เอาต์พุตของคำสั่งด้านบนจะมีลักษณะดังนี้

Mode: NORMAL
Not sending any streams.
Read Repair Statistics:
Attempted: 151612
Mismatch (Blocking): 0
Mismatch (Background): 0
Pool Name                    Active   Pending      Completed   Dropped
Commands                        n/a         0              0         0
Responses                       n/a         0              0       n/a

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เครื่องมือ nodetool ได้ที่ เกี่ยวกับยูทิลิตี nodetool

แหล่งข้อมูล Cassandra

โปรดดู URL ต่อไปนี้ การตรวจสอบ Cassandra

การตรวจสอบ Apache Qpid Broker-J

คุณสามารถตรวจสอบ Qpid Broker-J ได้จากคอนโซลการจัดการ Qpid ส่วนนี้จะอธิบายวิธีเข้าถึงคอนโซลและใช้คอนโซลเพื่อดำเนินการตรวจสอบขั้นพื้นฐาน ดูข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับการใช้คอนโซลการจัดการได้ที่หัวข้อ คอนโซลการจัดการเว็บในเอกสารประกอบของ Apache Qpid

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

เข้าถึงคอนโซลการจัดการ

พอร์ตของคอนโซลการจัดการเริ่มต้นคือ 8090 หากต้องการเข้าถึงคอนโซลในพอร์ตเริ่มต้นนี้ ให้ ชี้เว็บเบราว์เซอร์ไปที่

http://QPID_NODE_IP:8090

หากต้องการเข้าสู่ระบบคอนโซล ให้ใช้ข้อมูลเข้าสู่ระบบเริ่มต้นที่ Apigee กำหนดไว้หรือข้อมูลเข้าสู่ระบบที่กำหนดไว้ในไฟล์การกำหนดค่า Edge ดูรายละเอียดได้ที่ ข้อมูลอ้างอิงไฟล์การกำหนดค่า Edge

ตรวจสอบคิวและข้อความ

ในแผงการนำทางด้านซ้าย ให้ไปที่ Java-Broker > virtualhosts > queues เลือกคิวเพื่อดูรายละเอียดในส่วนหลักของ UI ในมุมมองรายละเอียด คุณจะเห็นแอตทริบิวต์และสถิติของคิว ซึ่งรวมถึงข้อมูลเกี่ยวกับข้อความที่ส่ง ข้อความที่อยู่ในคิว อัตราข้อความ และอื่นๆ

ดูและดาวน์โหลดไฟล์บันทึก

ในแผงการนำทางด้านซ้าย ให้ไปที่ Java-Broker > brokerloggers > logfile ใน มุมมองรายละเอียด UI หลัก คุณจะดูรายละเอียดไฟล์บันทึกและดาวน์โหลดไฟล์บันทึกได้

การใช้ Qpid Management API

คุณสามารถใช้ Apache Qpid Broker-J REST API เพื่อทำให้งานการจัดการเป็นแบบอัตโนมัติและตรวจสอบโบรกเกอร์ได้ โปรดดูรายละเอียดใน เอกสารประกอบของ Apache Qpid Broker REST API

นอกจากนี้ คุณยังใช้เครื่องมือบรรทัดคำสั่งเพื่อตรวจสอบโบรกเกอร์ได้ด้วย เช่น

curl "QPID_NODE_IP":"8090"/api/latest/broker -u "USERNAME":"PASSWORD"

เปิดใช้การตรวจสอบด้วย SSL สำหรับ Qpid

หากต้องการเพิ่มความปลอดภัยในการตรวจสอบและการจัดการ ให้เปิดใช้ SSL ในพอร์ทัลการจัดการของ Qpid และ Management API ของ Qpid ทำตามหลักเกณฑ์ด้านล่างเพื่อระบุคีย์และใบรับรอง

Qpid มีตัวเลือกสำหรับคีย์สโตร์ไฟล์ ซึ่งเปิดใช้ใน Apigee ประเภทนี้ยอมรับรูปแบบที่เก็บคีย์ JKS มาตรฐานที่ Java และเครื่องมือ Java เช่น keytool เข้าใจ นอกจากนี้ยังยอมรับคีย์สโตร์ PKCS12 ซึ่งสร้างได้โดยใช้เครื่องมืออย่าง OpenSSL

การเตรียม Keystore

ดูวิธีสร้าง Keystore ได้ที่เอกสารประกอบของ Java Keytool

ดูวิธีสร้างคีย์สโตร์ PKCS12 ได้ที่เอกสารประกอบของ OpenSSL

หลังจากยืนยันข้อกำหนดแล้ว

วางไฟล์คีย์สโตร์ใน /opt/apigee/customer/application/apigee-qpidd

ตรวจสอบว่าไฟล์ Keystore อ่านได้โดยผู้ใช้ Apigee เท่านั้น

chown apigee:apigee /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore
  chmod 400 /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore

เปิดใช้ SSL ใน Qpid

ทำตามขั้นตอนด้านล่างในโหนด Qpid ทีละโหนด

เปิดไฟล์ /opt/apigee/customer/application/qpidd.properties แล้วเพิ่มบรรทัดต่อไปนี้

conf_qpidd_qpid_management.https.enabled=true
conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/qpidd.keystore
conf_qpidd_qpid.keystore.password=keystore-password
conf_qpidd_qpid.keystore.certificateAlias=certificate-alias
## If you are using a PKCS12 keystore, specify the keystore type
conf_qpidd_qpid.keystore.keyStoreType=PKCS12

เปลี่ยนเจ้าของไฟล์เป็น apigee:apigee:
```
chown apigee:apigee /opt/apigee/customer/application/qpidd.properties
```
กำหนดค่า Qpidd:
```
apigee-service apigee-qpidd configure
```
รีสตาร์ท Qpidd:
```
apigee-service apigee-qpidd restart
```
ตรวจสอบสถานะด้วย wait_for_ready:
```
apigee-service apigee-qpidd wait_for_ready
```

เปลี่ยนกลับการกำหนดค่า SSL

นำพร็อพเพอร์ตี้ออกจากไฟล์ /opt/apigee/customer/application/qpidd.properties หรือทำเครื่องหมายเป็นความคิดเห็น

conf_qpidd_qpid_management.https.enabled=true
conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/keystore

กำหนดค่า Qpidd:
```
apigee-service apigee-qpidd configure
```
รีสตาร์ท Qpidd:
```
apigee-service apigee-qpidd restart
```
ตรวจสอบสถานะด้วย wait_for_ready:
```
apigee-service apigee-qpidd wait_for_ready
```

Apache ZooKeeper

ตรวจสอบสถานะ ZooKeeper

ตรวจสอบว่ากระบวนการ ZooKeeper ทำงานอยู่ ZooKeeper จะเขียนไฟล์ PID ไปยัง opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid
ทดสอบพอร์ต ZooKeeper เพื่อให้แน่ใจว่าคุณสร้างการเชื่อมต่อ TCP กับพอร์ต 2181 และ 3888 ในเซิร์ฟเวอร์ ZooKeeper ทุกเครื่องได้
ตรวจสอบว่าคุณอ่านค่าจากฐานข้อมูล ZooKeeper ได้ เชื่อมต่อโดยใช้ไลบรารีของไคลเอ็นต์ ZooKeeper (หรือ /opt/apigee/apigee-zookeeper/bin/zkCli.sh) และอ่านค่าจากฐานข้อมูล

ตรวจสอบสถานะ:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper status

ใช้คำ 4 ตัวอักษรของ ZooKeeper

คุณสามารถตรวจสอบ ZooKeeper ได้ผ่านชุดคำสั่งขนาดเล็ก (คำ 4 ตัวอักษร) ที่ส่งไปยังพอร์ต 2181 โดยใช้ netcat (nc) หรือ telnet

ดูข้อมูลเพิ่มเติมเกี่ยวกับคำสั่ง ZooKeeper ได้ที่ เอกสารอ้างอิงคำสั่ง Apache ZooKeeper

เช่น

srvr: แสดงรายละเอียดทั้งหมดของเซิร์ฟเวอร์
stat: แสดงรายละเอียดโดยย่อของเซิร์ฟเวอร์และไคลเอ็นต์ที่เชื่อมต่อ

คุณสามารถออกคำสั่งต่อไปนี้ไปยังพอร์ต ZooKeeper

เรียกใช้คำสั่ง 4 ตัวอักษร ruok เพื่อทดสอบว่าเซิร์ฟเวอร์ทำงานในสถานะที่ไม่มีข้อผิดพลาดหรือไม่ การตอบกลับที่สำเร็จจะแสดงผลเป็น "imok"
```
echo ruok | nc host 2181
```
ค่าที่ส่งคืน:
```
imok
```
เรียกใช้คำสั่ง 4 ตัวอักษร stat เพื่อแสดงประสิทธิภาพของเซิร์ฟเวอร์และสถิติไคลเอ็นต์ที่เชื่อมต่อ
```
echo stat | nc host 2181
```
ค่าที่ส่งคืน:
```
Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-18 17:23 UTC
Clients:
/0:0:0:0:0:0:0:1:33467[0](queued=0,recved=1,sent=0)
/192.168.124.201:42388[1](queued=0,recved=8433,sent=8433)
/192.168.124.202:42185[1](queued=0,recved=1339,sent=1347)
/192.168.124.204:39296[1](queued=0,recved=7688,sent=7692)
Latency min/avg/max: 0/0/128
Received: 26144
Sent: 26160
Connections: 4
Outstanding: 0
Zxid: 0x2000002c2
Mode: follower
Node count: 283
```
หมายเหตุ: บางครั้งคุณอาจต้องดูว่า ZooKeeper อยู่ในโหมดใด ได้แก่ ผู้นำ ผู้ติดตาม หรือผู้สังเกตการณ์
หากไม่มี netcat (nc) คุณสามารถใช้ python เป็นทางเลือกได้ สร้างไฟล์ชื่อ zookeeper.py ที่มีข้อมูลต่อไปนี้
```
import time, socket,
sys c = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
c.connect((sys.argv[1], 2181))
c.send(sys.argv[2])
time.sleep(0.1)
print c.recv(512)
```
ตอนนี้ให้เรียกใช้บรรทัด Python ต่อไปนี้
```
python zookeeper.py 192.168.124.201 ruok
python zookeeper.py 192.168.124.201 stat
```

การทดสอบระดับ LDAP

คุณสามารถตรวจสอบ SymasLDAP เพื่อดูว่าคำขอที่เฉพาะเจาะจงได้รับการตอบสนองอย่างถูกต้องหรือไม่ กล่าวอีกนัยหนึ่งคือ ให้ตรวจสอบการค้นหาที่เฉพาะเจาะจงซึ่งแสดงผลลัพธ์ที่ถูกต้อง

ใช้ ldapsearch (yum install symasldap-clients) เพื่อค้นหาข้อมูล ของผู้ดูแลระบบ รายการนี้ใช้เพื่อตรวจสอบสิทธิ์การเรียก API ทั้งหมด
```
/opt/symas/bin/ldapsearch -b "uid=admin,ou=users,ou=global,dc=apigee,dc=com" -x -W -D "cn=manager,dc=apigee,dc=com" -H ldap://localhost:10389 -LLL
```
จากนั้นระบบจะแจ้งให้คุณป้อนรหัสผ่านผู้ดูแลระบบ LDAP
```
Enter LDAP Password:
```
หลังจากป้อนรหัสผ่านแล้ว คุณจะเห็นการตอบกลับในรูปแบบต่อไปนี้
```
dn:
uid=admin,ou=users,ou=global,dc=apigee,dc=com
objectClass: organizationalPerson
objectClass: person
objectClass: inetOrgPerson
objectClass: top
uid: admin
cn: admin
sn: admin
userPassword:: e1NTSEF9bS9xbS9RbVNXSFFtUWVsU1F0c3BGL3BQMkhObFp2eDFKUytmZVE9PQ=
 =
mail: opdk@google.com
```
ตรวจสอบว่าเซิร์ฟเวอร์การจัดการยังเชื่อมต่อกับ LDAP อยู่หรือไม่ด้วยคำสั่งต่อไปนี้
```
curl -u userEMail:password http://localhost:8080/v1/users/ADMIN
```
ค่าที่ส่งคืน:
```
{
  "emailId" : ADMIN,
  "firstName" : "admin",
  "lastName" : "admin"
}
```

นอกจากนี้ คุณยังตรวจสอบแคช SymasLDAP ได้ด้วย ซึ่งจะช่วยลดจำนวนการเข้าถึงดิสก์และปรับปรุงประสิทธิภาพของระบบ การตรวจสอบแล้วปรับขนาดแคชในเซิร์ฟเวอร์ SymasLDAP อาจส่งผลต่อประสิทธิภาพของเซิร์ฟเวอร์ไดเรกทอรีอย่างมาก คุณดูไฟล์บันทึก (opt/apigee/var/log) เพื่อรับข้อมูลเกี่ยวกับแคชได้

วิธีตรวจสอบ

ภาพรวม

การตรวจสอบพอร์ตและไฟล์การกำหนดค่า

ใช้ JMX เพื่อตรวจสอบคอมโพเนนต์

เปิดใช้ JMX

การตรวจสอบสิทธิ์ใน JMX

SSL ใน JMX

ตรวจสอบด้วย JConsole

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

การกำหนดค่า JMX ที่จะเพิ่มลงในไฟล์การกำหนดค่าของคอมโพเนนต์ที่เหมาะสม

การกำหนดค่าสำหรับการตรวจสอบสิทธิ์ด้วยรหัสผ่าน

การกำหนดค่าสำหรับ JMX ที่ใช้ SSL

การกำหนดค่า JMX ที่ไม่บังคับ

ตรวจสอบด้วย Management API

ตรวจสอบบริการ

ตรวจสอบสถานะผู้ใช้ องค์กร และการติดตั้งใช้งาน

ตรวจสอบสถานะด้วยคำสั่ง apigee-service

การตรวจสอบ Postgres

ตรวจสอบองค์กรและสภาพแวดล้อมใน Postgres

ยืนยันสถานะ Analytics

ฐานข้อมูล PostgreSQL

ใช้สคริปต์ check_postgres.pl

เรียกใช้การตรวจสอบฐานข้อมูล

ตรวจสอบสถานะประสิทธิภาพของกระบวนการ postgres

แหล่งข้อมูล Postgres

Apache Cassandra

เปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra

เปิดใช้การเข้ารหัสรหัสผ่าน JMX

เปิดใช้ JMX ด้วย SSL สำหรับ Cassandra

ตัวเลือกที่ 1 (อาร์กิวเมนต์ SSL ที่จัดเก็บไว้ในไฟล์)

ตัวเลือกที่ 2 (อาร์กิวเมนต์ SSL ที่จัดเก็บไว้ในตัวแปรสภาพแวดล้อม)

ตัวเลือกที่ 3 (ส่งอาร์กิวเมนต์ SSL ไปยัง apigee-service โดยตรง)

ตัวเลือกการกำหนดค่า 1

ตัวเลือกการกำหนดค่า 2

เปลี่ยนกลับการกำหนดค่า SSL

ปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra

ใช้ JConsole: ตรวจสอบสถิติตา

สถิติ JMX ของ Cassandra

ใช้ nodetool เพื่อจัดการโหนดคลัสเตอร์

แหล่งข้อมูล Cassandra

การตรวจสอบ Apache Qpid Broker-J

เข้าถึงคอนโซลการจัดการ

ตรวจสอบคิวและข้อความ

ดูและดาวน์โหลดไฟล์บันทึก

การใช้ Qpid Management API

เปิดใช้การตรวจสอบด้วย SSL สำหรับ Qpid

การเตรียม Keystore

หลังจากยืนยันข้อกำหนดแล้ว

เปิดใช้ SSL ใน Qpid

เปลี่ยนกลับการกำหนดค่า SSL

Apache ZooKeeper

ตรวจสอบสถานะ ZooKeeper

ใช้คำ 4 ตัวอักษรของ ZooKeeper

การทดสอบระดับ LDAP

ตรวจสอบสถานะด้วยคำสั่ง `apigee-service`

ใช้สคริปต์ `check_postgres.pl`

ตัวเลือกที่ 3 (ส่งอาร์กิวเมนต์ SSL ไปยัง `apigee-service` โดยตรง)