CloudWatch 解決方案：Amazon EC2 上的 Tomcat 工作負載

此解決方案可協助您透過 CloudWatch 代理程式，為在 EC2 執行個體上執行的 Tomcat 伺服器設定開箱即用的指標收集功能。除此之外，還可協助您設定預先設定的 CloudWatch 儀表板。如需所有 CloudWatch 可觀測性解決方案的一般資訊，請參閱CloudWatch 可觀測性解決方案。

要求

此解決方案適用於下列情況：

優勢

此解決方案提供 Tomcat 伺服器監控功能，針對下列使用案例提供寶貴洞察：

以下是此解決方案的主要優勢：

下圖是此解決方案之儀表板的範例。

成本

此解決方案會在您的帳戶中建立並使用資源。您需要支付標準用量的費用，包括下列項目：

如需 CloudWatch 定價的詳細資訊，請參閱 Amazon CloudWatch 定價。

定價計算器可協助您估算使用此解決方案的每月大致費用。

此解決方案的 CloudWatch 代理程式組態

CloudWatch 代理程式是在您的伺服器和容器化環境中持續自主執行的軟體。它從您的基礎結構和應用程式收集指標、日誌和追蹤，並將其傳送到 CloudWatch 和 X-Ray。

如需 CloudWatch 代理程式的詳細資訊，請參閱使用 CloudWatch 代理程式收集指標、日誌和追蹤。

此解決方案中的代理程式組態會收集 Tomcat、JVM 和 EC2 的基礎指標。CloudWatch 代理程式可以設定為，收集的 JVM 指標數多於儀表板預設顯示的指標數。如需您可以收集之所有 Tomcat 指標的清單，請參閱收集 Tomcat 指標。如需您可以收集之所有 JVM 指標的清單，請參閱收集 JVM 指標。如需 Amazon EC2 指標的清單，請參閱由 CloudWatch 代理程式在 Linux 和 macOS 執行個體上收集的指標。

公開 Tomcat 伺服器的 JMX 連接埠

CloudWatch 代理程式依賴 JMX 收集與 Tomcat 伺服器和 JVM 程序相關的指標。為此，您必須透過伺服器公開 JMX 連接埠。若要啟用 JMX 連接埠進行監控和管理，需要為 Tomcat 伺服器設定系統屬性。可以使用環境變數 CATALINA_OPTS 為 Tomcat 設定必要的系統屬性。檢視 Tomcat 伺服器的啟動指令碼和設定檔，以確定設定環境變數的最佳位置。請務必指定未使用的連接埠號碼。變更後，您將需要重新啟動伺服器。

export CATALINA_OPTS="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=<<port-number>> -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false"

此範例設定的是未經驗證的 JMX。如果依據安全政策/規定，您必須透過密碼身分驗證機或 SSL 啟用 JMX 以進行遠端存取，請參閱 JMX 文件來設定所需的屬性。

若要驗證 JMX 連接埠，請執行 ps aux | grep jmxremote.port。結果應顯示 JMX 連接埠已在 JVM 程序上設定。

Tomcat 解決方案的代理程式組態

代理程式收集的指標在代理程式組態中定義。解決方案提供代理程式組態，以收集適用於解決方案儀表板的建議指標與適當維度。

部署解決方案的步驟稍後會在部署解決方案的代理程式中說明。以下資訊旨在協助您了解如何為您的環境自訂代理程式組態。

您必須為環境自訂下列代理程式組態的部分項目：

例如，如果您有兩個 Tomcat 應用程式在同個 AWS 帳戶中執行，一個用於 order-system 應用程式，另一個用於 billing-system 應用程式，則應該在每個執行個體的代理程式組態中相應地設定 AppName 和 ProcessGroupName 維度。

當您遵循這些準則時，解決方案會依 AppName 和 ProcessGroupName 維度自動將指標分組。儀表板將包含下拉式清單選項，供您選取並檢視特定 Tomcat 應用程式的指標，讓您能分別監控個別應用程式的效能。

Tomcat 主機的代理程式組態

請在部署 Tomcat 應用程式的 EC2 執行個體上，使用下列 CloudWatch 代理程式組態。組態將儲存為 SSM 參數儲存區中的參數，如稍後的步驟 2：將建議的 CloudWatch 代理程式設定檔儲存在 Systems Manager 參數儲存區中中所述。

將 AppName 替換為有意義的名稱，代表執行個體所屬的 Tomcat 應用程式。將 port-number 替換為您 Tomcat 伺服器的 JMX 連接埠。如果是透過密碼身分驗證或 SSL 啟用 JMX 以進行遠端存取，請參閱收集 Java Management Extensions (JMX) 指標以取得有關視需要在代理程式組態中設定 TLS 或授權的資訊。

此組態中顯示的 EC2 指標 (在 JMX 區塊外部顯示的組態) 僅適用於 Linux 和 macOS 執行個體。如果您使用的是 Windows 執行個體，可以選擇在組態中省略這些指標。如需在 Windows 執行個體上收集之指標的資訊，請參閱由 CloudWatch 代理程式在 Windows Server 執行個體上收集的指標。

{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "tomcat": {
            "measurement": [
              "tomcat.sessions",
              "tomcat.errors",
              "tomcat.processing_time",
              "tomcat.traffic",
              "tomcat.max_time",
              "tomcat.request_count",
              "tomcat.threads"
            ]
          },
          "append_dimensions": {
            "AppName": "AppName"
          }
        },
        {
          "endpoint": "localhost:port-number",
          "jvm": {
            "measurement": [
              "jvm.classes.loaded",
              "jvm.gc.collections.count",
              "jvm.gc.collections.elapsed",
              "jvm.memory.heap.committed",
              "jvm.memory.heap.max",
              "jvm.memory.heap.used",
              "jvm.memory.nonheap.committed",
              "jvm.memory.nonheap.max",
              "jvm.memory.nonheap.used",
              "jvm.threads.count"
            ]
          },
          "append_dimensions": {
            "ProcessGroupName": "AppName"
          }
        }
      ],
      "disk": {
        "measurement": [
          "used_percent"
        ]
      },
      "mem": {
        "measurement": [
          "used_percent"
        ]
      },
      "swap": {
        "measurement": [
          "used_percent"
        ]
      },
      "netstat": {
        "measurement": [
          "tcp_established",
          "tcp_time_wait"
        ]
      }
    }
  }
}

部署解決方案的代理程式

安裝 CloudWatch 代理程式的方法有很多種，具體取決於使用案例。建議您使用 Systems Manager 安裝此解決方案。它提供主控台般的體驗，並簡化了在單一 AWS 帳戶內管理受管伺服器機群的流程。本節說明採用 Systems Manager，適用於您沒有以現有組態執行 CloudWatch 代理程式的情況。您可以依循確認 CloudWatch 代理程式正在執行中中的步驟，檢查 CloudWatch 代理程式是否正在執行。

如果您已在部署 JVM 應用程式和管理代理程式組態的 EC2 主機上執行 CloudWatch 代理程式，可以略過本節中的說明，並依循現有部署機制來更新組態。請務必將 JVM 的代理程式組態與您現有的代理程式組態合併，然後部署合併的組態。如果您使用 Systems Manager 來儲存和管理 CloudWatch 代理程式的組態，可以將組態合併到現有的參數值。如需詳細資訊，請參閱管理 CloudWatch 代理程式設定檔。

部署程序包含以下步驟：

步驟 1：確定目標 EC2 執行個體具有所需的 IAM 許可

您必須授與 Systems Manager 安裝和設定 CloudWatch 代理程式的許可。還必須授與 CloudWatch 代理程式從 EC2 執行個體發佈遙測到 CloudWatch 的許可。確定連結至執行個體的 IAM 角色已連結 CloudWatchAgentServerPolicy 和 AmazonSSMManagedInstanceCore IAM 政策。

步驟 2：將建議的 CloudWatch 代理程式設定檔儲存在 Systems Manager 參數儲存區中

參數儲存區透過安全地儲存和管理組態參數，簡化在 EC2 執行個體上安裝 CloudWatch 代理程式的流程，無需使用硬式編碼值。這可確保部署程序更安全、更靈活，實現集中式管理，並能更輕鬆地更新多個執行個體的組態。

依循下列步驟，將建議的 CloudWatch 代理程式設定檔儲存為參數儲存區中的參數。

步驟 3：安裝 CloudWatch 代理程式並藉助 CloudFormation 範本套用組態

可以使用 AWS CloudFormation 安裝代理程式，並將其設定為使用您在先前步驟中建立的 CloudWatch 代理程式組態。

如果想要先編輯範本檔案以進行自訂，請選擇建立堆疊精靈下的上傳範本檔案選項，以上傳經編輯的範本。如需詳細資訊，請參閱在 CloudFormation 主控台上建立堆疊。可以使用以下連結下載範本：https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json。

步驟 4：確認代理程式設定已正確設定

您可以依循確認 CloudWatch 代理程式正在執行中中的步驟，檢查 CloudWatch 代理程式是否已安裝。若 CloudWatch 代理程式未安裝且未執行，請確認您已正確完成所有設定。

若所有設定皆正確無誤，您應可看到 Tomcat 指標已發佈至 CloudWatch。可以檢查 CloudWatch 主控台，以確認系統是否正在發佈這些指標。

建立 Tomcat 解決方案儀表板

此儀表板顯示新發出的指標，涵蓋 Tomcat 應用程式伺服器及其底層 JVM。此儀表板提供主要貢獻因子視圖，顯示您的 Tomcat 工作負載的運作狀態。主要貢獻因子檢視會顯示每個指標小工具排名前 10 的因子。這可助您一目了然地識別極端值。儀表板還透過彙總和呈現所有執行個體的指標來提供叢集的概觀，並提供叢集整體運作狀態和操作狀態的高階摘要。

解決方案儀表板不會顯示 EC2 指標。若要檢視 EC2 指標，您需要使用 EC2 自動儀表板查看 EC2 代售指標，並使用 EC2 主控台儀表板查看 CloudWatch 代理程式收集的 EC2 指標。如需 AWS 服務 自動儀表板的詳細資訊，請參閱檢視單一 AWS 服務的 CloudWatch 儀表板。

若要建立儀表板，可以使用下列選項：

透過使用 CloudWatch 主控台建立儀表板，您可以在實際建立和收費之前預覽儀表板。

如果想要編輯範本檔案以針對任何用途自訂範本檔案，可以使用建立堆疊精靈下的上傳範本檔案選項來上傳經編輯的範本。如需詳細資訊，請參閱在 CloudFormation 主控台上建立堆疊。可以使用此連結下載範本：https://aws-observability-solutions-prod-us-east-1.s3.us-east-1.amazonaws.com/Tomcat_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json。

開始使用 Tomcat 監控儀表板

以下是您可以嘗試使用新 Tomcat 儀表板處理的一些任務。這些任務可讓您驗證儀表板是否運作正常，並提供實際操作經驗，協助您運用儀表板監控 Tomcat 應用程式。當您嘗試這些功能時，可逐漸熟悉儀表板的操作介面，並學會解讀視覺化的指標資料。

使用下拉式清單

儀表板頂端提供下拉式清單，您可以透過此選單篩選並選取要監控的特定 Tomcat 應用程式。若要顯示特定 Tomcat 應用程式的指標，請在 Tomcat 應用程式下拉式清單中選取該應用程式名稱。

驗證應用程式運作狀態

在應用程式概觀區段中，尋找請求、錯誤和錯誤率小工具。這些提供應用程式請求處理效能的高階摘要。尋找任何異常偏高的錯誤計數或錯誤率，這可能表示存在需要進一步調查的問題。

監控請求處理

在請求處理時間區段中，尋找時間上限和處理所有請求的總時間小工具。這些指標有助於您識別請求處理過程中的潛在效能瓶頸。尋找處理時間上限明顯高於其他伺服器的伺服器。

分析網路流量

在網路流量區段中，尋找已傳送流量和已接收流量小工具。這些指標會顯示應用程式透過網路傳送和接收的資料量。意外偏高的流量水準可能表示存在潛在問題，例如網路飽和度或資料傳輸效率低下。

調查執行緒用量

在工作階段和執行緒區段中，尋找忙碌的執行緒計數、執行緒計數和工作階段小工具。這些指標可助您深入了解應用程式的執行緒管理和作用中的使用者工作階段。尋找任何擁有異常多忙碌執行緒或工作階段的伺服器，這可能表示存在潛在的資源限制問題。