Performance Monitor 監控 EnyimMemcached 完整配置指南

前言

EnyimMemcached 是 .NET 常用的 Memcached 客戶端，內建效能計數器支援。但許多開發者發現：雖安裝計數器後在效能監視器列表中可見，「所選物件的執行個體」卻為空白，無法加入圖表。本文詳述完整配置流程，解決執行個體缺失問題。

步驟 1：安裝效能計數器至系統

1. 將 Enyim.Caching.dll 複製至任意資料夾（如 D:\lib\）。
2. 以管理員身分開啟「Visual Studio 開發人員命令提示字元」（或直接進入 .NET Framework 目錄：C:\Windows\Microsoft.NET\Framework64\v4.0.30319）。
3. 執行安裝指令：
   installutil D:\lib\Enyim.Caching.dll

成功後，效能監視器 (perfmon) 的計數器清單中會出現 Enyim.Caching 類別。

步驟 2：關鍵配置 — 啟用應用程式層級效能監控

僅安裝系統計數器不足夠，必須在應用程式設定檔中啟用 <performanceMonitor/> 區段，Enyim 才會在執行時建立執行個體。

web.config / app.config 範例

<configuration>
  <configSections>
    <sectionGroup name="enyim.com">
      <section name="memcached" type="Enyim.Caching.Configuration.MemcachedClientSection, Enyim.Caching" />
    </sectionGroup>
  </configSections>

  <enyim.com>
    <memcached protocol="Binary">
      <servers>
        <add address="memcached" port="11211" />
      </servers>
      <socketPool minPoolSize="50" maxPoolSize="3000" 
                  connectionTimeout="00:00:01" deadTimeout="00:00:01" />
      <!-- 關鍵：啟用效能監控，name 為執行個體名稱 -->
      <performanceMonitor 
          factory="Enyim.Caching.Memcached.DefaultPerformanceMonitorFactory, Enyim.Caching" 
          name="www.cnblogs.com" />
    </memcached>
    <log factory="Enyim.Caching.Log4NetFactory, Enyim.Caching.Log4NetAdapter" />
  </enyim.com>
</configuration>

步驟 3：驗證執行個體出現

1. 啟動網站/應用程式，觸發 Memcached 操作（如讀寫快取），使 EnyimClient 初始化。
2. 開啟效能監視器，重新整理計數器清單，展開 Enyim.Caching，此時 「所選物件的執行個體」應列出配置的 name（如 www.cnblogs.com）。

步驟 4：加入監控圖表體驗指標

選擇該執行個體，勾選所需計數器（如 Gets/sec、Sets/sec、Cache Hits/sec、Avg Get Time 等），加入即可即時監控。

常見問題排查

總結

核心在於 系統層安裝計數器 + 應用層配置 performanceMonitor 兩步缺一不可。配置完成後，即可透過 Windows 內建效能監視器即時觀測 EnyimMemcached 的吞吐、命中率、延遲等關鍵指標，為效能調優提供數據支撐。