使用外掛程式

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

Edge Microgateway 3.0.x 版

目標對象

本主題適用於希望使用現有外掛程式的 Edge Microgateway 運算子 會透過微門安裝。也會探討 Google Cloud 中 詳細資料 (安裝包含兩者)。如果您是想要開發新的 外掛程式，請參閱開發 自訂外掛程式。

什麼是 Edge Microgateway 外掛程式？

外掛程式是一種 Node.js 模組，可為 Edge Microgateway 新增功能。外掛程式模組 遵循一致模式，且儲存在 Edge Microgateway 上的已知位置，使 即可自動探索並載入微型閘道。Edge Microgateway 包含 外掛程式，您也可以建立自訂外掛程式，如「開發自訂外掛程式」所述。

隨附於 Edge 的現有外掛程式 微型閘道

安裝時會提供數種現有的 Edge Microgateway 外掛程式。這些 包括：

如何找出現有外掛程式

隨附於 Edge Microgateway 的現有外掛程式，其中 [prefix] 是 npm 前置字串目錄詳情請參閱 如果找不到這個目錄，請安裝 Edge Microgateway 在哪裡。

[prefix]/lib/node_modules/edgemicro/node_modules/microgateway-plugins

新增及設定外掛程式

請按照以下模式新增及設定外掛程式：

1. 停止 Edge Microgateway。
2. 開啟 Edge Microgateway 設定檔。如需詳細資訊，請參閱 變更設定選項。
3. 將外掛程式新增至設定檔的 plugins:sequence 元素，如下所示。 外掛程式會按照這份清單中的顯示順序執行。

edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
     level: info
     dir: /var/tmp
     stats_log_interval: 60
  plugins:
     dir: ../plugins
     sequence:   
     - oauth
     - plugin-name

4. 設定外掛程式。部分外掛程式具有選用參數，您可以在 設定檔。舉例來說，您可以新增下列節拍，設定流量高峰 外掛程式。請參閱「使用尖峰流量防範外掛程式」一節。 瞭解詳情

   edgemicro:
     home: ../gateway
     port: 8000
     max_connections: -1
     max_connections_hard: -1
     logging:
       level: info
       dir: /var/tmp
       stats_log_interval: 60
     plugins:
       dir: ../plugins
       sequence:
         - oauth
         - spikearrest
   spikearrest:
      timeUnit: minute
      allow: 10
   

   敬上

5. 儲存檔案。
6. 視您編輯的設定檔而定，重新啟動或重新載入 Edge Microgateway。

外掛程式專屬設定

如要覆寫設定檔中指定的外掛程式參數，請建立 特定外掛程式的設定：

[prefix]/lib/node_modules/edgemicro/node_modules/microgateway-plugins/config

其中 [prefix] 是 npm 前置字串目錄。詳情請參閱 如果找不到這個目錄，請安裝 Edge Microgateway 在哪裡。

plugins/<plugin_name>/config/default.yaml。舉例來說，您可以將 在 plugins/spikearrest/config/default.yaml 中封鎖，而且會覆寫其他 配置設定。

spikearrest:
   timeUnit: hour   
   allow: 10000   
   buffersize: 0

使用尖峰流量的外掛程式

峰值逮捕外掛程式可防範流量暴增。可針對 由 Edge Microgateway 執行個體處理

新增尖峰式逮捕外掛程式

請參閱新增並設定外掛程式。

以下項目的設定範例： 尖頂逮捕

edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
  plugins:
    dir: ../plugins
    sequence:
      - oauth
      - spikearrest
spikearrest:
   timeUnit: minute
   allow: 10
   bufferSize: 5

的設定選項 尖頂逮捕

• timeUnit：高峰逮捕執行期間重設的頻率。有效值 分別為第二或分鐘。
• allow：在 timeUnit 中允許的要求數量上限。詳情請見 在同一處同時執行多個 Edge Micro 程序。
• bufferSize：(非必要，預設值 = 0) if bufferSize >0，驟增率 會將這個數量的要求儲存在緩衝區中。下一個執行「視窗」後立即執行發生時 系統會先處理緩衝要求另請參閱新增 緩衝區。

激增的逮捕方式是什麼？

您可以視為應對高峰期的一種方法，一般都能防範流量高峰，而非 將流量限制於特定數量要求您的 API 和後端可處理 此外，流量暴增政策也有助於確保流量順利推進一般流量 您期望的行為

執行階段尖峰防範行為與預期值不符 每分鐘或每秒輸入的值

舉例來說，假設您指定每分鐘 30 次要求的速率，如下所示：

spikearrest:
   timeUnit: minute
   allow: 30

在測試過程中，假設你可在 1 秒內傳送 30 個要求 大約需要 1 分鐘不過，這並非這項政策強制執行設定的方式。不妨考慮 30 在某些環境中，1 秒內發生的要求數量可能被視為一小高峰。

然後呢？為預防類似突然激增的行為，流量高峰能夠順暢運作 將設定分成較短的時間間隔，如下所示：

每分鐘費率

每分鐘費率會順暢化為允許的間隔秒數的要求。例如：30 每分鐘的要求數會經過簡化，如下所示：

60 秒 (1 分鐘) / 30 = 2 秒間隔，或大約每 2 秒允許 1 個要求。A 罩杯 因此 2 秒內第二次的請求將會失敗。此外，一分鐘內的第 31 項要求也會失敗。

每秒費率

每秒費率可針對允許的要求順暢執行 (以毫秒為單位)。例如： 每秒 10 個要求將順暢處理，如下所示：

1000 毫秒 (1 秒) / 10 = 100 毫秒的間隔，或大約允許 1 個要求 每 100 毫秒 更新一次如果 100 毫秒內，第二次要求將會失敗。此外，第 11 項要求 因此無法完成後續處理

超過上限時

如果要求數量超過指定時間間隔內的限制，則尖峰流量遭到鎖定 會傳回 HTTP 503 狀態的錯誤訊息：

{"error": "spike arrest policy violated"}

新增緩衝區

您可以選擇在政策中新增緩衝區。假設您將緩衝區設為 10， 您會發現在超過遽增的部分時，API 未立即傳回錯誤 我們會自動向帳單帳戶扣款 並每月或在您達到用量上限時發送帳單而是會緩衝處理要求 (最多可達指定數字)，而緩衝要求則會 就會盡快處理。預設 bufferSize 為 0。

在執行多個 Edge Micro 時 程序

允許的要求數取決於 備用資源尖峰流量會計算每個工作站程序允許的要求數量。根據預設 Edge Micro 程序數量等於 Edge Micro 機器的 CPU 數量 已安裝。不過，您可以在啟動 Edge Micro 時設定工作站處理程序的數量 請在 start 指令上使用 --processes 選項。舉例來說，如果您在 您希望在特定時間範圍內在 100 個要求內觸發尖峰流量，而且在啟動 Edge 時 設有 --processes 4 選項的微閘道，請將 allow: 25 包括流量高峰總結來說，經驗法則是設定 allow 設定 參數的值為「desired 峰 rerestCount / 程序數」。

使用配額外掛程式

配額可指定應用程式可提交要求至 API 的要求訊息數量 每小時、每天、每週或每月。應用程式達到配額限制時 已拒絕 API 呼叫。另請參閱 用量高峰和配額？

新增配額外掛程式

請參閱新增並設定外掛程式。

Apigee 中的產品設定 邊緣

您可以在設定 API 產品的 Apigee Edge UI 中設定配額。您需要知道 包含要設定配額限制的微閘道感知 Proxy。這個 產品必須新增至開發人員應用程式。當您使用 金鑰，這項配額將適用於這些 API 呼叫。

1. 登入您的 Apigee Edge 機構帳戶。
2. 在 Edge UI 中，開啟與微閘道感知 Proxy 相關聯的產品，以便執行以下動作： 以便套用配額
   1. 在使用者介面中，從「發布」選單中選取「產品」。
   2. 開啟要套用配額的 API 所屬的產品。
   3. 按一下 [編輯]。
   4. 在「配額」欄位中指定配額間隔。例如每段一次 一分鐘。或每 2 小時 50,000 個要求。
      
      

3. 按一下 [儲存]。
4. 請確認產品已新增至開發人員應用程式。您需要這個應用程式的金鑰 經過驗證的 API 呼叫

配額設定範例

edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
  plugins:
    dir: ../plugins
    sequence:
      - oauth
      - quota

配額設定選項

如要設定配額外掛程式，請將 quotas 元素新增至設定檔。 如以下範例所示：

edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
  plugins:
    dir: ../plugins
    sequence:
      - oauth
      - quota
quotas:
  bufferSize:
    hour: 20000
    minute: 500
    month: 1
    default: 10000
  useDebugMpId: true
  failOpen: true
  useRedis: true
  redisHost: localhost
  redisPort: 6379
  redisDb: 1
...

edgemicro:
...
quotas:
  failOpen: true

edgemicro:
...
quotas:
  useDebugMpId: true
...

{
    "allowed": 20,
    "used": 3,
    "exceeded": 0,
    "available": 17,
    "expiryTime": 1570748640000,
    "timestamp": 1570748580323,
    "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
}

瞭解配額範圍

配額數量僅限於特定 API 產品。如果開發人員應用程式提供多種產品 配額的範圍會限於個別用量為了達到這個範圍 Edge Microgateway 建立的配額 ID 是 「appName + productName」。

測試配額外掛程式

超過配額時，系統會將 HTTP 403 狀態及 的訊息：

{"error": "exceeded quota"}

系列產品差異 如何應對突然暴增和配額？

請務必為目前工作選擇合適的工具。配額政策設定 在本課程中，用戶端應用程式可提交要求訊息至 API 的要求訊息數量 一小時、一天、一週或一個月。配額政策會針對用戶端應用程式強制執行用量限制，方法為 維護可計算傳入要求的分散式計數器。

使用配額政策，強制與開發人員和合作夥伴簽署業務合約或服務水準協議，而非 而不是營運流量管理舉例來說，您可以使用配額限制 但付費客戶則可以使用完整服務。

使用尖峰流量防範機制，防範 API 流量突然激增。流量高峰期通常為 來阻止潛在的 DDoS 或其他惡意攻擊