分散式日誌框架之ExceptionLess【二】:自行搭建幫助文件【翻譯】
原文地址:https://github.com/exceptionless/Exceptionless/wiki/Self-Hosting
ExceptionLess自行託管環境搭建
一、測試環境
如果你想在本地測試ExceptionLess,請遵循本節如下步驟。但是,請注意!以下事項僅用於測試環境,而不是用於生產環境。
1、基本配置
3)作業系統是Windows環境時,需要配置JAVA_HOME環境變數,參考資料
5)PowerShell 3+ 版本建議在3.0及以上
6)通過管理員身份開啟命令提示符,確保PowerShell執行Set-ExecutionPolicy Unrestricted
2、搭建說明
執行以下步驟:
1)確保滿足以上所有要求;
2)將最新ExceptionLess釋出壓縮包下載到本機;
3)解壓縮檔案;
4)解壓完後,執行當前目錄下的Start.bat檔案,然後會自動下載ElasticSearch、Kibana資源。下載完畢後,會自動啟動ElasticSearch、IIS Express以及預設瀏覽器登入到ExceptionLess系統登入頁面;
執行完後,現在可以建立一個本地帳戶、所屬組織和專案。然後建立專案,模擬傳送錯誤資訊給它,以便進行本地測試。
二、產品環境
在生產環境中,請遵循以下步驟配置ExceptionLess。
1、基本配置
強烈建議在Linux上執行ElasticSearch,至少配置三個節點,其中兩個點是主節點。因為Linux版本比Windows版本的效能要好。
1).NET 4.7
2)IIS 7.5+
3)ElasticSearch 5.6,ExceptionLess的GitHub站點也有相應的安裝說明
2、搭建說明
1)確保滿足以上所有要求;
2)將最新ExceptionLess釋出壓縮包下載到本機;
3)解壓縮檔案;
4)在相當的目錄中,如果日誌子目錄不存在,則建立日誌子目錄。確保App_Data和Logs目錄是IIS使用者可寫的。可右鍵->屬性->“安全”頁籤->編輯->選擇IIS_IUSRS,然後選擇“全部控制”複選框;
5)安裝ElasticSearch,ExceptionLess的GitHub站點也有相應的安裝說明;
6)設定IIS,啟用ASP>NET 4.6和靜態內容特性,建立一個新的站點指向wwwroot資料夾,該資料夾可以在解壓縮的目錄中找到;
7)更新Web.Config檔案:
a)ElasticSearchConnectionString應該指向ElasticSearch伺服器;
b)將<appSettings>節點新增到Web.Config配置檔案中,它控制每個索引應該使用多少分片和副本。對於單個節點設定,這些值應該分別設定為1和0.對於推薦的ElasticSearch叢集(3個節點,2個master),建議值為3和1;
<add key="ElasticSearchNumberOfShards" value="..." />
<add key="ElasticSearchNumberOfReplicas" value="..." />
c)BaseURL應該設定為網站的外部Url,若沒有采用下面可選部分的CleanUrls內容,請確保將hashbang(/#!)新增到BaseURL;
d)如果安裝了SSL證書(推薦),EnableSSL應該設定為true。如果你的域沒有自簽名證書,可以在IIS管理器中建立自簽名證書,方法是選擇當前伺服器,然後在右側雙擊伺服器證書,然後單擊出現在右側空格上的“建立自簽名證書”;
e)如果想傳送不受限制的電子郵件,應該將WebsiteMode設定為Production;
f)配置你想配置的其他屬性(如:郵件設定),出現在Settings.cs中的任何屬性均可以在這裡配置;
8)更新App.config.*.js檔案:
a)BaseURL應該設定為網站的外部Url,此值不應該附加hashbang(/#!),即使它是在伺服器配置中附加的;
b)USE_SSL應該與app.config中的EnableSSL設定相同的值;
c)注意:如果在ExceptionLess載入頁面後更改配置檔案,則需要進行重新載入;
9)配置系統,然後傳送錯誤到站點;
現在,你可以建立一個本地帳戶、所屬組織和專案,並向其傳送錯誤資訊了。