1. 程式人生 > >分散式日誌框架之ExceptionLess【二】:自行搭建幫助文件【翻譯】

分散式日誌框架之ExceptionLess【二】:自行搭建幫助文件【翻譯】

原文地址:https://github.com/exceptionless/Exceptionless/wiki/Self-Hosting

ExceptionLess自行託管環境搭建

一、測試環境


 如果你想在本地測試ExceptionLess,請遵循本節如下步驟。但是,請注意!以下事項僅用於測試環境,而不是用於生產環境。

1、基本配置

1).Net 4.6.1

2)Java JDK 1.8+

3)作業系統是Windows環境時,需要配置JAVA_HOME環境變數,參考資料 

4)IIS Express 8+

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)配置系統,然後傳送錯誤到站點;

  現在,你可以建立一個本地帳戶、所屬組織和專案,並向其傳送錯誤資訊了。