การแก้ปัญหาข้อผิดพลาดในการทำให้นโยบายแคชของการค้นหา

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

InvalidTimeout

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน UI ของ Edge หรือ Edge Management API จะล้มเหลวพร้อมข้อความแสดงข้อผิดพลาดนี้

Error Saving Revision revision_number
CacheLookupTimeoutInSeconds value value should be greater than zero.

ตัวอย่างข้อความแสดงข้อผิดพลาด

Error Saving Revision 2
CacheLookupTimeoutInSeconds -1 value should be greater than zero.

ตัวอย่างภาพหน้าจอแสดงข้อผิดพลาด

สาเหตุ

หากตั้งค่าองค์ประกอบ <CacheLookupTimeoutInSeconds> ของนโยบาย LookupCache เป็นจำนวนลบ การติดตั้งใช้งานพร็อกซี API จะล้มเหลว

เช่น หากองค์ประกอบ <CacheLookupTimeoutInSeconds> เป็น -1 การติดตั้งใช้งานพร็อกซี API จะล้มเหลว

การวินิจฉัย

1. ระบุค่าที่ไม่ถูกต้องที่ระบุไว้สำหรับองค์ประกอบ <CacheLookupTimeoutInSeconds> ในนโยบาย LookupCache คุณดูข้อมูลนี้ได้ในข้อความแสดงข้อผิดพลาด ตัวอย่างเช่น ในข้อผิดพลาดต่อไปนี้ ค่าที่ไม่ถูกต้องที่ใช้สำหรับองค์ประกอบ <CacheLookupTimeoutInSeconds> คือ -1

   CacheLookupTimeoutInSeconds -1 value should be greater than zero.
   

2. ตรวจสอบนโยบาย LookupCache ทั้งหมดในพร็อกซี API ที่เฉพาะเจาะจงซึ่งเกิดข้อผิดพลาด อาจมีนโยบาย LookupCache อย่างน้อย 1 รายการที่ระบุองค์ประกอบ <CacheLookupTimeoutInSeconds> ระบุนโยบาย LookUpCache ที่ระบุค่าที่ไม่ถูกต้อง (ระบุในขั้นตอนที่ 1 ด้านบน) สำหรับองค์ประกอบ <CacheLookupTimeoutInSeconds>

   ตัวอย่างเช่น การกำหนดค่านโยบายต่อไปนี้จะระบุค่าของ <CacheLookupTimeoutInSeconds> ของ -1 ซึ่งตรงกับข้อความแสดงข้อผิดพลาด

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
       <DisplayName>LookupCache-Token</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.queryparam.client_id"/>
       </CacheKey>
       <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <TimeoutInSec>3600</TimeoutInSec>
       </ExpirySettings>
       <AssignTo>usertoken</AssignTo>
   </LookupCache>
   

3. หากระบุ <CacheLookupTimeoutInSeconds> เป็นจำนวนเต็มลบ นั่นคือสาเหตุของข้อผิดพลาด

ความละเอียด

ตรวจสอบว่าค่าสำหรับองค์ประกอบ <CacheLookupTimeoutInSeconds> ของนโยบาย LookupCache ระบุเป็นจำนวนเต็มที่ไม่ติดลบเสมอ

หากต้องการแก้ไขนโยบาย LookupCache ตัวอย่างที่แสดงด้านบน คุณสามารถแก้ไของค์ประกอบ <CacheLookupTimeoutInSeconds> เป็น 30 ได้

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

InvalidCacheResourceReference

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน UI ของ Edge หรือ Edge Management API จะล้มเหลวพร้อมข้อความแสดงข้อผิดพลาดนี้

Error Deploying Revision revision_number to environment
Invalid cache resource reference [cache_resource] in Step definition [populate_cache_policy_name]. Context Revision:[revision_number];APIProxy:ResponseCache;Organization:[organization];Environment:[environment]

ตัวอย่างข้อความแสดงข้อผิดพลาด

Error Deploying Revision 2 to test
Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

ตัวอย่างภาพหน้าจอแสดงข้อผิดพลาด

สาเหตุ

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

การวินิจฉัย

1. ระบุแคชที่ไม่ถูกต้องที่ใช้ในองค์ประกอบ <CacheResource> ของนโยบาย LookupCache และสภาพแวดล้อมที่เกิดข้อผิดพลาด คุณจะเห็นทั้ง 2 รายการนี้ในข้อความแสดงข้อผิดพลาด เช่น ในข้อผิดพลาดต่อไปนี้ ชื่อของแคชที่ไม่ถูกต้องคือ tokencache และชื่อสภาพแวดล้อมคือ test

   Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
   

2. ตรวจสอบนโยบาย LookupCache ทั้งหมดในพร็อกซี API ที่เฉพาะเจาะจงซึ่งเกิดข้อผิดพลาด ระบุนโยบาย LookupCache ที่เฉพาะเจาะจงซึ่งมีการระบุแคชที่ไม่ถูกต้อง (ระบุในขั้นตอนที่ 1) ในองค์ประกอบ <CacheResource>

   ตัวอย่างเช่น นโยบายต่อไปนี้ระบุค่าของ <CacheResource> เป็น tokencache ซึ่งตรงกับข้อความแสดงข้อผิดพลาด

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
       <DisplayName>LookupCache-Token</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.queryparam.client_id"/>
       </CacheKey>
       <CacheResource>tokencache</CacheResource>
       <CacheLookupTimeoutInSeconds/>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <TimeoutInSec>3600</TimeoutInSec>
       </ExpirySettings>
       <AssignTo>usertoken</AssignTo>
   </LookupCache>
   

3. ตรวจสอบว่าได้กำหนดแคช (กำหนดไว้ในขั้นตอนที่ 1) ในสภาพแวดล้อมที่เฉพาะเจาะจง (ระบุไว้ในขั้นตอนที่ 1) แล้ว

   ใน UI ของ Edge ให้ไปที่ ADMIN > Environment > test แล้วตรวจสอบว่าแคชอยู่ในแท็บแคชของการกำหนดค่าสภาพแวดล้อมหรือไม่ หากไม่มีแคช แสดงว่าแคชเป็นสาเหตุของข้อผิดพลาด

   ตัวอย่างเช่น ในภาพหน้าจอด้านล่าง คุณจะเห็นว่าแคชชื่อ tokencache ไม่มีอยู่

   

   เนื่องจากไม่ได้กำหนดแคชชื่อ tokencache ในสภาพแวดล้อม test คุณจึงได้รับข้อผิดพลาดต่อไปนี้

   Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
   
   

ความละเอียด

ตรวจสอบว่าได้สร้างชื่อแคชที่ระบุในองค์ประกอบ <CacheResource> ในสภาพแวดล้อมที่คุณต้องการติดตั้งใช้งานพร็อกซี API แล้ว

ดูข้อมูลเกี่ยวกับวิธีสร้างแคชได้ที่การสร้างและแก้ไขแคชสภาพแวดล้อม

CacheNotFound

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน UI ของ Edge หรือ Edge Management API จะส่งผลให้เกิดข้อความแสดงข้อผิดพลาดเช่นนี้ และระบบจะทำเครื่องหมายสถานะการติดตั้งใช้งานพร็อกซี API ว่าติดตั้งใช้งานบางส่วน

Error: Cache : cache_resource, not found in organization : organization__environment.

ตัวอย่างข้อความแสดงข้อผิดพลาด

Error Cache : configCache, not found in organization : kkalckstein-eval__test

สาเหตุ

ข้อผิดพลาดนี้จะเกิดขึ้นหากไม่ได้สร้างแคชที่เฉพาะเจาะจงซึ่งระบุไว้ในข้อความแสดงข้อผิดพลาดในคอมโพเนนต์ Message Processor ที่เฉพาะเจาะจง

ความละเอียด

หากคุณเป็นผู้ใช้ Private Cloud โปรดทำตามวิธีการด้านล่าง

1. แสดงรายการการติดตั้งใช้งานพร็อกซี API และระบุ Message Processor ที่มีข้อผิดพลาด steps.cache.CacheNotFound

   curl -u $USERID:$USERPASSWORD http://:8080/v1/organizations//environments//apis//revisions//deployments

   ตัวอย่างเอาต์พุต

   {
     "aPIProxy" : "TestCache",
     "environment" : [ {
       "configuration" : {
         "basePath" : "/",
         "configVersion" : "SHA-512:45d3f39783414d3859bf2dec4135d8f5f9960ee6b2d361db2799c82693a8e3f8b95dbbb37c547eb3c0a3819d8ca51727f390502bcaefdf1f113263521a9023b6",
         "steps" : [ ]
       },
       "name" : "prod",
       "server" : [ {
         "pod" : {
           "name" : "pod1",
           "region" : "us-central1"
         },
         "status" : "deployed",
         "type" : [ "message-processor" ],
         "uUID" : "f2e5e34a-5630-43a9-8fef-48a5b9da76d1"
       }, {
         "pod" : {
           "name" : "pod1",
           "region" : "us-central1"
         },
         "status" : "deployed",
         "type" : [ "message-processor" ],
         "uUID" : "879a6538-a5e0-4503-b142-9cb2b4e0623d"
       }, {
       "error" : "Cache : configCache, not found in organization : kkalckstein-eval__test",
       "errorCode" : "steps.cache.CacheNotFound",
       "status" : "error",
       "type" : [ "message-processor" ],
        "uUID" : "a8f9ce0b-c32d-48a9-b26c-9c75d8bf467d"
   },
   ...
       "state" : "deployed"
     } ],
     "name" : "2",
     "organization" : "kkalckstein-eval"
     ...
   

2. จด UUID ของ Message Processor ที่คุณพบข้อผิดพลาด steps.cache.CacheNotFound ระบุชื่อโฮสต์/ที่อยู่ IP ของ Message Processor ที่เชื่อมโยงกับ UUID

3. เข้าสู่ระบบ Message Processor ที่เฉพาะเจาะจง แล้วรีสตาร์ทโดยใช้คำสั่งต่อไปนี้

   apigee-service edge-message-processor restart

หากคุณเป็นผู้ใช้ Public Cloud หรือหากยังพบปัญหาใน Private Cloud โปรดติดต่อทีมสนับสนุนของ Apigee เพื่อขอความช่วยเหลือ