nginx module sysguard下載 - nginx module sysguard原始碼下載

nginx module sysguard

C#源碼

1.0.0

下載

Nginx 系統保護模組

版本

本文檔描述了 2017 年 2 月 23 日發布的 nginx-module-sysguard v0.1.0 。

依賴關係

nginx
系統資訊(2) |取得平均負載(3)
/proc/記憶體信息

相容性

1.11.x（上次測試：10.11）

早期版本未經測試。

安裝

克隆 git 儲存庫。

 shell> git clone git://github.com/vozlt/nginx-module-sysguard.git

透過新增將模組新增到建置配置中

 --add-module=/path/to/nginx-module-sysguard

建置 nginx 二進位。
安裝 nginx 二進位。

概要

 http {

    ...

    server {

        ...

        sysguard on;
        sysguard_mode or;

        sysguard_load load=10.5 action=/loadlimit;
        sysguard_mem swapratio=20% action=/swaplimit;
        sysguard_mem free=100M action=/freelimit;
        sysguard_rt rt=0.01 period=5s method=AMM:10 action=/rtlimit;

        location /loadlimit {
            return 503 ;
        }

        location /swaplimit {
            return 503 ;
        }

        location /freelimit {
            return 503 ;
        }

        location /rtlimit {
            return 503 ;
        }
    }

    ...

    server {

        ...

        location /api {
            sysguard on;
            sysguard_mode or;
            sysguard_load load=20 action=/limit;
            sysguard_mem swapratio=10% action=/limit;
            sysguard_rt rt=2.01 period=5s method=WMA:10 action=/limit;

            ... 

        }

        location /images {
            sysguard on;
            sysguard_mode and;
            sysguard_load load=20 action=/limit;
            sysguard_mem swapratio=10% action=/limit;
            sysguard_rt rt=2.01 period=5s method=WMA:10 action=/limit;

            ...

        }

        location /limit {
            return 503 ;
        }
    }

}

描述

此模組可用於保護您的伺服器，以防系統負載、記憶體使用過高或請求回應過慢。這是 tengine 中 sysguard 到純 NGINX 的移植版本，以支援相同的功能。

Caveats:請注意，此模組需要 sysinfo(2) 系統調用，或 glibc 中的 getloadavg(3) 函數。它還需要 /proc 檔案系統來獲取記憶體資訊。

嵌入變數

提供了以下嵌入變數：

$sysguard_load
- 系統的負載。如果$sysguard_load的值為 100，則負載為 0.1(100/1000)。（/毫秒）
$sysguard_swapstat
- 使用swap的比例。（/每）
$sysguard_free
- 記憶體的真實可用空間。 (/位元組)
$sysguard_rt
- 請求處理時間的平均值。如果$sysguard_rt的值為 100，則回應時間為 0.1 秒(100/1000)。（/毫秒）
$sysguard_meminfo_totalram
- meminfo 的總記憶體。 (/位元組)
$sysguard_meminfo_freeram
- meminfo 的空閒記憶體。 (/位元組)
$sysguard_meminfo_bufferram
- meminfo的緩衝記憶體。 (/位元組)
$sysguard_meminfo_cachedram
- meminfo 的快取記憶體。 (/位元組)
$sysguard_meminfo_totalswap
- meminfo 的總交換量。 (/位元組)
$sysguard_meminfo_freeswap
- meminfo 的免費交換。 (/位元組)

指令

系統衛士

-	-
句法	系統保護<開\|關>
預設	離開
情境	http、伺服器、位置

Description:啟用或停用模組工作。

系統保護負載

-	-
句法	sysguard_load負載 =數字[操作 = /url ]
預設	-
情境	http、伺服器、位置

Description:指定負載閾值。當系統負載超過此閾值時，所有後續請求將被重新導向至「action」參數指定的 URL。如果沒有定義「action」URL，它將傳回 503。該指令還支援使用 ncpuratio 來代替固定閾值，'ncpu' 表示 cpu 核心數，您可以像這樣使用該指令：load=ncpu1.5

系統保護記憶體

-	-
句法	sysguard_mem swapratio=比率% 空閒=大小[action= /url ]
預設	-
情境	http、伺服器、位置

Description:指定已用交換記憶體或可用記憶體閾值。當交換記憶體使用率超過此閾值或可用記憶體小於該大小時，所有後續請求將被重定向到「action」參數指定的 URL。如果沒有「action」URL，它將傳回 503。 Sysguard 使用此策略來計算可用記憶體：“memfree = free + buffered + cached”

系統衛士_rt

-	-
句法	sysguard_rt rt=第二個週期=時間[方法=:數字] [操作= /url ]
預設	-
情境	http、伺服器、位置

Description:指定響應時間閾值。參數rt用於設定平均反應時間的閾值，單位為秒。參數period用於指定統計週期的周期。如果系統的平均回應時間超過使用者指定的閾值，傳入的請求將被重定向到參數「action」定義的指定url。如果沒有提供“action”，則請求將直接回應 503 錯誤。此method是計算響應處理時間平均值的公式。 method中的number是計算平均值的樣本數。預設方法設定為method=AMM:period 。